mincgen: en línea en la nube

PROGRAMA:

NOMBRE

mincgen: genera un archivo MINC a partir de un archivo CDL.

SINOPSIS

mincgen [-b] [-n] [-o minc_nombre_archivo] fichero de entrada

DESCRIPCIÓN

Mincgen genera un archivo MINC. La entrada a Mincgen es una descripción de un archivo MINC en un
pequeño lenguaje conocido como CDL (Network Common Data Form Language), que se describe a continuación. Si no
las opciones se especifican al invocar Mincgen, simplemente verifica la sintaxis de la CDL de entrada
archivo, produciendo mensajes de error para cualquier violación de la sintaxis de CDL. Otras opciones pueden ser
utilizado para crear el archivo MINC correspondiente.

Mincgen se puede utilizar con el programa complementario volcar mincd para realizar algunas operaciones simples
en archivos MINC. Por ejemplo, para cambiar el nombre de una dimensión en un archivo MINC, utilice volcar mincd conseguir un
Versión CDL del archivo MINC, edite el archivo CDL para cambiar el nombre de las dimensiones y
utilizan el Mincgen para generar el archivo MINC correspondiente a partir del archivo CDL editado.

CAMPUS

-b Cree un archivo MINC (binario). Si el -o la opción está ausente, un nombre de archivo predeterminado
construirse a partir del nombre MINC (especificado después de la netcdf or hdf5 palabra clave en
la entrada) agregando la extensión `.mnc '. Si ya existe un archivo con el
nombre especificado, se sobrescribirá.

-o minc_nombre_archivo
Nombre del archivo MINC binario creado. Si se especifica esta opción, implica la
"-b"opción. (Esta opción es necesaria porque los archivos MINC no se pueden escribir
directamente a la salida estándar, ya que la salida estándar no se puede buscar).

EJEMPLOS

Compruebe la sintaxis del archivo CDL `foo.cdl':

mincgen foo.cdl

Desde el archivo CDL `foo.cdl', genera un archivo MINC binario equivalente llamado `x.mnc':

mincgen -o x.mnc foo.cdl

USO

Licencia CDL Sintaxis Resumen
A continuación se muestra un ejemplo de sintaxis de CDL, que describe un archivo MINC con varias dimensiones nombradas
(xspace, yspace y zspace), variables (zspace, imagen), atributos de variable (valid_range,
signtype) y algunos datos. Las palabras clave de CDL están en negrita. (Este ejemplo está destinado a
ilustrar la sintaxis; un archivo CDL real tendría un conjunto de atributos más completo, por lo que
que los datos serían más completamente autodescriptivos).

netcdf foo {// un ejemplo de especificación MINC en CDL

dimensiones:
xespacio = 8;
espacio y = 8;
espacioz = 5;

las variables:
flotar xespacio;
flotar yespacio;
flotar zspace (zspace);
Corto imagen (espacio z, espacio y, espacio x);
doble imagen-min (espacio z)
doble image-max (espacio z)

// atributos variables
imagen: rango_valido = 0,5;
datos:
image-min = -1,-1,-1,-1,-1;
imagen-máx = 1,1,1,1,1;
imagen =
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;
espacioz = 0,2,3.5,7,10;
}

