ncread

Считайте данные из переменной в источнике данных NetCDF

Свернуть все на странице

Синтаксис

vardata = ncread(source,varname)
vardata = ncread(source,varname,start,count)
vardata = ncread(source,varname,start,count,stride)

Описание

пример

vardata = ncread(source,varname) считывает все данные из переменной varname содержится в файле NetCDF или в источнике данных OPeNDAP NetCDF, заданном source.

пример

vardata = ncread(source,varname,start,count) считывает данные, начиная с местоположения, указанного в start. The count аргумент задает количество элементов для чтения по каждой размерности.

пример

vardata = ncread(source,varname,start,count,stride) возвращает данные с интервалом между индексами каждой размерности переменной, заданным как stride.

Примеры

свернуть все

Открыть Live Script

Чтение и построение переменной с именем peaks из файла example.nc. 

peaksData  = ncread('example.nc','peaks');
whos peaksData
  Name            Size            Bytes  Class    Attributes

  peaksData      50x50             5000  int16

График peaksData и добавить заголовок. 

surf(double(peaksData));
title('Peaks Data');

Figure contains an axes. The axes with title Peaks Data contains an object of type surface.

Открыть Live Script

Чтение и построение графика только подмножества переменных данных, начиная с местоположения [25 17] до конца каждой размерности. 

startLoc = [25 17]; % Start location along each coordinate
count  = [Inf Inf]; % Read until the end of each dimension
peaksData  = ncread('example.nc','peaks',startLoc,count);
whos peaksData
  Name            Size            Bytes  Class    Attributes

  peaksData      26x34             1768  int16

Постройте график данных.

surf(double(peaksData));
title('Peaks Data Starting at [25 17]');

Figure contains an axes. The axes with title Peaks Data Starting at [25 17] contains an object of type surface.

Открыть Live Script

Считайте и постройте график данных, где данные отбираются с заданным интервалом между переменными индексами по каждой размерности. Начните чтение из расположения в startLoc и считывайте переменные данные с интервалами, заданными в stride. Значение 1 в stride, обращается к смежным значениям в соответствующей размерности. В то время как, значение 2 обращается к любому другому значению соответствующей размерности и так далее.

startLoc = [1 1]; 
count  = [10 15]; 
stride = [2 3]; 
sampledPeaksData  = ncread('example.nc','peaks',startLoc,count,stride);
whos sampledPeaksData
  Name                   Size            Bytes  Class    Attributes

  sampledPeaksData      10x15              300  int16

Постройте график данных.

surf(double(sampledPeaksData));
title('Peaks Data Subsampled by [2 3]');

Figure contains an axes. The axes with title Peaks Data Subsampled by [2 3] contains an object of type surface.

Входные параметры

свернуть все

Имя источника, заданное как вектор символов или строковый скаляр, содержащий имя файла NetCDF или URL источника данных NetCDF OPeNDAP.

Типы данных: char | string

Имя переменной, заданное как вектор символов или строковый скаляр, содержащий имя переменной в файле NetCDF или источнике данных NetCDF OPeNDAP.

Типы данных: char | string

Начальное местоположение, заданное как числовой вектор положительных целых чисел. Для N-мерная переменная, start является вектором длины N содержащим 1-основанные индексы.

Если вы не задаете start, затем ncread функция начинает считывать переменную из первого индекса по каждой размерности.

Типы данных: double

Количество считываемых элементов, заданное как числовой вектор положительных целых чисел. Для N-мерная переменная, count является вектором длины N, задающее количество элементов для чтения по каждой размерности. Если какой-либо элемент count является Inf, затем ncread считывается до конца соответствующей размерности.

Если вы не задаете count, затем ncread функция считывает данные переменной до конца каждой размерности.

Типы данных: double

Пространство между индексами переменных по каждой размерности, заданное как числовой вектор целых чисел. Для N-мерная переменная, stride - вектор длины N. Элементы stride вектор соответствует, по порядку, размерностям переменной. Значение 1 обращается к смежным значениям переменной NetCDF в соответствующей размерности. В то время как, значение 2 обращается ко всем другим значениям переменной NetCDF в соответствующей размерности и так далее.

Если вы не задаете stride, затем ncread функция считывает данные с интервалом по умолчанию 1 вдоль каждой размерности.

Типы данных: double

Выходные аргументы

свернуть все

Переменные данные, возвращенные в виде текста или числовых массивов.

В большинстве случаев ncread функция использует MATLAB® тип данных, который является ближайшим типом к соответствующему типу данных NetCDF.

Когда по крайней мере один из атрибутов переменной _FillValue, scale_factor, или add_offset присутствует, тогда ncread возвращает vardata типа double. В сложение, ncread применяет следующие конвенции:

  • Если на _FillValue атрибут существует, затем ncread заменяет vardata значения, равные _FillValue значения с NaNs. Если _FillValue атрибут не существует, тогда ncread запрашивает в библиотеке NetCDF значение заливки переменной.

  • Если на scale_factor атрибут существует, затем ncread умножает данные переменных на значение scale_factor атрибут.

  • Если на add_offset атрибут существует, затем ncread добавляет значение add_offset атрибут к данным переменной.

Примечание

Для переменных данных, содержащих текст, ncread функция поддерживает только чтение vardata что кодируется ASCII.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char

См. также

| | |

Темы

Введенный в R2011a

Документация MATLAB

Поддержка

Для просмотра документации необходимо авторизоваться на сайте