ncmpigen - Online na nuvem

PROGRAMA:

NOME

ncmpigen - A partir de um arquivo CDL, gere um arquivo netCDF, um programa C ou um programa Fortran

SINOPSE

ncmpigen [-b] [-c] [-f] [-n] [-o nome_do_arquivo_netcdf] [-v formato de arquivo] Arquivo de entrada

DESCRIÇÃO

ncmpigen gera um arquivo netCDF ou código-fonte C ou Fortran para criar um netCDF
Arquivo. A entrada para ncmpigen é uma descrição de um arquivo netCDF em uma pequena linguagem conhecida
como CDL (Network Common Data form Language), descrito abaixo. Se nenhuma opção for especificada
em invocar ncmpigen, ele apenas verifica a sintaxe do arquivo CDL de entrada, produzindo um erro
mensagens para quaisquer violações da sintaxe CDL. Outras opções podem ser usadas para criar o
arquivo netCDF correspondente, para gerar um programa C que usa a interface netCDF C para
crie o arquivo netCDF, ou para gerar um programa Fortran que usa o netCDF Fortran
interface para criar o mesmo arquivo netCDF.

ncmpigen pode ser usado com o programa complementar ncmpidump para realizar algum simples
operações em arquivos netCDF. Por exemplo, para renomear uma dimensão em um arquivo netCDF, use
ncmpidump para obter uma versão CDL do arquivo netCDF, edite o arquivo CDL para alterar o nome do
as dimensões e use ncmpigen para gerar o arquivo netCDF correspondente do editado
Arquivo CDL.

OPÇÕES

-b Crie um arquivo netCDF (binário). Se o -o opção está ausente, um nome de arquivo padrão
será construído a partir do nome netCDF (especificado após o netcdf palavra-chave no
entrada) anexando a extensão `.nc '. Se já existe um arquivo com o
nome especificado, ele será sobrescrito.

-c Gerar C código-fonte que criará um arquivo netCDF correspondente ao netCDF
especificação. O código-fonte C é escrito na saída padrão.

-f Gerar Fortran código-fonte que criará um arquivo netCDF correspondente ao netCDF
especificação. O código-fonte do Fortran é escrito para saída padrão.

-o arquivo_netcdf
Nome do arquivo binário netCDF criado. Se esta opção for especificada, isso implica
o "-b"opção. (Esta opção é necessária porque os arquivos netCDF não podem ser gravados
diretamente para a saída padrão, uma vez que a saída padrão não é pesquisável.)

-n Como -b opção, exceto que cria um arquivo netCDF com a extensão `.cdf 'obsoleta
em vez da extensão `.nc ', na ausência de um nome de arquivo de saída especificado por
da -o opção. Esta opção é compatível apenas com versões anteriores.

-v formato de arquivo
Formato de arquivo do arquivo netCDF de saída. O valor de file_format pode ser: 1 ou
clássico para o formato CDF-1. O deslocamento de 2 ou 64 bits é CDF-2. Variável de 5 ou 64 bits para
CDF-5. O padrão (se esta opção não for fornecida) é CDF-1, o formato clássico.

EXEMPLOS

Verifique a sintaxe do arquivo CDL `foo.cdl':

ncmpigen foo.cdl

Do arquivo CDL `foo.cdl', gera um arquivo netCDF binário equivalente denominado `x.nc':

ncmpigen -o x.nc foo.cdl

Do arquivo CDL `foo.cdl', gerar um programa C contendo a função netCDF
invocações necessárias para criar um arquivo netCDF binário equivalente denominado `x.nc':

ncmpigen -c -o x.nc foo.cdl

USO

CDL Sintaxe Resumo
Abaixo está um exemplo de sintaxe CDL, descrevendo um arquivo netCDF com várias dimensões nomeadas
(lat, lon e tempo), variáveis ​​(Z, t, p, rh, lat, lon, tempo), atributos de variáveis ​​(unidades,
long_name, valid_range, _FillValue) e alguns dados. As palavras-chave CDL estão em negrito. (Esse
exemplo destina-se a ilustrar a sintaxe; um arquivo CDL real teria um arquivo mais completo
conjunto de atributos para que os dados sejam mais completamente autodescritivos.)

netcdf foo {// um exemplo de especificação netCDF em CDL

dimensões:
lat = 10, lon = 5, tempo = ilimitado ;

variáveis:
longo lat (lat), lon (lon), tempo (tempo);
flutuar Z (tempo, lat, lon), t (tempo, lat, lon);
duplo p (tempo, lat, lon);
longo rh (tempo, lat, lon);

// atributos de variáveis
lat: long_name = "latitude";
lat: unidades = "graus_north";
lon: long_name = "longitude";
lon: unidades = "graus_este";
tempo: unidades = "segundos desde 1992-1-1 00:00:00";
Z: unidades = "medidores geopotenciais";
Z: intervalo_válido = 0., 5000 .;
p: _FillValue = -9999 .;
rh: _FillValue = -1;

dados,:
lat = 0, 10, 20, 30, 40, 50, 60, 70, 80, 90;
lon = -140, -118, -96, -84, -52;
}

