ncks - Online en la nube

PROGRAMA:

NOMBRE

ncks - fregadero de cocina netCDF

SINTAXIS

ncks [-3] [-4] [-5] [-6] [-7] [-A] [-a] [-b bnr_fl] [--bfr sz][-C][-c] [--cdl] [--cnk_byt
sz][--cnk_dmn nm, sz] [--cnk_mapa mapa] [--cnk_min sz] [--cnk_plc plc] [--cnk_scl sz] [-D
dbg_lvl] [-d oscuro,[ min] [, [ max]] [, [ paso]]] [-F] [--fix_rec_dmn oscuro] [-G gpe_dsc] [-g
grp[, ...]] [--glb att_name = att_val]] [--grp_xtr_var_xcl] [-H] [-h] [--hdn] [--hdr_pad
sz] [-L dfl_lvl] [-l camino] [-M] [-m] [--mapa archivo de mapa] [--md5] [--mk_rec_dmn oscuro] [--msa]
[--no_blank] [--no_tmp_fl] [-O] [-o archivo de salida] [-P] [-P camino] [--ppc var1[, var2[, ...]] =
prc]] [-Q] [-q] [-R] [-r] [--rad] [--ram_todos] [--rgr clave = val]] [--rnr peso][-s formato][-t
thr_nbr][-u][--unn][-V][-v var[,...]] [-X box] [-x] [--xml] fichero de entrada [ archivo de salida]

DESCRIPCIÓN

ncks combina todas las características que podríamos pensar, excepto el fregadero de la cocina, en una versátil
utilidad para manipular archivos netCDF. ncks extrae un subconjunto de los datos de fichero de entrada
y lo imprime como texto ASCII en stdout, o lo escribe (o pega) en archivo de salida o
ambos.

ncks imprimirá datos netCDF en formato ASCII para stdoutdel ADN, tales como los ncdump, pero con estos
diferencias: ncks imprime datos en un formato tabular destinado a facilitar la búsqueda de
datos que desee, un dato por línea de pantalla, con todos los subíndices de dimensión y coordenadas
valores (si los hay) que preceden al dato. Opción -s permite al usuario formatear los datos usando
Cadenas de formato de estilo C.

-a, -F, -H, -M, -m, -Q, -q, -s, -u y -V controlar la apariencia formateada del
datos.

ncks extraerá (y opcionalmente creará un nuevo archivo netCDF compuesto por) solo seleccionado
variable del archivo de entrada, como ncextr pero con estas diferencias: solo las variables y
Las coordenadas pueden incluirse o excluirse específicamente --- todos los atributos globales y cualquier
El atributo asociado con una variable extraída se copiará en la pantalla y / o la salida.
archivo netCDF. Opciones -c, -C, -v y -x controlar qué variables se extraen.

ncks extraerá hyperslabs de las variables especificadas. De hecho ncks implementa el
Especificación nccut exactamente. Opción -d controla la especificación de hyperslab.

Las dimensiones de entrada que no están asociadas con ninguna variable de salida no aparecerán en la
salida netCDF. Esta función elimina las dimensiones superfluas de un archivo netCDF.

ncks agregará variables y atributos de la fichero de entrada a archivo de salida if producción-
presentar es un archivo netCDF preexistente cuyas dimensiones relevantes se ajustan a los tamaños de dimensión de
fichero de entrada. Las características adjuntas de ncks están destinados a proporcionar un medio rudimentario de
agregar datos de un archivo netCDF a otro archivo netCDF conforme. Al nombrar
existen conflictos entre los dos archivos, los datos en archivo de salida generalmente se sobrescribe con el
datos correspondientes de fichero de entrada. Por lo tanto, se recomienda que la copia de seguridad del usuario producción-
presentar en caso de que se sobrescriban accidentalmente datos valiosos.

If archivo de salida existe, se preguntará al usuario si desea exagerar, anexar o salida la
ncks llamar completamente. Elegir exagerar destruye lo existente archivo de salida y crear un
uno completamente nuevo de la salida de la ncks llama. Append tiene diferentes efectos dependiendo
sobre la unicidad de las variables y atributos producidos por ncks: Si una variable o
atributo extraído de fichero de entrada no tiene un conflicto de nombre con los miembros de
archivo de salida luego se agregará a archivo de salida sin sobrescribir ninguno de los existentes
contenido de archivo de salida. En este caso, las dimensiones relevantes deben coincidir (ajustarse)
entre los dos archivos; se crean nuevas dimensiones en archivo de salida según sea necesario. Cuando un nombre
ocurre un conflicto, un atributo global de fichero de entrada sobrescribirá el correspondiente
atributo global de archivo de salida. Si se produce un conflicto de nombre para una variable que no es de registro,
luego las dimensiones y el tipo de la variable (y de sus dimensiones de coordenadas, si las hay)
debe estar de acuerdo (conformarse) en ambos archivos. Luego, los valores de las variables (y cualquier coordenada
valores de dimensión) de fichero de entrada sobrescribirá los valores de las variables correspondientes (y
valores de cota de coordenadas, si los hay) en archivo de salida

