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.

Типы данных: единственный | удваиваются | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | char

Введенный в R2011a

Была ли эта тема полезной?