Exponenta Banner
exponenta event banner

netcdf.open

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

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

Синтаксис

ncid = netcdf.open (источник)
ncid = netcdf.open (источник, режим)
[activeChunksize, ncid] = netcdf.open (источник, режим, chunksize)

Описание

пример

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

пример

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

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

Примеры

свернуть все

Открыть сценарий в реальном времени

Откройте образец файла 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)
Открыть сценарий в реальном времени

Откройте 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 функции в API библиотеки C netCDF. Для использования этой функции необходимо ознакомиться с парадигмой программирования netCDF.

См. также

|

Представлен в R2011a

Документация MATLAB

Поддержка