funddisp - Online nel cloud

PROGRAMMA:

NOME

fundisp - mostra i dati in un file di dati di Funtools

SINOSSI

fondi [-f formato] [-l] [-n] [-T] [colonne⎪bitpix=n]

VERSIONI

-f # stringa di formato per la visualizzazione
-l # visualizza l'immagine come un elenco contenente le colonne X, Y, VAL
-n # non emette l'intestazione
-F [c] # usa il carattere specificato come separatore di colonna (def: spazio)
-T # output in formato rdb/starbase (separatori di tabulazione)

DESCRIZIONE

fondi visualizza i dati nell'estensione FITS specificata e/o nella sezione immagine di un FITS
file o in una sezione di un array non FITS o in un file di eventi non elaborato.

Il primo argomento del programma specifica l'immagine di input FITS, l'array o il file evento non elaborato
da visualizzare. Se viene specificato "stdin", i dati vengono letti dallo standard input. Usa Funtools
Notazione tra parentesi per specificare estensioni FITS, sezioni di immagini e filtri.

Se i dati visualizzati sono colonne (in una tabella binaria FITS o in un evento grezzo
file), vengono elencate le singole righe. I filtri possono essere aggiunti utilizzando la notazione tra parentesi. Così:

[sh] fundisp "test.ev[time-(int)time>.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: il file di test della tabella binaria FITS test.ev, così come l'immagine FITS test.fits, sono
contenuto nella directory funtests funtest.]

Quando viene visualizzata una tabella utilizzando fondi, un secondo argomento opzionale può essere usato per
specificare le colonne da visualizzare. Per esempio:

[sh] fundisp "test.ev[time-(int)time>=.99]" "xy time"
XY TEMPO
-------- -------- -------
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 rubrica speciale $REGIONE può essere specificato per visualizzare l'id della regione di ogni riga:

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

Qui solo le righe con il tempo frazionario proprio e la cui posizione è anche all'interno di uno di
vengono visualizzati i tre anelli.

Le colonne possono essere escluse dalla visualizzazione utilizzando un segno meno prima della colonna:

[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

Vengono visualizzate tutte le colonne eccetto la colonna dell'ora.

La rubrica speciale $N può essere specificato per visualizzare il valore ordinale di ogni riga. Così,
continuando l'esempio precedente:

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

Nota che la specifica della colonna è racchiusa tra virgolette singole per proteggere '$n' dall'inizio
espanso dal guscio.

In generale, le regole per l'attivazione e la disattivazione delle colonne sono:

· Se vengono specificate solo colonne di esclusione, tutte le colonne tranne le colonne di esclusione lo faranno
essere attivato.

· Se vengono specificate solo colonne di inclusione, vengono attivate solo le colonne specificate.

· Se viene specificata una combinazione di colonne di inclusione ed esclusione, allora tutte tranne l'esclusione
le colonne saranno attive; quest'ultimo caso è ambiguo e la regola è arbitraria.

Oltre a specificare esplicitamente i nomi delle colonne, i simboli speciali + ed - può essere
utilizzato per attivare e disattivare contro tutti i colonne. Questo è utile se vuoi attivare il
$REGION insieme a tutte le altre colonne. Secondo le regole, la sintassi "$REGION"
attiva solo la colonna della regione e disattiva il resto. Usa "+ $REGIONE" per attivare
tutte le colonne e la colonna della regione.

Se i dati visualizzati sono dati di immagine (in un'immagine primaria FITS, un'immagine FITS
estensione, o un file array), viene prodotto un display mxn pixel, dove m e n sono i
dimensioni dell'immagine. Per impostazione predefinita, i valori dei pixel vengono visualizzati utilizzando lo stesso tipo di dati
come nel file. Tuttavia, per i dati interi in cui i parametri di intestazione BSCALE e BZERO sono
presente, i dati vengono visualizzati come float. In entrambi i casi, il tipo di dati di visualizzazione può essere
sovrascritto utilizzando un secondo argomento facoltativo del modulo:

bitpix = n

dove n è 8,16,32,-32,-64, rispettivamente per unsigned char, short, int, float e double.

Certo, correndo fondi su qualsiasi cosa tranne l'immagine più piccola di solito si traduce in un display
le cui dimensioni lo rendono illeggibile. Pertanto, si può usare la notazione tra parentesi (vedi sotto) per
applicare sezioni e/o blocchi all'immagine prima di generare una visualizzazione. Per esempio:

[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:XNUMX XNUMX:XNUMX XNUMX:XNUMX
3: 4.00:5.00 6.00:7.00 8.00:XNUMX XNUMX:XNUMX XNUMX:XNUMX
4: 5.00:6.00 7.00:8.00 9.00:XNUMX XNUMX:XNUMX XNUMX:XNUMX
5: 6.00:7.00 8.00:9.00 10.00:XNUMX XNUMX:XNUMX XNUMX:XNUMX
6: 7.00:8.00 9.00:10.00 11.00:XNUMX XNUMX:XNUMX XNUMX:XNUMX
7: 8.00:9.00 10.00:11.00 12.00:XNUMX XNUMX:XNUMX XNUMX:XNUMX

Nota che è possibile visualizzare una tabella binaria FITS come immagine semplicemente passando il tasto
tabella attraverso immagine divertente primo:

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

Se l' -l (elenco) viene utilizzato l'interruttore, quindi viene visualizzata un'immagine come un elenco contenente il
colonne: X, Y, VAL. Per esempio:

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

Se l' -n (nohead) viene utilizzato, quindi non viene emessa alcuna intestazione per le tabelle. Questo è utile,
per esempio, quando l'output di fundisp viene diretto a gnuplot.

I fondi programma utilizza un set predefinito di formati di visualizzazione:

tipo di dati formato TFORM
-------- ----- --------
doppia D "%21.8f"
float E "%11.2f"
intJ "%10d"
breve I "%8d"
byte B "%6d"
stringa A "%12.12s"
bit X "%8x"
L logico "%1x"

Pertanto, la visualizzazione predefinita di 1 doppio e 2 pantaloncini fornisce:

[sh] fundisp snr.ev "time xy"

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

È possibile modificare il formato di visualizzazione per singole colonne o per tutte le colonne di un dato
tipi di dati tramite l'opzione -f. La stringa di formato che accompagna -f è uno spazio-
elenco delimitato di valori keyword=format. I valori delle parole chiave possono essere nomi di colonna
(nel qual caso il formato associato riguarda solo quella colonna) o la tabella FITS TFORM
specificatori (nel qual caso il formato riguarda tutte le colonne con quel tipo di dati). Per
ad esempio, puoi modificare i formati double e short per tutte le colonne in questo modo:

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

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

In alternativa, puoi modificare il formato dell'ora e x colonne in questo modo:

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

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

Nota che c'è un potenziale conflitto se una colonna ha lo stesso nome di una delle TFORM
specificatori. Negli esempi sopra, la colonna "X" nella tabella ha lo stesso nome di
il tipo di dati X (bit). Per risolvere questo conflitto, la stringa di formato viene elaborata in modo tale che
Gli identificatori del tipo di dati TFORM vengono controllati per primi, utilizzando un confronto con distinzione tra maiuscole e minuscole. Se la
il valore di formato specificato non è un valore TFORM maiuscolo, quindi un controllo senza distinzione tra maiuscole e minuscole è
fatto sul nome della colonna. Ciò significa che, negli esempi precedenti, "X=%3d" farà riferimento a
il tipo di dati X (bit), mentre "x=%3d" farà riferimento alla colonna 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
...

Di norma, quindi, è sempre meglio specificare il nome della colonna in minuscolo e TFORM
tipi di dati in maiuscolo.

I -f [formato] cambierà il formato per una singola esecuzione di fundisp. Puoi anche usare
, il FUN_FORMATO variabile di ambiente per modificare il formato per tutte le chiamate di fundisp.
Il formato del valore di questa variabile d'ambiente è identico a quello usato con il -f
interruttore. Questo valore globale può essere sovrascritto in singoli casi mediante l'uso del -f [formato]
interruttore.

Avvertenze: si prega inoltre di notare che è responsabilità dell'utente far corrispondere il formato
specificatore correttamente al tipo di dati della colonna. Si noti inoltre che, al fine di mantenere la visuale
allineamento tra nomi e colonne, il nome della colonna verrà troncato (a sinistra) se
la larghezza del formato è inferiore alla lunghezza del nome. Tuttavia, il troncamento non viene eseguito
se l'output è in formato RDB (usando l'opzione -T).

[Una stringa di formato precedente è supportata ma deprecata. Si compone di spazio delimitato
Istruzioni in formato C per tutti i tipi di dati, specificati nel seguente ordine:

double float int bit stringa di byte breve.

Questo ordine dell'elenco si basa sul presupposto che le persone generalmente vorranno farlo
modificare i formati float.

Se viene immesso "-" invece di un'istruzione di formato per un dato tipo di dati, il formato predefinito
viene utilizzato. Inoltre, la stringa di formato può essere terminata senza specificare tutti i formati e
le impostazioni predefinite verranno utilizzate per il resto dell'elenco. Nota che devi fornire un campo minimo
larghezza, cioè "%6d" e "%-6d" sono legali, "%d" non è legale.

Usando -f [formato], puoi cambiare i formati doppio e corto in questo modo:

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

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

NB: questo formato è deprecato e verrà rimosso in una versione futura.]

I -F[c] può essere usato per specificare un separatore di colonna (a un carattere) (dove
l'impostazione predefinita è uno spazio). Nota che la formattazione delle colonne quasi certamente aggiungerà anche spazi a
riempire le singole colonne alla larghezza richiesta. Questi possono essere rimossi con un programma come
sed, al costo di generare colonne non allineate. Per esempio:

fundisp -F',' snr.ev'[cir 512 512 .1]'
X, Y, PHA, PI, TEMPO, 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,TEMPO,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,TIME,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

Se l' -T (rdb table), l'output sarà conforme al database starbase/rdb
formato: le tabulazioni verranno inserite tra le colonne anziché tra gli spazi. Questo formato non è
disponibile quando si visualizzano i pixel dell'immagine (tranne in combinazione con il -l interruttore).

Infine, nota quello fondi può essere utilizzato per creare filtri di colonna dalle tabelle ausiliarie
in un file FITS. Ad esempio, il seguente codice shell genererà un intervallo di tempo utile
(GTI) filtro per file di dati a raggi X che contengono un'estensione GTI standard:

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

Se questo script viene inserito in un file chiamato "mkgti", può essere utilizzato in un comando come:

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

Il file di filtro risultante può quindi essere utilizzato in vari programmi funtools:

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

elaborare solo gli eventi negli intervalli di buon tempo.

Utilizzare fundisp online utilizzando i servizi onworks.net