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

Высокоуровневый интерфейс

Получение информации

# NetCDF.ncinfo — Function

ncinfo(filename)

Выводит информацию о переменных, измерении и атрибутах, содержащихся в файле

Чтение данных

# NetCDF.ncread — Function

ncread(filename, varname)

Считывает значения переменной varname из файла filename и возвращает их в массиве.

Именованные аргументы

  • start: вектор длиной ndim(v), задающий начальный индекс для каждого измерения

  • count: вектор длиной ndim(v), задающий число значений, которые должны быть считаны по каждому измерению. Особым случаем является значение --1, при котором считываются все значения по измерению

Пример

Для считывания второго среза трехмерной переменной NetCDF можно использовать такой код:

ncread("filename","varname", start=[1,1,2], count = [-1,-1,1])

# NetCDF.ncread! — Function

ncread!(filename, varname, d)

Считывает значения переменной varname из файла filename и записывает результаты в предварительно размещенный в памяти массив d

Именованные аргументы

  • start: вектор длиной ndim(v), задающий начальный индекс для каждого измерения

  • count: вектор длиной ndim(v), задающий число значений, которые должны быть считаны по каждому измерению. Особым случаем является значение --1, при котором считываются все значения по данному измерению

Пример

Для считывания второго среза трехмерной переменной NetCDF можно использовать такой код:

d = zeros(10,10,1)
ncread!("filename","varname", d, start=[1,1,2], count = [-1,-1,1])

Запись данных

# NetCDF.ncwrite — Function

ncwrite(x::Array,fil::AbstractString,vname::AbstractString)

Записывает массив x в файл fil и переменную vname.

Именованные аргументы

  • start: вектор длиной ndim(v), задающий начальный индекс записи для каждого измерения

  • count: вектор длиной ndim(v), задающий число значений, которые должны быть записаны по каждому измерению. Особым случаем является значение --1, при котором записываются все значения по измерению. Обычно выводится из указанного размера массива.

Чтение атрибутов

# NetCDF.ncgetatt — Function

ncgetatt(filename, varname, attname)

Считывает атрибут NetCDF attname из указанного файла и переменной. Для считывания глобальных атрибутов задайте для varname значение Global.

Запись атрибутов

# NetCDF.ncputatt — Function

ncputatt(nc::String,varname::String,atts::Dict)

Записывает атрибуты, определенные в atts, в переменную varname для заданного имени файла NetCDF nc. Существующие атрибуты перезаписываются. Если varname не является допустимым именем переменной, записывается глобальный атрибут.

Создание файлов

# NetCDF.nccreate — Function

nccreate (filename, varname, dimensions ...)

Создает переменную в существующем файле NetCDF или создает новый файл. filename и varname — строки. После них следует список измерений. Каждая запись измерения начинается с его имени (строки), за которым могут следовать длина измерения, массив со значениями измерения или словарь с атрибутами измерения. После этого указывается следующее измерение и так далее. Пример использования см. в examples/high.jl.

Именованные аргументы

  • atts: словарь имен и значений атрибутов, присваиваемых создаваемой переменной

  • gatts: словарь имен и значений атрибутов, записываемых как глобальные

  • compress: целое число [0..9], определяющее уровень сжатия файла; действительно только при mode=NC_NETCDF4

  • t: тип переменной; в настоящее время поддерживаются типы const NC_BYTE, NC_CHAR, NC_SHORT, NC_INT, NC_FLOAT, NC_LONG, NC_DOUBLE

  • mode: режим создания файла; действует только при создании файла; возможные значения: NC_NETCDF4, NC_CLASSIC_MODEL, NC_64BIT_OFFSET