Todas las declaraciones de CDL terminan con un punto y coma. Se pueden usar espacios, tabulaciones y nuevas líneas
libremente para facilitar la lectura. Los comentarios pueden seguir a los caracteres `// 'en cualquier línea.

Una descripción de CDL consta de tres partes opcionales: dimensiones, las variablesy datos,
comenzando con la palabra clave dimensiones:, variables:y datos, respectivamente. La variable
parte puede contener variable declaraciones y atributo asignaciones.

UN MINC dimensión se utiliza para definir la forma de uno o más de los multidimensionales
variables contenidas en el archivo MINC. Una dimensión MINC tiene un nombre, un tamaño y posiblemente
varios otros atributos.

A variable representa una matriz multidimensional de valores del mismo tipo. Una variable tiene
un nombre, un tipo de datos y una forma descrita por su lista de dimensiones. Cada variable puede
también se han asociado atributos (ver más abajo) así como valores de datos. El nombre, tipo de datos,
y la forma de una variable se especifican mediante su declaración en el variable sección de una CDL
descripción. Una variable puede tener el mismo nombre que una dimensión; por convención tal
La variable es unidimensional y contiene coordenadas de la dimensión que nombra.
Las dimensiones no necesitan tener variables correspondientes.

Un netCDF atributo contiene información sobre una variable netCDF o sobre todo el netCDF
conjunto de datos. Los atributos se utilizan para especificar propiedades tales como unidades, valores especiales, máximos
y valores mínimos válidos, factores de escala, compensaciones y parámetros. Información de atributos
está representado por valores únicos o matrices de valores. Por ejemplo, "unidades" es un atributo
representado por una matriz de caracteres como "celsius". Un atributo tiene asociado
variable, un nombre, un tipo de datos, una longitud y un valor. En contraste con las variables que son
destinados a datos, los atributos están destinados a metadatos (datos sobre datos).

En CDL, un atributo se designa mediante una variable y un nombre de atributo, separados por ':'. Eso
es posible asignar global atributos no asociados con ninguna variable al archivo como un
entero usando `: 'antes del nombre del atributo. El tipo de datos de un atributo en CDL es
derivado del tipo de valor que se le asigna. La longitud de un atributo es la
número de valores de datos asignados a él, o el número de caracteres en la cadena de caracteres
asignado a él. Se asignan varios valores a los atributos que no son caracteres separando
los valores con comas. Todos los valores asignados a un atributo deben ser del mismo tipo.

Los nombres de las dimensiones, las variables y los atributos de la CDL deben comenzar con una letra alfabética.
carácter o '_', y los caracteres subsiguientes pueden ser alfanuméricos o '_' o '-'.

La opción datos La sección de una especificación de CDL es donde se pueden inicializar las variables.
La sintaxis de una inicialización es simple: un nombre de variable, un signo igual y una coma.
lista delimitada de constantes (posiblemente separadas por espacios, tabulaciones y nuevas líneas) terminadas
con un punto y coma. Para matrices multidimensionales, la última dimensión varía más rápidamente. Por lo tanto
Para las matrices se utiliza el orden de filas en lugar de el orden de columnas. Si se proporcionan menos valores
que son necesarios para llenar una variable, se amplía con un "valor de relleno" dependiente del tipo,
que se puede anular proporcionando un valor para un atributo de variable distinguido llamado
`_FillValue '. Los tipos de constantes no necesitan coincidir con el tipo declarado para una variable;
las coacciones se realizan para convertir enteros a punto flotante, por ejemplo. La constante '_'
se puede utilizar para designar el valor de relleno de una variable.

Primitivo Datos Tipos
tanque personajes
byte Bits de datos 8-
Corto Enteros de 16 bits con signo
Corto Enteros de 32 bits con signo
int (sinónimo de Corto)
flotar Punto flotante de precisión simple IEEE (32 bits)
real (sinónimo de flotar)
doble Punto flotante de doble precisión IEEE (64 bits)

Excepto por el tipo de datos agregado byte y la falta de no firmado, CDL admite lo mismo
tipos de datos primitivos como C. Los nombres de los tipos de datos primitivos son palabras reservadas en
CDL, por lo que los nombres de variables, dimensiones y atributos no deben ser nombres de tipos. En
declaraciones, los nombres de los tipos se pueden especificar en mayúsculas o minúsculas.

Los bytes se diferencian de los caracteres en que están destinados a contener ocho bits completos de datos,
y el byte cero no tiene un significado especial, como lo tiene para los datos de caracteres.

Los pantalones cortos pueden contener valores entre -32768 y 32767.

Los largos pueden contener valores entre -2147483648 y 2147483647. int y entero son aceptados como
sinónimos para Corto en declaraciones CDL. Ahora que hay plataformas con 64 bits
representaciones para C longs, puede ser mejor utilizar la int sinónimo para evitar confusiones.

Los flotadores pueden contener valores entre aproximadamente -3.4 + 38 y 3.4 + 38. Su representación externa es
como números de coma flotante de precisión simple normalizados IEEE de 32 bits. real es aceptado como
sinónimo de flotar en declaraciones CDL.

Los dobles pueden contener valores entre -1.7 + 308 y 1.7 + 308. Su representación externa
es como números de coma flotante de doble precisión normalizados estándar IEEE de 64 bits.

Licencia CDL Constantes
Las constantes asignadas a atributos o variables pueden ser de cualquiera de los tipos básicos de MINC. los
la sintaxis para constantes es similar a la sintaxis de C, excepto que los sufijos de tipo deben agregarse a
shorts y flotadores para distinguirlos de largos y dobles.

A byte La constante está representada por una secuencia de escape de un solo carácter o de varios caracteres.
entre comillas simples. Por ejemplo,
'a' // ASCII `a '
'\ 0' // un byte cero
'\ n' // Carácter de nueva línea ASCII
'\ 33' // Carácter de escape ASCII (33 octal)
'\ x2b' // ASCII más (2b hex)
'\ 377' // 377 octal = 255 decimal, no ASCII