Dado que solo puede haber una dimensión de registro en un archivo, la dimensión de registro debe tener la
mismo nombre (pero no necesariamente el mismo tamaño) en ambos archivos si una variable de dimensión de registro
se adjuntará. Si las dimensiones del registro son de diferentes tamaños, la dimensión del registro
of archivo de salida se convertirá en el mayor de los dos tamaños de dimensión de registro, el registro
variable de fichero de entrada sobrescribirá cualquier contraparte en archivo de salida y llenar valores
se escribirá en cualquier espacio que quede en el resto de las variables de registro (creo). En todo
casos atributos variables en archivo de salida son reemplazados por atributos del mismo nombre
de fichero de entraday se deja solo si no hay conflicto de nombres.

Es posible que algunos usuarios deseen evitar la interacción ncks consultas sobre si sobrescribir los existentes
datos. Por ejemplo, los scripts por lotes fallarán si ncks no recibe respuestas a su
consultas. Opciones -O y -A están disponibles para forzar la sobrescritura de archivos existentes y
variables, respectivamente.

Opciones específicas para ncks

La siguiente lista proporciona un breve resumen de las funciones exclusivas de ncks.

-a No alfabetice los campos extraídos. De forma predeterminada, las variables de salida especificadas
se extraen, imprimen y escriben en disco en orden alfabético. Esto tiende a
hacen que las listas de salida largas sean más fáciles de buscar variables particulares. Especificando -a
da como resultado que las variables se extraigan, impriman y escriban en el disco en el orden
en el que se guardaron en el archivo de entrada. Por lo tanto -a conserva el pedido original
de las variables

-d oscuro,[ min] [, [ max]] [, [ paso]] Agregar paso argumento a hiperslabber.

-H Imprime datos en la pantalla. El comportamiento predeterminado es imprimir datos en la pantalla si no hay netCDF
se especifica el archivo de salida. Usar -H para imprimir datos en la pantalla si una salida netCDF es
especificado (el mismo comportamiento se aplica a -m ). A menos que se especifique lo contrario (con
-s), cada elemento de la hiperlab de datos se imprime en una línea separada que contiene
los nombres, índices y valores, si los hay, de todas las dimensiones de las variables. los
Los índices de dimensión y variable se refieren a la ubicación de los datos correspondientes.
elemento con respecto a la variable almacenada en el disco (es decir, no en el hiperlab).
% ncks -H -C -v tres_dmn_var in.nc
lat[0]=-90 lev[0]=100 lon[0]=0 three_dmn_var[0]=0
lat[0]=-90 lev[0]=100 lon[1]=90 three_dmn_var[1]=1
lat[0]=-90 lev[0]=100 lon[2]=180 three_dmn_var[2]=2
...
lat[1]=90 lev[2]=1000 lon[1]=90 three_dmn_var[21]=21
lat[1]=90 lev[2]=1000 lon[2]=180 three_dmn_var[22]=22
lat[1]=90 lev[2]=1000 lon[3]=270 three_dmn_var[23]=23
Imprimiendo la misma variable con el -F La opción muestra la misma variable indexada con Fortran
convenciones
% ncks -F -H -C -v tres_dmn_var in.nc
lon(1) = 0 lev(1) = 100 lat(1) = - 90 tres_dmn_var(1) = 0
lon(2) = 90 lev(1) = 100 lat(1) = - 90 tres_dmn_var(2) = 1
lon(3) = 180 lev(1) = 100 lat(1) = - 90 tres_dmn_var(3) = 2
...
La impresión de un hiperlab no afecta los índices de variable o dimensión, ya que estos índices
son relativas a la variable completa (como se almacena en el archivo de entrada), y el archivo de entrada tiene
sin cambio. Sin embargo, si el hyperslab se guarda en un archivo de salida y esos valores son
impreso, los índices cambiarán:
% ncks -H -d lat, 90.0 -d lev, 1000.0 -v three_dmn_var in.nc out.nc
lat[1]=90 lev[2]=1000 lon[0]=0 three_dmn_var[20]=20
lat[1]=90 lev[2]=1000 lon[1]=90 three_dmn_var[21]=21
lat[1]=90 lev[2]=1000 lon[2]=180 three_dmn_var[22]=22
lat[1]=90 lev[2]=1000 lon[3]=270 three_dmn_var[23]=23
% ncks -H out.nc
lat[0]=90 lev[0]=1000 lon[0]=0 three_dmn_var[0]=20
lat[0]=90 lev[0]=1000 lon[1]=90 three_dmn_var[1]=21
lat[0]=90 lev[0]=1000 lon[2]=180 three_dmn_var[2]=22
lat[0]=90 lev[0]=1000 lon[3]=270 three_dmn_var[3]=23

-M Imprima para filtrar los metadatos globales que describen el archivo. Esto incluye archivo
información resumida y atributos globales.

-m Imprimir metadatos variables en la pantalla (similar a ncdump -h). Esto muestra todo
metadatos pertenecientes a cada variable, una variable a la vez.