Todas as instruções CDL são encerradas por um ponto e vírgula. Espaços, guias e novas linhas podem ser usados
livremente para facilitar a leitura. Os comentários podem seguir os caracteres `// 'em qualquer linha.

Uma descrição CDL consiste em três partes opcionais: dimensões, variáveis e dados,,
começando com a palavra-chave dimensões:, variáveis: e dados,, respectivamente. A variável
parte pode conter variável declarações e atributo atribuições.

Um netCDF dimensão é usado para definir a forma de um ou mais dos elementos multidimensionais
variáveis ​​contidas no arquivo netCDF. Uma dimensão netCDF possui um nome e um tamanho. No
mais uma dimensão em um arquivo netCDF pode ter o ilimitado tamanho, o que significa uma variável
usar esta dimensão pode crescer para qualquer comprimento (como um número de registro em um arquivo).

A variável representa uma matriz multidimensional de valores do mesmo tipo. Uma variável tem
um nome, um tipo de dados e uma forma descrita por sua lista de dimensões. Cada variável pode
também tem associado atributos (veja abaixo), bem como valores de dados. O nome, tipo de dados,
e a forma de uma variável são especificados por sua declaração no variável seção de um CDL
Descrição. Uma variável pode ter o mesmo nome de uma dimensão; por convenção, tal
variável é unidimensional e contém coordenadas da dimensão que ela nomeia.
As dimensões não precisam ter variáveis ​​correspondentes.

Um netCDF atributo contém informações sobre uma variável netCDF ou sobre todo o netCDF
conjunto de dados. Os atributos são usados ​​para especificar propriedades como unidades, valores especiais, máximo
e valores mínimos válidos, fatores de escala, deslocamentos e parâmetros. Informação de atributo
é representado por valores únicos ou matrizes de valores. Por exemplo, "unidades" é um atributo
representado por uma matriz de caracteres como "celsius". Um atributo tem um associado
variável, um nome, um tipo de dados, um comprimento e um valor. Em contraste com variáveis ​​que são
destinados a dados, os atributos são destinados a metadados (dados sobre dados).

Em CDL, um atributo é designado por uma variável e nome de atributo, separados por `: '. Isto
é possível atribuir global atributos não associados a qualquer variável para o netCDF como
um todo usando `: 'antes do nome do atributo. O tipo de dados de um atributo em CDL é
derivado do tipo de valor atribuído a ele. O comprimento de um atributo é o
número de valores de dados atribuídos a ele, ou o número de caracteres na sequência de caracteres
atribuído a ele. Vários valores são atribuídos a atributos sem caracteres separando
os valores com vírgulas. Todos os valores atribuídos a um atributo devem ser do mesmo tipo.

Os nomes das dimensões, variáveis ​​e atributos de CDL devem começar com uma letra alfabética
caractere ou `_ ', e os caracteres subsequentes podem ser alfanuméricos ou` _' ou `- '.

O opcional dados, seção de uma especificação CDL é onde as variáveis ​​netCDF podem estar
inicializado. A sintaxe de uma inicialização é simples: um nome de variável, um sinal de igual,
e uma lista delimitada por vírgulas de constantes (possivelmente separadas por espaços, tabulações e novas linhas)
terminado com um ponto e vírgula. Para matrizes multidimensionais, a última dimensão varia
o mais rápido. Assim, a ordem das linhas, em vez da ordem das colunas, é usada para matrizes. Se menos valores
são fornecidos do que o necessário para preencher uma variável, é estendido com um dependente do tipo
'valor de preenchimento', que pode ser sobrescrito fornecendo um valor para uma variável distinta
atributo denominado `_FillValue '. Os tipos de constantes não precisam corresponder ao tipo declarado para
uma variável; as coerções são feitas para converter inteiros em ponto flutuante, por exemplo. o
a constante `_ 'pode ser usada para designar o valor de preenchimento de uma variável.

Primitivo Administração Tipos
carbonizar caracteres
byte Dados 8 bits
baixo Inteiros assinados de 16 bits
longo Inteiros assinados de 32 bits
int (sinônimo de longo)
flutuar Ponto flutuante de precisão única IEEE (32 bits)
reais (sinônimo de flutuar)
duplo Ponto flutuante de dupla precisão IEEE (64 bits)

Exceto para o tipo de dados adicionado byte e a falta de não assinado, CDL suporta o mesmo
tipos de dados primitivos como C. Os nomes dos tipos de dados primitivos são palavras reservadas em
CDL, portanto, os nomes de variáveis, dimensões e atributos não devem ser nomes de tipo. No
declarações, os nomes dos tipos podem ser especificados em maiúsculas ou minúsculas.

Os bytes diferem dos caracteres porque se destinam a conter oito bits completos de dados,
e o byte zero não tem significado especial, como acontece com os dados de caractere. ncmpigen
converte byte declarações para carbonizar declarações no código C de saída e para o
fora do padrão BYTE declaração no código Fortran de saída.

Shorts podem conter valores entre -32768 e 32767. ncmpigen converte baixo declarações para
baixo declarações no código C de saída e para o não padrão INTEGER * 2 declaração em
código Fortran de saída.

Longs podem conter valores entre -2147483648 e 2147483647. ncmpigen converte longo
declarações para longo declarações no código C de saída e para INTEGER declarações em
código Fortran de saída. int e número inteiro são aceitos como sinônimos para longo em CDL
declarações. Agora que existem plataformas com representações de 64 bits para C longos,
pode ser melhor usar o int sinônimo para evitar confusão.

Os flutuadores podem conter valores entre cerca de -3.4 + 38 e 3.4 + 38. Sua representação externa é
como números de ponto flutuante de precisão única normalizados IEEE de 32 bits. ncmpigen converte
flutuar declarações para flutuar declarações no código C de saída e para REAIS declarações em
código Fortran de saída. reais é aceito como sinônimo de flutuar em declarações CDL.

Os duplos podem conter valores entre cerca de -1.7 + 308 e 1.7 + 308. Sua representação externa
é um número de ponto flutuante de precisão dupla normalizado do IEEE de 64 bits. ncmpigen
converte duplo declarações para duplo declarações no código C de saída e para DUPLO
PRECISÃO declarações no código Fortran de saída.

CDL Constante
As constantes atribuídas a atributos ou variáveis ​​podem ser de qualquer um dos tipos básicos de netCDF.
A sintaxe para constantes é semelhante à sintaxe C, exceto que os sufixos de tipo devem ser
anexado a shorts e carros alegóricos para distingui-los de longos e duplos.

A byte constante é representada por um único caractere ou sequência de escape de múltiplos caracteres
entre aspas simples. Por exemplo,
'a' // ASCII `a '
'\ 0' // um byte zero
'\ n' // caractere de nova linha ASCII
'\ 33' // caractere de escape ASCII (33 octal)
'\ x2b' // ASCII plus (2b hex)
'\ 377' // 377 octal = 255 decimal, não ASCII