Las constantes de caracteres se incluyen entre comillas dobles. Se puede representar una matriz de caracteres
como una cadena entre comillas dobles. Se respetan las convenciones habituales de escape de cadenas de C.
Por ejemplo:
"a" // ASCII `a '
"Dos \ nlíneas \ n" // una cadena de 10 caracteres con dos nuevas líneas incrustadas
"una campana: \ 007" // una cadena que contiene una campana ASCII
Tenga en cuenta que la matriz de caracteres "a" encajaría en una variable de un elemento, ya que no
se asume el carácter de terminación NULL. Sin embargo, un byte cero en una matriz de caracteres es
interpretado como el final de los caracteres significativos por el volcar mincd programa, siguiendo
la convención C. Por lo tanto, no se debe incrustar un byte NULL en una cadena de caracteres.
a menos que al final: use el byte tipo de datos en su lugar para matrices de bytes que contienen el cero
byte. MINC y CDL no tienen tipo de cadena, sino solo matrices de caracteres de longitud fija, que pueden
ser multidimensional.

Corto Las constantes enteras están diseñadas para representar cantidades con signo de 16 bits. La forma
menos Corto La constante es una constante entera con una 's' o una 'S' agregada. Si un Corto
constante comienza con '0', se interpreta como octal, excepto que si comienza con '0x',
se interpreta como una constante hexadecimal. Por ejemplo:
-2s // un -2 corto
0123s // octal
0x7ffs // hexadecimal

Largo Las constantes enteras están diseñadas para representar cantidades con signo de 32 bits. La forma
menos Corto constante es una constante entera ordinaria, aunque es aceptable agregar un
opcional 'l' o 'L'. Si un Corto constante comienza con '0', se interpreta como octal,
excepto que si comienza con '0x', se interpreta como una constante hexadecimal. Ejemplos de
de valido Corto las constantes incluyen:
-2
1234567890L
0123 // octava
0x7ff // hexadecimal

Constantes de coma flotante de tipo flotar son apropiados para representar el punto flotante
datos con aproximadamente siete dígitos significativos de precisión. La forma de un flotar constante es
lo mismo que una constante de coma flotante C con una `f 'o una` F' agregada. Por ejemplo el
los siguientes son todos aceptables flotar constantes:
-2.0f
3.14159265358979f // se truncará con menos precisión
1.f

Constantes de coma flotante de tipo doble son apropiados para representar el punto flotante
datos con aproximadamente dieciséis dígitos significativos de precisión. La forma de un doble constante es
lo mismo que una constante de coma flotante C. Se puede agregar una "d" o "D" opcional. Para
ejemplo los siguientes son todos aceptables doble constantes:
-2.0
3.141592653589793
1.0e-20
1.d

Use mincgen en línea usando los servicios de onworks.net