funtable - En ligne dans le Cloud

PROGRAMME:

Nom

funtable - copier 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, générer uniquement les colonnes X et Y
-m # pour les tables, écrire 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
fichier, ou à partir d'un fichier d'événements bruts non FITS, et écrit ces lignes dans une table binaire FITS
fichier. 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 générées à l'aide d'un troisième argument facultatif sous la forme :

"colonne1 colonne1 ... colonneN"

Le manuel de formation table amusante le programme est généralement utilisé pour sélectionner des lignes d'une table binaire FITS à l'aide de Table
Filtres et/ou filtres de régions spatiales. 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]" sortie standard "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 chronique 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 TEMPORELLE 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'une des
les trois anneaux sont écrits.

Les colonnes peuvent être exclues de l'affichage en utilisant 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 sauf 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 seules les colonnes à inclure sont spécifiées, 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 les colonnes 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 tous colonnes. Ceci est utile si vous souhaitez activer le
La colonne $REGION ainsi que toutes les autres colonnes. Conformément aux règles, la syntaxe « $REGION »
Active uniquement la colonne « région » et désactive les autres. Utilisez « + $REGION » pour activer
toutes les colonnes ainsi que la colonne région.

En règle générale, 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
Eh 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] funtable "/proj/rd/data/snr.ev[EVENTS]" events.ev
[sh] funtable "/proj/rd/data/snr.ev[EVENTS+]" eventsandmore.ev

Si le fichier d'entrée est une image ou un fichier de tableau brut, alors table amusante générera un FITS
tableau binaire à partir des valeurs de pixels de l'image. Notez qu'il n'est pas possible de spécifier
les colonnes à afficher (en utilisant l'argument de ligne de commande 3). Il existe deux façons de
Créez un tel tableau binaire à partir d'une image. Par défaut, un tableau à trois colonnes est généré, où
Les colonnes sont « X », « Y » et « VALEUR ». Pour chaque pixel de l'image, une seule ligne (événement)
est généré avec les colonnes « X » et « Y » attribuées aux valeurs dim1 et dim2 de l'image
pixel, et la colonne « VALEUR » attribue la valeur du pixel. Avec une sorte de
table, en cours d'exécution funhiste sur la colonne « VALEUR » 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 de l'image génère n lignes (événements),
où n est égal à la valeur entière de ce pixel (plus 0.5, pour les nombres à virgule flottante)
données). En effet, -i recrée approximativement les lignes d'une table qui auraient été
intégré à l'image d'entrée. (Bien sûr, ceci n'est qu'approximativement correct, puisque le
(les positions x, y résultantes sont entierisées.)

Si la -s [col1 col2 ... [colonne] ("trier") le commutateur est spécifié, les lignes de sortie d'un binaire
Le tableau sera trié 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 l'incluez pas dans la sortie). Cette fonctionnalité utilise le _trier programme (inclus avec
funtools), qui doit être accessible via votre chemin.

Pour les tables binaires, le -m Le commutateur (« fichiers multiples ») générera un fichier distinct pour chaque
région dans la spécification du filtre, c'est-à-dire que chaque fichier contient uniquement 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 distincts générés par le -m les commutateurs sont produits automatiquement à partir de
le fichier de sortie racine contenant l'ID de région 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 contient des lignes qui passent le
(Les noms des 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 (convenablement cité pour
(protégez-le du shell) et sera étendu pour devenir le numéro d'identification de l'identifiant associé
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 quand même
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 obligatoires
pour protéger le '$' du shell.

· Si $n n'est pas spécifié, l'ID 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 quand même
le filtre), foo1.evt.fits (lignes dans la région id #1), foo2.evt.fits (lignes dans la région id
#2), etc.

· Si aucun point n'est spécifié dans le nom du fichier de sortie racine, l'ID de 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 transmettent toujours le
filtre), foo_evt1 (lignes dans l'ID de région #1), foo_evt2 (lignes dans l'ID de région #2), etc.

Le mécanisme de fichiers multiples offre un moyen simple de générer des fichiers de données sources individuels
avec un seul passage dans les données.

Par défaut, un nouveau fichier FITS est créé et la table binaire est écrite dans le premier
extension. Si le -a (append) le commutateur est spécifié, la table est ajoutée à une table existante
Fichier FITS avec extension BINTABLE. Notez que le fichier FITS de sortie doit déjà exister.

Si la -z (valeurs de pixel « zéro ») le commutateur est spécifié et -i n'est pas spécifié, alors pixels
Les valeurs nulles seront affichées avec la colonne « VALEUR » définie à zéro. Évidemment, ceci
le commutateur n'a pas de sens lorsque des événements individuels sont générés.

Utilisez Funtable en ligne grâce aux services onworks.net