As constantes de caracteres são colocadas entre aspas duplas. Uma matriz de caracteres pode ser representada
como uma string entre aspas duplas. As convenções usuais de escape da string C são respeitadas.
Por exemplo
"a" // ASCII `a '
"Duas \ nlinhas \ n" // uma string de 10 caracteres com duas novas linhas incorporadas
"a bell: \ 007" // uma string contendo um sino ASCII
Observe que a matriz de caracteres netCDF "a" caberia em uma variável de um elemento, uma vez que não
terminando o caractere NULL é assumido. No entanto, um byte zero em uma matriz de caracteres é
interpretado como o fim dos caracteres significativos pelo ncmpidump programa, seguindo
a convenção C. Portanto, um byte NULL não deve ser incorporado em uma cadeia de caracteres
a menos que no final: use o byte tipo de dados em vez de matrizes de bytes que contêm o zero
byte. NetCDF e CDL não têm tipo de string, mas apenas matrizes de caracteres de comprimento fixo, que
pode ser multidimensional.

baixo constantes inteiras destinam-se a representar quantidades com sinal de 16 bits. A forma
de uma baixo constante é uma constante inteira com um `s 'ou` S' anexado. Se um baixo
constante começa com '0', é interpretada como octal, exceto que se começa com '0x',
é interpretado como uma constante hexadecimal. Por exemplo:
-2s // um curto -2
0123s // octal
0x7ffs // hexadecimal

longo constantes inteiras destinam-se a representar quantidades com sinal de 32 bits. A forma
de uma longo constante é uma constante inteira comum, embora seja aceitável acrescentar um
opcional `l 'ou` L'. Se um longo constante começa com '0', é interpretada como octal,
exceto que se começar com `0x ', é interpretado como uma constante hexadecimal. Exemplos
de válido longo constantes incluem:
-2
1234567890L
0123 // octal
0x7ff // hexadecimal

Constantes de vírgula flutuante de tipo flutuar são apropriados para representar ponto flutuante
dados com cerca de sete dígitos significativos de precisão. A forma de um flutuar constante é
o mesmo que uma constante de ponto flutuante C com um `f 'ou` F' anexado. Por exemplo o
a seguir são todos aceitáveis flutuar constantes:
-2.0f
3.14159265358979f // será truncado para menos precisão
1.fe

Constantes de vírgula flutuante de tipo duplo são apropriados para representar ponto flutuante
dados com cerca de dezesseis dígitos significativos de precisão. A forma de um duplo constante é
o mesmo que uma constante de ponto flutuante C. Um `d 'ou` D' opcional pode ser anexado. Para
exemplo, os seguintes são todos aceitáveis duplo constantes:
-2.0
3.141592653589793
1.0e-20
1d

INFORMAÇÃO

$ Data: 2014-04-16 13:38:34 -0500 (Quarta, 16 de abril de 2014) $

Use ncmpigen online usando serviços onworks.net