-Q Alternar la impresión de índices de dimensión y valores de coordenadas al imprimir matrices.
El nombre de cada variable aparecerá alineado a la izquierda en la salida. Esto es útil
al intentar localizar variables específicas al mostrar muchas variables con
diferentes dimensiones. El mnemónico de esta opción es "silencioso".

-s formato Formato de cadena para salida de texto. Acepta secuencias de escape en lenguaje C y
printf () formatos.

-u Acompañar la impresión de los valores de una variable con su atributo de unidades, si
existe.

EJEMPLOS

Ver todos los datos en netCDF en.nc, impreso con las convenciones de indexación de Fortran:
ncks -H -F pulg.nc

Copie el archivo netCDF en.nc archivar fuera.nc.
ncks -O entrada.nc salida.nc
Ahora el archivo fuera.nc contiene todos los datos de en.nc. Sin embargo, existen dos diferencias
entre en.nc y fuera.nc. Primero el historia El atributo global contendrá el comando
usado para crear fuera.nc. En segundo lugar, las variables en fuera.nc se definirá en orden alfabético
pedido. Por supuesto, el almacenamiento interno de la variable en un archivo netCDF debe ser transparente
para el usuario, pero hay casos en los que ordenar alfabéticamente un archivo es útil (consulte la descripción de
-a cambiar).

Imprimir variable tres_dmn_var desde el archivo en.nc con notaciones predeterminadas. Siguiente impresión
tres_dmn_var como una columna de texto sin anotaciones. Entonces imprime tres_dmn_var firmado con muy
alta precisión. Finalmente, imprima tres_dmn_var como una lista separada por comas.
% ncks -H -C -v tres_dmn_var in.nc
lat[0]=-90 lev[0]=100 lon[0]=0 three_dmn_var[0]=0
lat[0]=-90 lev[0]=100 lon[1]=90 three_dmn_var[1]=1
...
lat[1]=90 lev[2]=1000 lon[3]=270 three_dmn_var[23]=23
% ncks -s "% f \ n" -H -C -v three_dmn_var in.nc
0.000000
1.000000
...
23.000000
% ncks -s "% + 16.10f \ n" -H -C -v three_dmn_var in.nc
+0.0000000000
+1.0000000000
...
+23.0000000000
% ncks -s "% f," -H -C -v three_dmn_var in.nc
0.000000, 1.000000, ..., 23.000000,
La segunda y tercera opciones son útiles al pegar datos en archivos de texto como informes o
papeles.

Las matrices unidimensionales de caracteres almacenados como variables netCDF se imprimen automáticamente
como cadenas, estén o no terminadas en NUL, p. ej.,
ncks -v fl_nm en.nc
El %c El código de formato es útil para imprimir matrices multidimensionales de caracteres.
representando cadenas de longitud fija
ncks -H -s "% c" -v fl_nm_arr in.nc
Usando el %s formato de código en cadenas que no están terminadas en NUL (y, por lo tanto, técnicamente no
strings) es probable que resulte en un volcado de memoria.

Crear netCDF fuera.nc que contiene todas las variables y las coordenadas asociadas, excepto
variable time, de netCDF en.nc:
ncks -x -v tiempo in.nc out.nc

Extraer variables time y presión desde netCDF en.nc. Si fuera.nc no existe
ser creado. De lo contrario, se le preguntará si desea agregar o sobrescribir
fuera.nc:
ncks -v tiempo, presión in.nc out.nc
ncks -C -v tiempo, presión in.nc out.nc
La primera versión del comando crea un fuera.nc que contiene time, presióny cualquier
coordinar variables asociadas con presión. fuera.nc de la segunda versión es
garantizado para contener solo dos variables time y presión.

Crear netCDF fuera.nc que contiene todas las variables del archivo en.nc. Restringir las dimensiones de
estas variables a una hiperslab. Imprimir (con -H) las hiperslabs a la pantalla para siempre
la medida. El hiperslab especificado es: el sexto valor en dimensión time; el medio abierto
distancia lat <= 0.0 en coordenada lat; la gama semiabierta lon > = 330.0 en coordenada lon;
el intervalo cerrado 0.3 <= Número <= 0.5 en coordenada Número; y sección transversal más cercana a
1000.0 en coordenada lev. Tenga en cuenta que los límites aplicados a los valores de coordenadas se especifican
con un punto decimal, y los límites aplicados a los índices de dimensión no tienen un punto decimal.
ncks -H -d tiempo, 5 -d lat ,, 0. -d lon, 330., -d banda, .3, .5 -d lev, 1000. in.nc out.nc

Suponga el dominio de la coordenada de longitud que aumenta monótonamente lon es 0 lon <
360. Aquí, lon es un ejemplo de una coordenada envuelta. ncks extraerá una hiperslab
que cruza el meridiano de Greenwich simplemente especificando la longitud más occidental como min
y la longitud más oriental como max, como sigue:
ncks -d lon, 260., 45. in.nc out.nc

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