Exponenta Banner

netcdf.open

Откройте источник данных NetCDF

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

Синтаксис

ncid = netcdf.open(source)
ncid = netcdf.open(source,mode)
[actualChunksize,ncid] = netcdf.open(source,mode,chunksize)

Описание

пример

ncid = netcdf.open(source) открывает source для доступа только для чтения и возвращает идентификатор NetCDF в ncid. Заданный Thesource может быть именем файла NetCDF или URL источника данных OPeNDAP NetCDF.

пример

ncid = netcdf.open(source,mode) открывает source с типом доступа, заданного mode. Значениями режима является 'WRITE', 'SHARE' или 'NOWRITE'.

[actualChunksize,ncid] = netcdf.open(source,mode,chunksize) открывает существующий источник данных NetCDF, с заданным chunksize. Параметр chunksize включает настройку производительности ввода-вывода.

Примеры

свернуть все

Скрипт Open Live Script

Откройте демонстрационный файл NetCDF, example.nc с доступом только для чтения, считайте переменную, и затем закройте файл. Функция netcdf.open возвращает идентификатор файла.

ncid = netcdf.open('example.nc')
ncid = 65536

Считайте данные, сопоставленные с переменной, avagadros_number, в файле в качестве примера, с помощью функции netcdf.getVar. Второй вход к netcdf.getVar является идентификатором переменной, который является основанным на нуле индексом, который идентифицирует переменную. Переменная avagadros_number имеет индексное значение 0.

A_number = netcdf.getVar(ncid,0)
A_number = 6.0221e+23

Закройте файл NetCDF.

netcdf.close(ncid)
Скрипт Open Live Script

Откройте NetCDF и присвойте значение переменной, и затем отобразите его.

Создайте Файл NetCDF myexample.nc, содержащий переменную pi.

nccreate('myexample.nc','pi')

Откройте файл для записи и запишите значению 3.1416 в переменную pi.

ncid = netcdf.open('myexample.nc','WRITE')
ncid = 65536

varInd = 0; % index of the first variable in the file
varValue = 3.1416 ; 
netcdf.putVar(ncid,varInd,varValue);

Считайте и отобразите значение переменной pi из файла. 

netcdf.getVar(ncid,varInd)
ans = 3.1416

Закройте файл.

netcdf.close(ncid);

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

свернуть все

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

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

Тип доступа, заданный как вектор символов или скаляр строки или числовое значение. Вход mode может одно из этих значений.

Значение Описание
'WRITE'Доступ для чтения-записи
'SHARE'Синхронные обновления файла
'NOWRITE'Доступ только для чтения (Значение по умолчанию)

Также можно задать mode с числовым значением. Получите численное значение для mode при помощи netcdf.getConstant. Например, netcdf.getConstant('WRITE') возвращает числовое значение для mode. Используйте эти числовые значения когда это необходимо, чтобы задать битовое "ИЛИ" нескольких режимов.

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

Разделите параметр размера на блоки для настройки производительности, заданной как целое число.

Параметр chunksize управляет компромиссом пробела-по-сравнению-с-разовым, память, которую функция netcdf.open выделяет в библиотеке NetCDF по сравнению с количеством системных вызовов. Из-за внутренних требований фактическое значение размера фрагмента, используемого функцией netcdf.open, может отличаться, чем входное значение, которое вы задаете. Для фактического значения, используемого функцией, смотрите аргумент actualChunksize.

Пример: 1024

Пример: 8192

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

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

свернуть все

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

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

Фактический размер фрагмента используется функцией netcdf.open, возвращенной как целое число.

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

Алгоритмы

Эта функция соответствует nc_open и функциям nc__open в библиотеке C API NetCDF. Чтобы использовать эту функцию, вы должны ознакомиться с парадигмой программирования netCDF. Смотрите netcdf для получения дополнительной информации.

Смотрите также

| |

Введенный в R2011a

Документация MATLAB
Поддержка