fundisp - Online en la nube

PROGRAMA:

NOMBRE

fundisp: muestra datos en un archivo de datos Funtools

SINOPSIS

fundir [-f formato] [-l] [-n] [-T] [columnas⎪bitpix = n]

CAMPUS

-f # cadena de formato para visualización
-l # muestra la imagen como una lista que contiene las columnas X, Y, VAL
-n # no generar encabezado
-F [c] # usa el carácter especificado como separador de columna (def: espacio)
-T # salida en formato rdb / starbase (separadores de pestañas)

DESCRIPCIÓN

fundir muestra los datos en la extensión de FITS especificada y / o la sección de imagen de un FITS
archivo, o en una sección de una matriz no FITS o archivo de eventos sin formato.

El primer argumento del programa especifica la imagen de entrada, la matriz o el archivo de eventos sin formato FITS
para mostrar. Si se especifica "stdin", los datos se leen desde la entrada estándar. Utilice Funtools
Notación entre corchetes para especificar extensiones FITS, secciones de imagen y filtros.

Si los datos que se muestran son columnas (ya sea en una tabla binaria FITS o en un evento sin procesar
archivo), se enumeran las filas individuales. Los filtros se pueden agregar usando notación de corchetes. Por lo tanto:

[sh] fundisp "test.ev [tiempo- (int) tiempo> .15]"
XY PHA PI TIME DX DY
------- ------- ------- --------- ---------------- ---- ------ ----------
10 8 10 8 17.1600 8.50 10.50
9 9 9 9 17.1600 9.50 9.50
10 9 10 9 18.1600 9.50 10.50
10 9 10 9 18.1700 9.50 10.50
8 10 8 10 17.1600 10.50 8.50
9 10 9 10 18.1600 10.50 9.50
9 10 9 10 18.1700 10.50 9.50
10 10 10 10 19.1600 10.50 10.50
10 10 10 10 19.1700 10.50 10.50
10 10 10 10 19.1800 10.50 10.50

[NB: El archivo de prueba de la tabla binaria FITS test.ev, así como la imagen de FITS test.fits, son
contenido en el directorio funtest funtools.]

Cuando se muestra una tabla usando fundir, se puede utilizar un segundo argumento opcional para
especificar las columnas que se mostrarán. Por ejemplo:

[sh] fundisp "test.ev [time- (int) time> =. 99]" ​​"xy time"
HORA XY
-------- -------- ---------------------
5 -6 40.99000000
4 -5 59.99000000
-1 0 154.99000000
-2 1 168.99000000
-3 2 183.99000000
-4 3 199.99000000
-5 4 216.99000000
-6 5 234.99000000
-7 6 253.99000000

La columna especial $ REGIÓN se puede especificar para mostrar el ID de región de cada fila:

[sh $] fundisp "test.ev [time- (int) time> =. 99 && annulus (0 0 0 10 n = 3)]" 'xy time $ REGION'
REGIÓN DE TIEMPO XY
-------- -------- --------------------- ----------
5 -6 40.99000000 3
4 -5 59.99000000 2
-1 0 154.99000000 1
-2 1 168.99000000 1
-3 2 183.99000000 2
-4 3 199.99000000 2
-5 4 216.99000000 2
-6 5 234.99000000 3
-7 6 253.99000000 3

Aquí solo filas con el tiempo fraccionario adecuado y cuya posición también está dentro de uno de
se muestran los tres anillos.

Las columnas se pueden excluir de la visualización mediante un signo menos antes de la columna:

[sh $] fundisp "test.ev [time- (int) time> =. 99]" ​​"-time"
XY PHA PI DX DY
-------- -------- -------- ---------- ----------- ----- ------
5-6 5-6 5.50-6.50
4-5 4-5 4.50-5.50
-1 0-1 0 -1.50 0.50
-2 1-2 1 -2.50 1.50
-3 2-3 2 -3.50 2.50
-4 3-4 3 -4.50 3.50
-5 4-5 4 -5.50 4.50
-6 5-6 5 -6.50 5.50
-7 6-7 6 -7.50 6.50

Se muestran todas las columnas excepto la columna de tiempo.

La columna especial $N se puede especificar para mostrar el valor ordinal de cada fila. Por lo tanto,
continuando con el ejemplo anterior:

fundisp "test.ev [time- (int) time> =. 99]" ​​'-time $ n'
XY PHA PI DX DY N
------- -------- -------- ---------- ----------- ------ ----- ----------
5-6 5-6 5.50-6.50 337
4-5 4-5 4.50-5.50 356
-1 0-1 0 -1.50 0.50 451
-2 1-2 1 -2.50 1.50 465
-3 2-3 2 -3.50 2.50 480
-4 3-4 3 -4.50 3.50 496
-5 4-5 4 -5.50 4.50 513
-6 5-6 5 -6.50 5.50 531
-7 6-7 6 -7.50 6.50 550

Tenga en cuenta que la especificación de la columna se incluye entre comillas simples para proteger '$ n' desde el principio
expandido por el caparazón.

En general, las reglas para activar y desactivar columnas son:

· Si solo se especifican las columnas de exclusión, todas las columnas excepto las columnas de exclusión
ser activado.

· Si solo se especifican las columnas de inclusión, solo se activan las columnas especificadas.

· Si se especifica una combinación de columnas de inclusión y exclusión, todas menos las de exclusión
las columnas estarán activas; este último caso es ambiguo y la regla es arbitraria.

Además de especificar los nombres de las columnas de forma explícita, los símbolos especiales + y - puede ser
utilizado para activar y desactivar todos columnas. Esto es útil si desea activar el
$ REGION columna junto con todas las demás columnas. Según las reglas, la sintaxis "$ REGION"
solo activa la columna de la región y desactiva el resto. Utilice "+ $ REGION" para activar
todas las columnas, así como la columna de la región.

Si los datos que se muestran son datos de imagen (ya sea en una imagen principal FITS, una imagen FITS
extensión, o un archivo de matriz), se produce una pantalla de píxeles mxn, donde myn son los
dimensiones de la imagen. De forma predeterminada, los valores de píxeles se muestran con el mismo tipo de datos
como en el archivo. Sin embargo, para datos enteros donde los parámetros de encabezado BSCALE y BZERO son
presente, los datos se muestran como flotantes. En cualquier caso, el tipo de datos de pantalla se puede
anulado usando un segundo argumento opcional del formulario:

bitpix = n

donde n es 8,16,32, -32, -64, para unsigned char, short, int, float y double, respectivamente.

Por supuesto, corriendo fundir en cualquier cosa que no sea la imagen más pequeña por lo general resulta en una pantalla
cuyo tamaño lo hace ilegible. Por lo tanto, se puede usar la notación entre corchetes (ver más abajo) para
aplique sección y / o bloqueo a la imagen antes de generar una visualización. Por ejemplo:

[sh] fundisp "test.fits [2: 6,2: 7]" bitpix = -32
2 3 4 5 6
---------- ---------- ---------- ---------- ----------
2: 3.00 4.00 5.00 6.00 7.00
3: 4.00 5.00 6.00 7.00 8.00
4: 5.00 6.00 7.00 8.00 9.00
5: 6.00 7.00 8.00 9.00 10.00
6: 7.00 8.00 9.00 10.00 11.00
7: 8.00 9.00 10.00 11.00 12.00

Tenga en cuenta que es posible mostrar una tabla binaria FITS como una imagen simplemente pasando el
mesa a través imagen divertida primero:

[sh] ./funimage test.ev stdout ⎪ fundisp "stdin [2: 6,2: 7]" bitpix = 8
2 3 4 5 6
------- ------- ------- ------- -------
2: 3 4 5 6 7
3: 4 5 6 7 8
4: 5 6 7 8 9
5: 6 7 8 9 10
6: 7 8 9 10 11
7: 8 9 10 11 12

Si -l (lista) se utiliza el interruptor, luego se muestra una imagen como una lista que contiene el
columnas: X, Y, VAL. Por ejemplo:

