Exponenta Banner
exponenta event 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. The source может быть задано имя файла NetCDF или URL-адрес источника данных NetCDF OPeNDAP.

пример

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

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

Примеры

свернуть все

Открыть Live Script

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

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

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

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

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

netcdf.close(ncid)
Открыть 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 источника данных NetCDF OPeNDAP.

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

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

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

Можно также задать mode с числовым значением. Найдите числовое значение для mode при помощи netcdf.getConstant. Для примера, netcdf.getConstant('WRITE') возвращает числовое значение для mode. Используйте эти числовые значения, когда вы хотите задать bitwise-OR из нескольких режимов.

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

Параметр размера фрагмента для настройки эффективности, заданный как целое число.

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

Пример: 1024

Пример: 8192

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

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

свернуть все

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

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

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

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

Алгоритмы

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

См. также

|

Введенный в R2011a

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

Поддержка