funtable - En ligne dans le Cloud

PROGRAMME:

Nom

funtable - copie les lignes sélectionnées d'un fichier Funtools vers une table binaire FITS

SYNOPSIS

table amusante [-a] [-i⎪-z] [-m] [-s cols] [Colonnes]

OPTIONS

-a # ajouter au fichier de sortie existant en tant qu'extension de table
-i # pour les données d'image, ne génère que les colonnes X et Y
-m # pour les tables, écris un fichier séparé pour chaque région
-s "col1 ..." # colonnes sur lesquelles trier
-z # pour les données d'image, génère des pixels de valeur zéro

DESCRIPTION

table amusante sélectionne les lignes de l'extension FITS spécifiée (table binaire uniquement) d'un FITS
ou à partir d'un fichier d'événement brut non FITS, et écrit ces lignes dans une table binaire FITS
déposer. Il créera également une table binaire FITS à partir d'une image ou d'un fichier de tableau brut.

Le premier argument du programme spécifie le fichier FITS, le fichier d'événement brut ou le tableau brut
déposer. Si "stdin" est spécifié, les données sont lues à partir de l'entrée standard. Utiliser Funtools
Bracket Notation pour spécifier les extensions FITS et les filtres. Le deuxième argument est le
fichier FITS de sortie. Si "stdout" est spécifié, la table binaire FITS est écrite dans le
sortie standard. Par défaut, toutes les colonnes du fichier d'entrée sont copiées dans le fichier de sortie.
Les colonnes sélectionnées peuvent être affichées à l'aide d'un troisième argument facultatif sous la forme :

"colonne1 colonne1 ... colonneN"

La table amusante le programme est généralement utilisé pour sélectionner des lignes dans une table binaire FITS à l'aide de Table
Filtres et/ou Filtres de Région Spatiale. Par exemple, vous pouvez copier uniquement les lignes sélectionnées (et
afficher uniquement les colonnes sélectionnées) en exécutant une commande telle que :