fundisp -l "test1.fits [2: 6,2: 7]" bitpix = -32
XY VAL
---------- ---------- -----------
2 2 6.00
3 2 1.00
4 2 1.00
5 2 1.00
6 2 1.00
2 3 1.00
3 3 5.00
4 3 1.00
5 3 1.00
6 3 1.00
2 4 1.00
3 4 1.00
4 4 4.00
5 4 1.00
6 4 1.00
2 5 1.00
3 5 1.00
4 5 1.00
5 5 3.00
6 5 1.00
2 6 1.00
3 6 1.00
4 6 1.00
5 6 1.00
6 6 2.00
2 7 1.00
3 7 1.00
4 7 1.00
5 7 1.00
6 7 1.00

Si -n (nohead) se utiliza el modificador, entonces no se emite ningún encabezado para las tablas. Esto es útil,
por ejemplo, cuando la salida de fundisp se dirige a gnuplot.

El fundir El programa utiliza un conjunto predeterminado de formatos de visualización:

tipo de datos formato TFORM
-------- ----- --------
doble D "% 21.8f"
flotador E "% 11.2f"
int J "% 10d"
corto I "% 8d"
byte B "% 6d"
cadena A "% 12.12s"
bits X "% 8x"
L lógica "% 1x"

Por lo tanto, la visualización predeterminada de 1 doble y 2 cortos da:

[sh] fundisp snr.ev "hora xy"

HORA XY
------------ -------- --------
79494546.56818075 546 201
79488769.94469175 548 201
...

Puede cambiar el formato de visualización para columnas individuales o para todas las columnas de un determinado
tipos de datos mediante el modificador -f. La cadena de formato que acompaña -f es un espacio-
lista delimitada de palabras clave = valores de formato. Los valores de las palabras clave pueden ser nombres de columnas.
(en cuyo caso el formato asociado pertenece solo a esa columna) o FITS tabla TFORM
especificadores (en cuyo caso el formato pertenece a todas las columnas que tienen ese tipo de datos). Para
Por ejemplo, puede cambiar los formatos doble y corto para todas las columnas de esta manera:

[sh] fundisp -f "D =% 22.11f I =% 3d" snr.ev "tiempo xy"

HORA XY
------------------------------------- --- ---
79494546.56818075478 546 201
79488769.94469174743 548 201
...

Alternativamente, puede cambiar el formato de la hora y las columnas x de esta manera:

[sh] fundisp -f "tiempo =% 22.11fx =% 3d" snr.ev "tiempo xy"

HORA XY
------------------------
79494546.56818075478 546 201
79488769.94469174743 548 201
...

Tenga en cuenta que existe un conflicto potencial si una columna tiene el mismo nombre que una de las TFORM
especificadores. En los ejemplos anteriores, la columna "X" de la tabla tiene el mismo nombre que
el tipo de datos X (bit). Para resolver este conflicto, la cadena de formato se procesa de manera que
Los especificadores de tipos de datos TFORM se comprueban primero mediante una comparación que distingue entre mayúsculas y minúsculas. Si el
El valor de formato especificado no es un valor TFORM en mayúsculas, entonces una verificación que no distingue entre mayúsculas y minúsculas es
realizado en el nombre de la columna. Esto significa que, en los ejemplos anteriores, "X =% 3d" se referirá a
el tipo de datos X (bit), mientras que "x =% 3d" se referirá a la columna X:

[sh] fundisp -f "X =% 3d" snr.ev "xy"

XY
-------- --------
546 201
548 201
...

[sh] fundisp -f "x =% 3d" snr.ev "xy"

XY
--- --------
546 201
548 201
...

Por lo tanto, como regla general, es mejor especificar siempre el nombre de la columna en minúsculas y TFORM.
tipos de datos en mayúsculas.

El -f [formato] cambiará el formato para una única ejecución de fundisp. También puedes usar
las FUN_FORMATO variable de entorno para cambiar el formato de todas las invocaciones de fundisp.
El formato del valor de esta variable de entorno es idéntico al utilizado con el -f
cambiar. Este valor global se puede anular en casos individuales mediante el uso de la -f [formato]
interruptor.

Advertencias: tenga en cuenta también que es responsabilidad del usuario hacer coincidir el formato
especificador al tipo de datos de la columna correctamente. También tenga en cuenta que, para mantener visual
alineación entre nombres y columnas, el nombre de la columna se truncará (a la izquierda) si
el ancho del formato es menor que la longitud del nombre. Sin embargo, no se realiza el truncamiento
si la salida está en formato RDB (usando el modificador -T).

