funtable - Online nel cloud

PROGRAMMA:

NOME

funtable - copia le righe selezionate da un file Funtools in una tabella binaria FITS

SINOSSI

divertente [-a] [-i⎪-z] [-m] [-s cols] [colonne]

VERSIONI

-a # aggiunge al file di output esistente come estensione di tabella
-i # per i dati immagine, genera solo colonne X e Y
-m # per le tabelle, scrive un file separato per ogni regione
-s "col1 ..." # colonne su cui ordinare
-z # per i dati dell'immagine, emette pixel con valore zero

DESCRIZIONE

divertente seleziona le righe dall'estensione FITS specificata (solo tabella binaria) di un FITS
file o da un file di eventi raw non FITS e scrive quelle righe in una tabella binaria FITS
file. Creerà anche una tabella binaria FITS da un'immagine o da un file array non elaborato.

Il primo argomento del programma specifica il file FITS, il file evento non elaborato o l'array non elaborato
file. Se viene specificato "stdin", i dati vengono letti dallo standard input. Usa Funtools
Notazione tra parentesi per specificare estensioni e filtri FITS. Il secondo argomento è il
file FITS di output. Se viene specificato "stdout", la tabella binaria FITS viene scritta nel
uscita standard. Per impostazione predefinita, tutte le colonne del file di input vengono copiate nel file di output.
Le colonne selezionate possono essere emesse utilizzando un terzo argomento facoltativo nel modulo:

"colonna1 colonna1 ... colonnaN"

I divertente il programma viene generalmente utilizzato per selezionare righe da una tabella binaria FITS utilizzando Table
Filtri e/o filtri di regione spaziale. Ad esempio, puoi copiare solo le righe selezionate (e
output solo colonne selezionate) eseguendo un comando come:

[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 rubrica speciale $REGIONE può essere specificato per scrivere l'id della regione di ogni riga:

[sh $] funtable "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" stdout 'xy time $REGION' ⎪ fundisp stdin
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
si scrivono i tre annuli.

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

[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

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

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.

Normalmente, solo la tabella selezionata viene copiata nel file di output. In una tabella binaria FITS,
a volte è desiderabile copiare tutte le altre estensioni FITS nel file di output come
bene. Questo può essere fatto aggiungendo un segno '+' al nome dell'estensione nell'input
nome del file. Ad esempio, il primo comando sotto copia solo la tabella EVENT, mentre il
secondo comando copia anche altre estensioni:

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

Se il file di input è un'immagine o un file array non elaborato, allora divertente genererà un FITS
tabella binaria dai valori dei pixel nell'immagine. Si noti che non è possibile specificare
le colonne per l'output (usando l'argomento della riga di comando 3). Invece, ci sono due modi per
creare una tale tabella binaria da un'immagine. Per impostazione predefinita, viene generata una tabella a 3 colonne, dove
le colonne sono "X", "Y" e "VALORE". Per ogni pixel dell'immagine, una singola riga (evento)
viene generato con le colonne "X" e "Y" assegnate ai valori dim1 e dim2 dell'immagine
pixel, rispettivamente e la colonna "VALUE" ha assegnato il valore del pixel. Con una specie di
tavolo, corsa funhista nella colonna "VALORE" darà gli stessi risultati della corsa funhista
sull'immagine originale.

Se l' -i (righe "individuali") è specificato, quindi solo le colonne "X" e "Y" sono
generato. In questo caso, ogni valore di pixel positivo nell'immagine genera n righe (eventi),
dove n è uguale al valore intero di quel pixel (più 0.5, per virgola mobile
dati). In effetti, -i ricrea approssimativamente le righe di una tabella che sarebbe stata
bin nell'immagine di input. (Naturalmente, questo è solo approssimativamente corretto, poiché il
le posizioni x,y risultanti sono intere.)

Se l' -s [col1 col2 ... colonna] ("sort") è specificato l'interruttore, le righe di output di un binario
la tabella verrà ordinata utilizzando le colonne specificate come chiavi di ordinamento. Le chiavi di ordinamento devono essere
colonne scalari e deve anche far parte del file di output (cioè non puoi ordinare su una colonna
ma non includerlo nell'output). Questa struttura utilizza il _ordinare programma (incluso con
funtools), che deve essere accessibile tramite il tuo percorso.

Per le tabelle binarie, il -m ("più file") genererà un file separato per ciascuno
regione nella specifica del filtro, cioè ogni file contiene solo le righe di quella regione.
Anche le righe che passano il filtro ma non si trovano in nessuna regione vengono inserite in un file separato.

I nomi dei file di output separati generati dal -m l'interruttore è prodotto automaticamente da
il file di output root per contenere l'ID regione della regione associata. (Nota che regione
gli id ​​iniziano da 1, in modo che il nome del file associato all'id 0 ​​contenga righe che passano il
filtro ma non si trovano in una determinata regione.) I nomi dei file di output vengono generati come segue:

· Una specifica $n può essere usata ovunque nel nome del file radice (opportunamente citato come
proteggerlo dalla shell) e sarà espanso per essere il numero id dell'associato
regione. Per esempio:

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

genererà file denominati foo.goo_0.fits (per le righe non in nessuna regione ma ancora di passaggio
il filtro), foo.goo_1.fits (righe nell'ID regione n. 1, la prima regione), foo.goo_2.fits
(righe nell'ID regione #2), ecc. Nota che sono necessarie le virgolette singole nella radice di output
per proteggere il '$' dalla shell.

· Se $n non è specificato, l'id della regione verrà posizionato prima del primo punto (.) in
il nome del file. Così:

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

genererà file denominati foo0.evt.fits (per le righe non in nessuna regione ma ancora di passaggio
il filtro), foo1.evt.fits (righe nell'id regione #1), foo2.evt.fits (righe nell'id regione
#2), ecc.

· Se non viene specificato alcun punto nel nome del file di output principale, l'id della regione sarà
aggiunto al nome del file. Così:

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

genererà file denominati foo_evt0 (per le righe che non si trovano in nessuna regione ma che continuano a passare il
filter), foo_evt1 (righe nell'id regione #1), foo_evt2 (righe nell'id regione #2), ecc.

Il meccanismo di file multipli fornisce un modo semplice per generare singoli file di dati di origine
con un solo passaggio dei dati.

Per impostazione predefinita, viene creato un nuovo file FITS e la tabella binaria viene scritta nel primo
estensione. Se la -a (append) switch è specificato, la tabella viene aggiunta a un esistente
FITS come estensione BINTABLE. Si noti che il file FITS di output deve già esistere.

Se l' -z (valori di pixel "zero") è specificato e -i non è specificato, quindi pixel
con un valore zero verrà emesso con la loro colonna "VALORE" impostata su zero. Ovviamente questo
switch non ha senso quando vengono emessi singoli eventi.

Usa funtable online utilizzando i servizi onworks.net