funcone - Online nel cloud

PROGRAMMA:

NOME

funcone - ricerca cono di una tabella binaria contenente colonne AR, Dec

SINOSSI

funcone [colonne]

VERSIONI

-d deccol:[hdr] # Nome colonna Dec, unità (def: DEC:d)
-j # unisce le colonne dal file di elenco
-J # unisce le colonne dal file di elenco, emette tutte le righe
-l listfile # legge centri e raggi da una lista
-L listfile # legge centri e raggi da un elenco, output delle righe dell'elenco
-n # non usa i limiti del cono come filtro
-r racol:[hdr] # nome colonna RA, unità (def: RA:h)
-x # aggiunge RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols
-X # append RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols, restituisce tutte le righe

DESCRIZIONE

Funcone esegue una ricerca a cono sulle colonne RA e Dec di una tabella binaria FITS. Il
distanza dal centro RA, posizione Dec all'AR, Dec in ogni riga della tabella è
calcolato. Vengono emesse le righe la cui distanza è inferiore al raggio specificato.

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.

Il terzo e il quarto argomento obbligatorio sono la posizione centrale di AR e Dec. Per impostazione predefinita,
RA è specificato in ore mentre Dec è specificato in gradi. È possibile modificare le unità di
uno di questi aggiungendo il carattere "d" (gradi), "h" (ore) o "r" (radianti).
È supportata la notazione sessagesimale, con due punti o spazi che separano hms e dms. (Quando
utilizzando gli spazi, assicurati che l'intera stringa sia citata.)

Il quinto argomento richiesto è il raggio della ricerca del cono. Per impostazione predefinita, il valore del raggio
è espresso in gradi. Le unità possono essere modificate aggiungendo il carattere "d" (gradi),
"r" (radianti), "'" (minuti d'arco) o '"' (secondi d'arco).

Per impostazione predefinita, tutte le colonne del file di input vengono copiate nel file di output. Colonne selezionate
può essere emesso utilizzando un sesto argomento opzionale nella forma:

"colonna1 colonna1 ... colonnaN"

Un settimo argomento consente di visualizzare le colonne selezionate dal file elenco quando -j interruttore
viene utilizzato. Si noti che le colonne AR e Dec utilizzate nel calcolo del cono non devono essere
deselezionato.

Inoltre, per impostazione predefinita, i nomi delle colonne RA e Dec sono denominati "RA" e "Dec" e sono indicati in
rispettivamente unità di ore e gradi. È possibile modificare sia il nome che le unità utilizzando
gli switch -r [RA] e/o -d [Dec]. Ancora una volta, viene aggiunto uno tra "h", "d" o "r" a
il nome della colonna per specificare le unità, ma in questo caso devono esserci due punti ":" tra i
nome e le specifiche dell'unità.

Se l' -l [elenco] viene utilizzato l'interruttore, quindi uno o più tra il centro AR, il centro Dec e
raggio può essere preso da un file di elenco (che può essere una tabella FITS o un testo di colonna ASCII
file). In questo caso, il terzo (centro AR), il quarto (centro Dec) e il quinto (raggio)
gli argomenti della riga di comando possono essere un nome di colonna nel file di elenco (se tale parametro
varia) oppure un valore numerico (se quel parametro è statico). Quando il nome di una colonna è
specificato per AR, Dec o raggio, puoi aggiungere i due punti seguiti da "h", "d" o "r"
per specificare le unità (anche ' e " per il raggio). L'algoritmo di ricerca del cono viene eseguito una volta per ciascuno
riga nell'elenco, prendendo i valori di AR, Dec e raggio dalle colonne specificate o da
valori numerici statici specificati nella riga di comando.

Quando si utilizza un elenco, tutte le righe valide di ogni iterazione vengono scritte in un singolo file di output.
Usa il -x switch per aiutare a delineare quale riga del file di elenco è stata utilizzata per produrre il
date righe di output. Questo interruttore fa sì che i valori per il centro RA, Dec, raggio e
numero di riga da aggiungere al file di output, in colonne denominate RA_CEN, DEC_CEN, RAD_CEN
e CONE_KEY, rispettivamente. In alternativa, il -j (join) lo switch aggiungerà tutte le colonne
dalla riga dell'elenco alla riga di output (essenzialmente un join della riga dell'elenco e della riga di input),
insieme al numero di riga CONE_KEY. Questi due interruttori si escludono a vicenda.

I -X ed -J gli switch scrivono gli stessi dati delle loro controparti minuscole per ciascuno
riga che soddisfa una ricerca conica. Inoltre, questi interruttori scrivono anche righe da
file di eventi che non soddisfano alcuna ricerca cono. In tali casi, quella colonna CONE_KEY sarà
verrà assegnato un valore di -1 e le informazioni sulla posizione del centro e dell'elenco verranno impostate su zero
per la riga data. Pertanto, tutte le righe del file di eventi di input sono garantite per l'output,
con righe che soddisfano almeno una ricerca a cono con informazioni di ricerca aggiuntive.

I -L l'interruttore agisce in modo simile a -l switch in quanto prende i centri da un file di elenco.
Tuttavia, imposta anche implicitamente l'opzione -j, in modo che le righe di output siano il join di
la riga dell'evento di input e la riga della posizione centrale. Inoltre, questo interruttore scrive anche tutto
righe di posizione centrale per le quali nessun evento soddisfa i criteri di ricerca cono di quella riga.
Alla colonna CONE_KEY verrà assegnato un valore di -2 per le righe centrali che non erano vicine ad alcuna
la riga di dati e le colonne degli eventi verranno azzerate per tali righe. In questo modo tutti i centri
le righe sono garantite per essere emesse almeno una volta.

Se uno qualsiasi degli interruttori "tutte le righe" (-X, -J, o -L) sono specificati, quindi una nuova colonna denominata JSTAT
viene aggiunto alla tabella di output. I valori positivi in ​​questa colonna indicano il centro
posizionare il numero di riga (a partire da 1) nel file di elenco che questa riga di dati ha avuto successo
abbinato in una ricerca conica. Un valore di -1 significa che la riga di dati non corrisponde ad alcun centro
posizione. Un valore di -2 significa che la posizione centrale non è stata trovata in corrispondenza di alcuna riga di dati.

Data una posizione centrale e un raggio, l'algoritmo di ricerca del cono calcola i parametri limite
per una scatola che racchiude il cono specificato e verifica solo le righe i cui valori di posizione giacciono
entro quei limiti. Per file di piccole dimensioni, l'overhead associato a questo cono limite
il filtraggio può causare un'esecuzione più lenta del programma rispetto a quando tutti gli eventi sono stati testati. Puoi
disattivare il filtro limite cono utilizzando il -n passare per vedere se questo accelera l'elaborazione
(particolarmente utile quando si elabora un ampio elenco di posizioni).

Ad esempio, la ricerca cono predefinita utilizza le colonne "RA" e "Dec" in ore e gradi
(rispettivamente) e posizione AR in ore, Dec e raggio in gradi:

funone dentro.adatta.adatta 23.45 34.56 0.01

Per specificare la posizione di AR in gradi:

funcone dentro.adatta fuori.adatta 23.45d 34.56 0.01

Per ottenere RA e Dec da una lista ma usa un valore statico per il raggio (e scrivi anche
informazioni identificative per ogni riga nell'elenco):

funcone -x -l list.txt in.adatta fuori.adatta MYRA MYDec 0.01

Colonne specificate dall'utente in gradi, posizione AR in ore (notazione sessagesimale), Dec
posizione in gradi (notazione sessagesimale) e raggio in minuti d'arco:

funcone -r myRa:d -d myDec in.fits out.fits 12:30:15.5 30:12 15'

Usa funcone online utilizzando i servizi onworks.net