fundisp - En ligne dans le Cloud

PROGRAMME:

Nom

fundisp - affiche les données dans un fichier de données Funtools

SYNOPSIS

fonds [-f format] [-l] [-n] [-T] [colonnes⎪bitpix=n]

OPTIONS

-f # chaîne de format pour l'affichage
-l # affiche l'image sous forme de liste contenant les colonnes X, Y, VAL
-n # n'affiche pas l'en-tête
-F [c] # utilise le caractère spécifié comme séparateur de colonne (def : espace)
-T # sortie au format rdb/starbase (séparateurs de tabulation)

DESCRIPTION

fonds affiche les données dans l'extension FITS et/ou la section d'image spécifiée d'un FITS
ou dans une section d'un tableau non FITS ou d'un fichier d'événement brut.

Le premier argument du programme spécifie l'image d'entrée FITS, le tableau ou le fichier d'événement brut
afficher. 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, les sections d'image et les filtres.

Si les données affichées sont des colonnes (soit dans une table binaire FITS, soit dans un événement brut
fichier), les lignes individuelles sont répertoriées. Les filtres peuvent être ajoutés en utilisant la notation entre crochets. Ainsi:

[sh] fundisp "test.ev[time-(int)time>.15]"
XY PHA PI TEMPS 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 : Le fichier de test de la table binaire FITS test.ev, ainsi que l'image FITS test.fits, sont
contenu dans le répertoire funtools funtest.]

Lorsqu'un tableau est affiché à l'aide fonds, un deuxième argument facultatif peut être utilisé pour
spécifiez les colonnes à afficher. Par exemple:

[sh] fundisp "test.ev[time-(int)time>=.99]" "xy time"
HEURE 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 colonne spéciale $RÉGION peut être spécifié pour afficher l'ID de région de chaque ligne :

[sh $] fundisp "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" 'xy time $REGION'
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 affichés.

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

[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

Toutes les colonnes, à l'exception de la colonne de temps, sont affichées.

La colonne spéciale $N peut être spécifié pour afficher la valeur ordinale de chaque ligne. Ainsi,
en continuant l'exemple précédent :

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

Notez que la spécification de la colonne est entourée de guillemets simples pour protéger '$n' du début
élargi par la coquille.

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 + ainsi que - 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.

Si les données affichées sont des données d'image (soit dans une image primaire FITS, une image FITS
ou un fichier de tableau), un affichage de mxn pixels est produit, où m et n sont les
dimension de l'image. Par défaut, les valeurs de pixels sont affichées en utilisant le même type de données
comme dans le fichier. Cependant, pour les données entières où les paramètres d'en-tête BSCALE et BZERO sont
présent, les données sont affichées sous forme de flottants. Dans les deux cas, le type de données d'affichage peut être
remplacé à l'aide d'un deuxième argument facultatif de la forme :

bitpix=n

où n vaut 8,16,32,-32,-64, pour les caractères non signés, short, int, float et double, respectivement.

Bien sûr, courir fonds sur tout sauf la plus petite image se traduit généralement par un affichage
dont la taille le rend illisible. Par conséquent, on peut utiliser la notation entre crochets (voir ci-dessous) pour
appliquer une section et/ou un blocage à l'image avant de générer un affichage. Par exemple:

[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

Notez qu'il est possible d'afficher une table binaire FITS sous forme d'image en passant simplement le
tableau à travers image amusante premier:

[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 la -l (liste) est utilisé, puis une image s'affiche sous forme de liste contenant les
colonnes : X, Y, VAL. Par exemple:

fundisp -l "test1.fits[2:6,2:7]" bitpix=-32
VAL XY
---------- ---------- -----------
+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 la -n (nohead) est utilisé, aucun en-tête n'est généré pour les tables. C'est utile,
par exemple, lorsque la sortie de fundisp est dirigée vers gnuplot.

La fonds programme utilise un ensemble de formats d'affichage par défaut :

type de données format TFORM
-------- ----- --------
double D "%21.8f"
float E "%11.2f"
entier J "%10d"
bref je "%8d"
octet B "%6d"
chaîne A "%12.12s"
bits X "%8x"
L logique "%1x"

Ainsi, l'affichage par défaut de 1 double et 2 courts donne :

[sh] fundisp snr.ev "temps xy"

HEURE XY
----------- -------- --------
+79494546.56818075 (546)201
+79488769.94469175 (548)201


Vous pouvez modifier le format d'affichage pour des colonnes individuelles ou pour toutes les colonnes d'un
types de données au moyen du commutateur -f. La chaîne de format qui accompagne -f est un espace-
liste délimitée de mots-clés=valeurs de format. Les valeurs des mots clés peuvent être des noms de colonnes
(auquel cas le format associé n'appartient qu'à cette colonne) ou la table FITS TFORM
spécificateurs (auquel cas le format concerne toutes les colonnes ayant ce type de données). Pour
exemple, vous pouvez modifier les formats double et court pour toutes les colonnes comme ceci :

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

HEURE XY
---------------------- --- ---
+79494546.56818075478 (546)201
+79488769.94469174743 (548)201


Alternativement, vous pouvez modifier le format de l'heure et des colonnes x comme ceci :

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

HEURE XY
---------------------- --- --------
+79494546.56818075478 (546)201
+79488769.94469174743 (548)201


Notez qu'il y a un conflit potentiel si une colonne a le même nom que l'un des TFORM
spécificateurs. Dans les exemples ci-dessus, la colonne "X" du tableau porte le même nom que
le type de données X (bit). Pour résoudre ce conflit, la chaîne de format est traitée de telle sorte que
Les spécificateurs de type de données TFORM sont vérifiés en premier, en utilisant une comparaison sensible à la casse. Si la
la valeur de format spécifiée n'est pas une valeur TFORM majuscule, alors une vérification insensible à la casse est
fait sur le nom de la colonne. Cela signifie que, dans les exemples ci-dessus, "X=%3d" fera référence à
le type de données X (bit), tandis que "x=%3d" fera référence à la colonne X :

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

XY
-------- --------
+546 (201)XNUMX XNUMX
+548 (201)XNUMX XNUMX


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

XY
--- --------
+546 (201)XNUMX XNUMX
+548 (201)XNUMX XNUMX


En règle générale, il est donc préférable de toujours spécifier le nom de la colonne en minuscules et TFORM
types de données en majuscules.

La -f [format] changera le format pour une seule exécution de fundisp. Vous pouvez également utiliser
le FUN_FORMAT variable d'environnement pour changer le format de toutes les invocations de fundisp.
Le format de la valeur de cette variable d'environnement est identique à celui utilisé avec le -f
changer. Cette valeur globale peut être remplacée dans des cas individuels en utilisant le -f [format]
interrupteur.

Avertissements : Veuillez également noter qu'il est de la responsabilité de l'utilisateur de faire correspondre le format
spécificateur au type de données de la colonne correctement. Notez également que, afin de maintenir la visibilité
alignement entre les noms et les colonnes, le nom de la colonne sera tronqué (à gauche) si
la largeur du format est inférieure à la longueur du nom. Cependant, la troncature n'est pas effectuée
si la sortie est au format RDB (à l'aide du commutateur -T).

[Une chaîne de format de style plus ancien est prise en charge mais déconseillée. Il se compose d'espaces délimités
Instructions au format C pour tous les types de données, spécifiées dans l'ordre suivant :

bit de chaîne d'octets courts double float int.

Cet ordre de la liste est basé sur l'hypothèse que les gens voudront généralement
changer les formats flottants.

Si "-" est entré au lieu d'une instruction de format pour un type de données donné, le format par défaut
est utilisé. De plus, la chaîne de format peut être terminée sans spécifier tous les formats, et
les valeurs par défaut seront utilisées pour le reste de la liste. Notez que vous devez fournir un champ minimum
width, c'est-à-dire que "%6d" et "%-6d" sont légaux, "%d" n'est pas légal.

En utilisant -f [format], vous pouvez modifier les formats double et court comme ceci :

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

HEURE XY
---------------------- --- ---
+79494546.56818075478 (546)201
+79488769.94469174743 (548)201


NB : Ce format est obsolète et sera supprimé dans une prochaine version.]

La -F[c] peut être utilisé pour spécifier un séparateur de colonne (à un seul caractère) (où le
la valeur par défaut est un espace). Notez que le formatage des colonnes ajoutera presque certainement des espaces à
rembourrez les colonnes individuelles à la largeur requise. Ceux-ci peuvent être supprimés avec un programme tel que
sed, au prix de la génération de colonnes non alignées. Par exemple:

fundisp -F',' snr.ev'[cir 512 512 .1]'
X, Y, PHA, PI, TEMPS, 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,TEMPS,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]' ⎪ sed 's/ *, */,/g'
X,Y,A,I,TIME,DX,DY ---,---,-,-,--------------------,---, ---
+512,512,6,7,79493997.45854474604,578,574 (512,512,8,9,79494575.58943174779,579,573)XNUMX XNUMX
+512,512,5,6,79493631.03866174817,578,575 (512,512,5,5,79493290.86521725357,578,575)XNUMX XNUMX
512,512,8,9,79493432.00990875065,579,573

Si la -T (table rdb) est utilisé, la sortie sera conforme à la base de données starbase/rdb
format : des tabulations seront insérées entre les colonnes plutôt que des espaces. Ce format n'est pas
disponible lors de l'affichage des pixels de l'image (sauf en conjonction avec le -l changer).

Enfin, notez que fonds peut être utilisé pour créer des filtres de colonnes à partir des tables auxiliaires
dans un fichier FITS. Par exemple, le code shell suivant générera un bon intervalle de temps
Filtre (GTI) pour les fichiers de données radiographiques contenant une extension GTI standard :

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

Si ce script est placé dans un fichier nommé "mkgti", il peut être utilisé dans une commande telle que :

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

Le fichier de filtre résultant peut ensuite être utilisé dans divers programmes funtools :

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

pour ne traiter que les événements dans les bons intervalles de temps.

Utilisez fundisp en ligne en utilisant les services onworks.net