funtable - Online en la nube

PROGRAMA:

NOMBRE

funtable: copia las filas seleccionadas de un archivo Funtools a una tabla binaria FITS

SINOPSIS

divertido [-a] [-i⎪-z] [-m] [-s cols] [columnas]

CAMPUS

-a # agregar al archivo de salida existente como una extensión de tabla
-i # para datos de imagen, solo genera columnas X e Y
-m # para tablas, escriba un archivo separado para cada región
-s "col1 ..." # columnas en las que ordenar
-z # para datos de imagen, salida de píxeles de valor cero

DESCRIPCIÓN

divertido selecciona filas de la extensión FITS especificada (solo tabla binaria) de un FITS
o desde un archivo de eventos sin formato que no sea FITS, y escribe esas filas en una tabla binaria FITS
expediente. También creará una tabla binaria FITS a partir de una imagen o un archivo de matriz sin formato.

El primer argumento del programa especifica el archivo FITS, el archivo de eventos sin formato o la matriz sin formato.
expediente. Si se especifica "stdin", los datos se leen desde la entrada estándar. Utilice Funtools
Notación entre corchetes para especificar extensiones y filtros FITS. El segundo argumento es el
archivo de salida FITS. Si se especifica "stdout", la tabla binaria FITS se escribe en el
salida estándar. De forma predeterminada, todas las columnas del archivo de entrada se copian en el archivo de salida.
Las columnas seleccionadas se pueden generar utilizando un tercer argumento opcional en el formulario:

"columna1 columna1 ... columnaN"

El divertido El programa generalmente se usa para seleccionar filas de una tabla binaria FITS usando Table
Filtros y / o filtros de región espacial. Por ejemplo, puede copiar solo las filas seleccionadas (y
generar solo columnas seleccionadas) ejecutando un comando como:

[sh] funtable "test.ev [pha == 1 && pi == 10]" stdout "xy pi pha" ⎪ fundisp stdin
XY PHA PI
------- ------- ------- ---------
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10
1 10 1 10

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

[sh $] funtable "test.ev [time- (int) time> =. 99 && annulus (0 0 0 10 n = 3)]" stdout 'xy time $ REGION' ⎪ fundisp stdin
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
los tres anillos están escritos.

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

[sh $] funtable "test.ev [time- (int) time> =. 99]" ​​stdout "-time" ⎪ fundisp stdin
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 escriben todas las columnas excepto la columna de tiempo.

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.

Normalmente, solo la tabla seleccionada se copia en el archivo de salida. En una tabla binaria FITS,
a veces es deseable copiar todas las demás extensiones FITS al archivo de salida como
bien. Esto se puede hacer agregando un signo '+' al nombre de la extensión en la entrada
nombre del archivo. Por ejemplo, el primer comando a continuación copia solo la tabla EVENT, mientras que el
El segundo comando también copia otras extensiones:

[sh] funtable "/proj/rd/data/snr.ev[EVENTS]" events.ev
[sh] funtable "/proj/rd/data/snr.ev[EVENTS+]" eventsandmore.ev

Si el archivo de entrada es una imagen o un archivo de matriz sin formato, entonces divertido generará un FITS
tabla binaria de los valores de píxeles en la imagen. Tenga en cuenta que no es posible especificar
las columnas a generar (usando el argumento 3 de la línea de comandos). En cambio, hay dos formas de
cree una tabla binaria de este tipo a partir de una imagen. De forma predeterminada, se genera una tabla de 3 columnas, donde
las columnas son "X", "Y" y "VALOR". Para cada píxel de la imagen, una sola fila (evento)
se genera con las columnas "X" e "Y" asignadas a los valores dim1 y dim2 de la imagen
píxel, respectivamente, y la columna "VALOR" asignó el valor del píxel. Con una especie de
mesa, corriendo divertido en la columna "VALOR" dará los mismos resultados que ejecutar divertido
en la imagen original.