[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 colonne spéciale $RÉGION peut être spécifié pour écrire l'ID de région de chaque ligne :

[sh $] funtable "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" stdout 'xy time $REGION' ⎪ fundisp stdin
RÉGION DE TEMPS 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

Ici, seules les lignes avec le temps fractionnaire approprié et dont la position est également dans l'un des
les trois anneaux sont écrits.

Les colonnes peuvent être exclues de l'affichage à l'aide d'un signe moins avant la colonne :

[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

Toutes les colonnes à l'exception de la colonne de temps sont écrites.

En général, les règles d'activation et de désactivation des colonnes sont :

· Si seules les colonnes d'exclusion sont spécifiées, toutes les colonnes sauf les colonnes d'exclusion seront
être activé.

· Si uniquement les colonnes d'inclusion sont spécifiées, alors seules les colonnes spécifiées sont activées.

· Si un mélange de colonnes d'inclusion et d'exclusion est spécifié, alors toutes sauf l'exclusion
les colonnes seront actives ; ce dernier cas est ambigu et la règle est arbitraire.

En plus de spécifier explicitement les noms de colonnes, les symboles spéciaux + et - peuvent être
utilisé pour activer et désactiver TOUTE Colonnes. Ceci est utile si vous souhaitez activer le
colonne $REGION avec toutes les autres colonnes. Selon les règles, la syntaxe "$REGION"
active uniquement la colonne région et désactive le reste. Utilisez "+ $REGION" pour activer
toutes les colonnes ainsi que la colonne de région.

Normalement, seule la table sélectionnée est copiée dans le fichier de sortie. Dans une table binaire FITS,
il est parfois souhaitable de copier toutes les autres extensions FITS dans le fichier de sortie comme
bien. Cela peut être fait en ajoutant un signe '+' au nom de l'extension dans l'entrée
nom de fichier. Par exemple, la première commande ci-dessous copie uniquement la table EVENT, tandis que la
la deuxième commande copie également d'autres extensions :

[sh] table de fonction "/proj/rd/data/snr.ev[EVENTS]" events.ev
[sh] table de fonction "/proj/rd/data/snr.ev[EVENTS+]" eventsandmore.ev

Si le fichier d'entrée est une image ou un fichier tableau brut, alors table amusante générera un FITS
table binaire à partir des valeurs de pixels dans l'image. Notez qu'il n'est pas possible de spécifier
les colonnes à afficher (en utilisant l'argument de ligne de commande 3). Au lieu de cela, il existe deux façons de
créer une telle table binaire à partir d'une image. Par défaut, un tableau à 3 colonnes est généré, où
les colonnes sont "X", "Y" et "VALUE". Pour chaque pixel de l'image, une seule ligne (événement)
est généré avec les colonnes "X" et "Y" affectées aux valeurs dim1 et dim2 de l'image
pixel, respectivement et la colonne "VALUE" a assigné la valeur du pixel. Avec une sorte de
table, courir funhiste sur la colonne "VALUE" donnera les mêmes résultats que l'exécution funhiste
sur l'image originale.

Si la -i (lignes "individuelles") est spécifié, alors seules les colonnes "X" et "Y" sont
généré. Dans ce cas, chaque valeur de pixel positive dans l'image génère n lignes (événements),
où n est égal à la valeur entière de ce pixel (plus 0.5, pour la virgule flottante
Les données). En effet, -i recrée approximativement les lignes d'un tableau qui auraient été
regroupé dans l'image d'entrée. (Bien sûr, ce n'est qu'approximativement correct, puisque le
les positions x,y résultantes sont entières.)

Si la -s [col1 col2 col] ("sort") est spécifié, les lignes de sortie d'un binaire
table sera triée en utilisant les colonnes spécifiées comme clés de tri. Les clés de tri doivent être
colonnes scalaires et doivent également faire partie du fichier de sortie (c'est-à-dire que vous ne pouvez pas trier sur une colonne
mais ne pas l'inclure dans la sortie). Cette installation utilise le _sorte programme (inclus avec
funtools), qui doit être accessible via votre chemin.

Pour les tables binaires, le -m ("plusieurs fichiers") va générer un fichier séparé pour chaque
région dans la spécification du filtre, c'est-à-dire que chaque fichier ne contient que les lignes de cette région.
Les lignes qui passent le filtre mais ne se trouvent dans aucune région sont également placées dans un fichier séparé.

Les noms de fichiers de sortie séparés générés par le -m commutateur sont produits automatiquement à partir de
le fichier de sortie racine doit contenir l'identifiant de la région associée. (Notez que la région
les identifiants commencent à 1, de sorte que le nom de fichier associé à l'identifiant 0 contienne des lignes qui passent le
filtre mais ne se trouvent dans aucune région donnée.) Les noms de fichiers de sortie sont générés comme suit :

· Une spécification $n peut être utilisée n'importe où dans le nom du fichier racine
le protéger du shell) et sera étendu pour être le numéro d'identification du
Région. Par exemple:

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

générera des fichiers nommés foo.goo_0.fits (pour les lignes qui ne se trouvent dans aucune région mais qui passent toujours
le filtre), foo.goo_1.fits (lignes dans la région id #1, la première région), foo.goo_2.fits
(lignes dans la région id #2), etc. Notez que les guillemets simples dans la racine de sortie sont requis
pour protéger le '$' du shell.

· Si $n n'est pas spécifié, alors l'identifiant de région sera placé avant le premier point (.) dans
le nom du fichier. Ainsi:

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

générera des fichiers nommés foo0.evt.fits (pour les lignes qui ne se trouvent dans aucune région mais qui passent toujours
le filtre), foo1.evt.fits (lignes dans l'identifiant de région #1), foo2.evt.fits (lignes dans l'identifiant de région
#2), etc...

· Si aucun point n'est spécifié dans le nom du fichier de sortie racine, alors l'identifiant de la région sera
ajouté au nom du fichier. Ainsi:

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

générera des fichiers nommés foo_evt0 (pour les lignes qui ne se trouvent dans aucune région mais qui passent toujours le
filter), foo_evt1 (lignes dans la région id #1), foo_evt2 (lignes dans la région id #2), etc.

Le mécanisme de fichiers multiples fournit un moyen simple de générer des fichiers de données source individuels
avec un seul passage à travers les données.

Par défaut, un nouveau fichier FITS est créé et la table binaire est écrite dans le premier
extension. Si la -a (ajouter) est spécifié, la table est ajoutée à un
FITS en tant qu'extension BINTABLE. Notez que le fichier FITS de sortie doit déjà exister.

Si la -z (valeurs de pixels "zéro") est spécifié et -i n'est pas spécifié, alors les pixels
ayant une valeur zéro sera affiché avec leur colonne "VALUE" définie sur zéro. De toute évidence, ce
commutateur n'a pas de sens lorsque des événements individuels sont générés.

Utilisez funtable en ligne en utilisant les services onworks.net