exponenta event banner

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. The axes 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. The axes 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. The axes 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 является 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