ncread

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

Описание

пример

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

пример

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

пример

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

Примеры

свернуть все

Считайте и постройте переменную под названием 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 object. The axes object with title Peaks Data contains an object of type surface.

Считайте и постройте только подмножество переменных данных, начинающих с местоположения [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 object. The axes object with title Peaks Data Starting at [25 17] contains an object of type surface.

Считайте и отобразите данные на графике, где данные производятся при заданном интервале между переменными индексами по каждому измерению. Начните читать из местоположения в 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 object. The axes object with title Peaks Data Subsampled by [2 3] contains an object of type surface.

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

свернуть все

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

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

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

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

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

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

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

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

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

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

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

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

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

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

свернуть все

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

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

Для типов числовых данных, когда по крайней мере одна из переменной приписывает _FillValueScaleFactor , или add_offset присутствует, затем ncread возвращает vardata из типа double. Кроме того, ncread применяет эти соглашения:

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

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

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

Примечание

Для переменных данных, содержащих текст, ncread функционируйте поддержки, читая только vardata это содержит только закодированные ASCII символы. NETCDF 4 поддержки файлов, пишущий UTF-8 - закодированные символы в переменных типа NC_STRING.

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

Введенный в R2011a