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. Аргумент 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');

Считайте и постройте только подмножество переменных данных, начинающих с местоположения [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]');

Считайте и отобразите данные на графике, где данные выбираются при заданном интервале между переменными индексами по каждому измерению. Начните читать из местоположения в 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]');

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

свернуть все

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

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

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

Типы данных: 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 с NaN s. Если атрибут the_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