Si -i (filas "individuales") se especifica el interruptor, entonces solo las columnas "X" e "Y" son
generado. En este caso, cada valor de píxel positivo en la imagen genera n filas (eventos),
donde n es igual al valor entero de ese píxel (más 0.5, para coma flotante
datos). En efecto, -i recrea aproximadamente las filas de una tabla que habría sido
agrupados en la imagen de entrada. (Por supuesto, esto es solo aproximadamente correcto, ya que el
las posiciones x, y resultantes son números enteros).

Si -s [col1 col2 ... colón] ("sort") se especifica el interruptor, las filas de salida de un binario
La tabla se ordenará utilizando las columnas especificadas como claves de clasificación. Las claves de clasificación deben ser
columnas escalares y también debe ser parte del archivo de salida (es decir, no puede ordenar en una columna
pero no incluirlo en la salida). Esta instalación utiliza el _clasificar programa (incluido con
funtools), que debe ser accesible a través de su ruta.

Para tablas binarias, el -m ("varios archivos") generará un archivo independiente para cada
región en la especificación del filtro, es decir, cada archivo contiene solo las filas de esa región.
Las filas que pasan el filtro pero que no están en ninguna región también se colocan en un archivo separado.

Los nombres de archivos de salida separados generados por el -m interruptor se producen automáticamente a partir de
el archivo de salida raíz para contener el ID de región de la región asociada. (Tenga en cuenta que la región
Los identificadores comienzan en 1, por lo que el nombre de archivo asociado con el identificador 0 contiene filas que pasan el
filtro pero no están en una región determinada.) Los nombres de los archivos de salida se generan de la siguiente manera:

· Se puede utilizar una especificación $ n en cualquier lugar del nombre del archivo raíz (citado adecuadamente para
protegerlo de la cáscara) y se ampliará para ser el número de identificación del asociado
región. Por ejemplo:

funtable -m input.fits '[cir (512,512,1); cir (520,520,1) ...]' 'foo.goo_ $ n.fits'

generará archivos llamados foo.goo_0.fits (para filas que no están en ninguna región pero que siguen pasando
el filtro), foo.goo_1.fits (filas en el id. de región # 1, la primera región), foo.goo_2.fits
(filas en el id. de región n. ° 2), etc. Tenga en cuenta que se requieren comillas simples en la raíz de salida
para proteger el '$' del caparazón.

· Si no se especifica $ n, la identificación de la región se colocará antes del primer punto (.) En
el nombre del archivo. Por lo tanto:

funtable -m input.fits '[cir (512,512,1); cir (520,520,1) ...]' foo.evt.fits

generará archivos llamados foo0.evt.fits (para filas que no están en ninguna región pero que siguen pasando
el filtro), foo1.evt.fits (filas en id de región # 1), foo2.evt.fits (filas en id de región
# 2), etc.

· Si no se especifica ningún punto en el nombre del archivo de salida raíz, entonces la identificación de la región será
añadido al nombre del archivo. Por lo tanto:

funtable -m input.fits '[cir (512,512,1); cir (520,520,1) ...]' 'foo_evt'

generará archivos denominados foo_evt0 (para filas que no están en ninguna región pero que siguen pasando el
filter), foo_evt1 (filas en el id. de región n. ° 1), foo_evt2 (filas en id. de región n. ° 2), etc.

El mecanismo de archivos múltiples proporciona una forma sencilla de generar archivos de datos de origen individuales
con una sola pasada a través de los datos.

De forma predeterminada, se crea un nuevo archivo FITS y la tabla binaria se escribe en el primer
extensión. Si el -a (agregar) se especifica el modificador, la tabla se agrega a un
FITS archivo como una extensión BINTABLE. Tenga en cuenta que el archivo FITS de salida ya debe existir.

Si -z (valores de píxeles "cero") se especifica el interruptor y -i no se especifica, entonces píxeles
que tenga un valor cero se emitirá con su columna "VALOR" establecida en cero. Obviamente, esto
El cambio no tiene sentido cuando se emiten eventos individuales.

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