mincgen - Online na nuvem

PROGRAMA:

NOME

mincgen - Gere um arquivo MINC a partir de um arquivo CDL.

SINOPSE

mincgen [-b] [-n] [-o minc_filename] Arquivo de entrada

DESCRIÇÃO

mincgen gera um arquivo MINC. A entrada para mincgen é uma descrição de um arquivo MINC em um
pequena linguagem conhecida como CDL (Network Common Data form Language), descrita abaixo. Se não
opções são especificadas ao invocar mincgen, ele apenas verifica a sintaxe do CDL de entrada
arquivo, produzindo mensagens de erro para quaisquer violações da sintaxe CDL. Outras opções podem ser
usado para criar o arquivo MINC correspondente.

mincgen pode ser usado com o programa complementar mincdump para realizar algumas operações simples
em arquivos MINC. Por exemplo, para renomear uma dimensão em um arquivo MINC, use mincdump para conseguir um
Versão CDL do arquivo MINC, edite o arquivo CDL para alterar o nome das dimensões e
usar mincgen para gerar o arquivo MINC correspondente a partir do arquivo CDL editado.

OPÇÕES

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

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

EXEMPLOS

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

mincgen foo.cdl

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

mincgen -o x.mnc foo.cdl

USO

CDL Sintaxe Resumo
Abaixo está um exemplo de sintaxe CDL, descrevendo um arquivo MINC com várias dimensões nomeadas
(xspace, yspace e zspace), variáveis ​​(zspace, imagem), atributos de variáveis ​​(intervalo_valido,
signtype) e alguns dados. As palavras-chave CDL estão em negrito. (Este exemplo destina-se a
ilustrar a sintaxe; um arquivo CDL real teria um conjunto de atributos mais completo, então
que os dados seriam mais completamente autodescritivos.)

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

dimensões:
xespaço = 8;
yespaço = 8;
zespaço = 5;

variáveis:
flutuar xespaço;
flutuar espaço y;
flutuar zspace (zspace);
baixo imagem (zspace, yspace, xspace);
duplo imagem-min (zspace)
duplo image-max (zspace)

// atributos de variáveis
imagem: valid_range = 0,5;
dados,:
image-min = -1,-1,-1,-1,-1;
imagem-máx = 1,1,1,1,1;
imagem =
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,2,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,3,
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,
5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5,5;
zespaço = 0,2,3.5,7,10;
}

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 MINC dimensão é usado para definir a forma de um ou mais dos elementos multidimensionais
variáveis ​​contidas no arquivo MINC. Uma dimensão MINC tem um nome, um tamanho e possivelmente
vários outros atributos.

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 nenhuma variável para o arquivo como um
inteiro 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 ​​podem ser inicializadas.
A sintaxe de uma inicialização é simples: um nome de variável, um sinal de igual e uma vírgula
lista delimitada de constantes (possivelmente separadas por espaços, tabulações e novas linhas) terminada
com um ponto e vírgula. Para matrizes multidimensionais, a última dimensão varia mais rapidamente. Assim
a ordem das linhas, em vez da ordem das colunas, é usada para matrizes. Se menos valores forem fornecidos
do que o necessário para preencher uma variável, ele é estendido com um `valor de preenchimento 'dependente do tipo,
que pode ser substituído fornecendo um valor para um atributo de variável distinto chamado
`_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. A constante `_ '
pode ser usado para designar o valor de preenchimento de uma variável.

Primitivo Data 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.

Shorts podem conter valores entre -32768 e 32767.

Longs podem conter valores entre -2147483648 e 2147483647. int e número inteiro são aceitos como
sinônimos para longo em declarações CDL. Agora que existem plataformas com 64 bits
representações para C longs, 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. reais é aceito como um
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.

CDL Constante
As constantes atribuídas a atributos ou variáveis ​​podem ser de qualquer um dos tipos básicos do MINC. o
a sintaxe para constantes é semelhante à sintaxe C, exceto que os sufixos de tipo devem ser anexados 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 "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 mincdump 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. MINC e CDL não têm tipo de string, mas apenas matrizes de caracteres de comprimento fixo, que podem
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

Use mincgen online usando serviços onworks.net