[Se admite una cadena de formato de estilo antiguo, pero está obsoleta. Consiste en delimitado por espacios
Declaraciones en formato C para todos los tipos de datos, especificados en el siguiente orden:

bit de cadena de bytes cortos double float int.

Este orden de la lista se basa en la suposición de que la gente generalmente querrá
cambiar los formatos flotantes.

Si se ingresa "-" en lugar de una instrucción de formato para un tipo de datos dado, el formato predeterminado
se utiliza. Además, la cadena de formato se puede terminar sin especificar todos los formatos, y
los valores predeterminados se utilizarán para el resto de la lista. Tenga en cuenta que debe proporcionar un campo mínimo
ancho, es decir, "% 6d" y "% -6d" son legales, "% d" no lo es.

Al usar -f [formato], puede cambiar los formatos doble y corto de esta manera:

[sh] fundisp -f "22.11f - - 3d" snr.ev "tiempo xy"

HORA XY
------------------------------------- --- ---
79494546.56818075478 546 201
79488769.94469174743 548 201
...

NB: este formato está obsoleto y se eliminará en una versión futura.]

El -F [c] El modificador se puede utilizar para especificar un separador de columna (de un solo carácter) (donde el
por defecto es un espacio). Tenga en cuenta que es casi seguro que el formato de columna también agregará espacios a
rellenar columnas individuales al ancho requerido. Estos se pueden eliminar con un programa como
sed, a costa de generar columnas no alineadas. Por ejemplo:

fundisp -F ',' snr.ev '[cir 512 512 .1]'
X, Y, PHA, PI, HORA, DX, DY
512, 512, 6, 7, 79493997.45854475, 578, 574
512, 512, 8, 9, 79494575.58943175, 579, 573
512, 512, 5, 6, 79493631.03866175, 578, 575
512, 512, 5, 5, 79493290.86521725, 578, 575
512, 512, 8, 9, 79493432.00990875, 579, 573

fundisp -F ',' snr.ev '[cir 512 512 .1]' ⎪ sed 's / *, * /, / g'
X, Y, PHA, PI, HORA, DX, DY
512,512,6,7,79493997.45854475,578,574
512,512,8,9,79494575.58943175,579,573
512,512,5,6,79493631.03866175,578,575
512,512,5,5,79493290.86521725,578,575
512,512,8,9,79493432.00990875,579,573

fundisp -f "x =% 3d y =% 3d pi =% 1d pha =% 1d time =% 20.11f dx =% 3d dy =% 3d" -F ',' snr.ev '[cir 512
512 .1] '⎪ sed' s / *, * /, / g '
X, Y, A, I, HORA, DX, DY ---, ---, -, -, --------------------, ---, ---
512,512,6,7,79493997.45854474604,578,574 512,512,8,9,79494575.58943174779,579,573
512,512,5,6,79493631.03866174817,578,575 512,512,5,5,79493290.86521725357,578,575
512,512,8,9,79493432.00990875065,579,573

Si -T (tabla rdb) se utiliza el interruptor, la salida se ajustará a la base de datos starbase / rdb
formato: las pestañas se insertarán entre columnas en lugar de espacios. Este formato no es
disponible cuando se muestran los píxeles de la imagen (excepto en -l cambiar).

Finalmente, tenga en cuenta que fundir se puede utilizar para crear filtros de columna a partir de las tablas auxiliares
en un archivo FITS. Por ejemplo, el siguiente código de shell generará un intervalo de tiempo adecuado
(GTI) filtro para archivos de datos de rayos X que contienen una extensión GTI estándar:

#!/ Bin / sh
sed '1, / ----. * / d
/ ^ $ /, $ d '⎪ awk' tot> 0 {printf "⎪⎪"}; {printf "time =" $ 1 ":" $ 2; tot ++} '

Si este script se coloca en un archivo llamado "mkgti", se puede usar en un comando como:

fundisp foo.fits "[GTI]" ⎪ mkgti> gti.filter

El archivo de filtro resultante se puede utilizar en varios programas de funtools:

funcnts foo.fits "[@ gti.filter]" ...

para procesar solo los eventos en los intervalos de tiempo bueno.

Utilice fundisp en línea utilizando los servicios de onworks.net