funcone - Online în cloud

PROGRAM:

NUME

funcone - căutarea conică a unui tabel binar care conține coloane RA, Dec

REZUMAT

funcone [coloane]

OPŢIUNI

-d deccol:[hdr] # Dec numele coloanei, unități (def: DEC:d)
-j # unește coloanele din fișierul listă
-J # unește coloanele din fișierul listă, scoate toate rândurile
-l listfile # citește centrele și razele dintr-o listă
-L listfile # citește centrele și razele dintr-o listă, iese rândurile listei
-n # nu utilizați limitele conurilor ca filtru
-r racol:[hdr] # numele coloanei RA, unități (def: RA:h)
-x # anexează coloanele RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY
-X # adăugați coloanele RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY, scoateți toate rândurile

DESCRIERE

Funcone efectuează o căutare de conuri pe coloanele RA și Dec ale unui tabel binar FITS. The
distanța de la centrul RA, poziția Dec la RA, Dec în fiecare rând din tabel este
calculat. Sunt ieșite rândurile a căror distanță este mai mică decât raza specificată.

Primul argument al programului specifică fișierul FITS, fișierul eveniment brut sau matricea brută
fişier. Dacă este specificat „stdin”, datele sunt citite de la intrarea standard. Utilizați Funtools
Notație pentru paranteze pentru a specifica extensiile și filtrele FITS. Al doilea argument este
ieșiți fișierul FITS. Dacă este specificat „stdout”, tabelul binar FITS este scris în
ieșire standard.

Al treilea și al patrulea argument necesar sunt poziția centrală RA și Dec. În mod implicit,
RA este specificat în ore, în timp ce Dec este specificat în grade. Puteți schimba unitățile de
oricare dintre acestea prin adăugarea caracterului „d” (grade), „h” (ore) sau „r” (radiani).
Notația sexagesimală este suportată, cu două puncte sau spații care separă hms și dms. (Cand
folosind spații, vă rugăm să vă asigurați că întregul șir este citat.)

Al cincilea argument necesar este raza căutării conului. În mod implicit, valoarea razei
este dat în grade. Unitățile pot fi modificate prin adăugarea caracterului „d” (grade),
"r" (radiani), "'" (minute de arc) sau """ (secunde de arc).

În mod implicit, toate coloanele fișierului de intrare sunt copiate în fișierul de ieșire. Coloane selectate
poate fi scos folosind un al șaselea argument opțional sub forma:

„coloana1 coloana1 ... coloanaN”

Un al șaptelea argument vă permite să scoateți coloanele selectate din fișierul listă când -j comuta
este folosit. Rețineți că coloanele RA și Dec utilizate în calculul conului nu trebuie să fie
deselectat.

De asemenea, în mod implicit, numele coloanelor RA și Dec sunt denumite „RA” și „Dec” și sunt date în
unități de ore și, respectiv, grade. Puteți schimba atât numele, cât și unitățile folosind
comutatoarele -r [RA] și/sau -d [Dec]. Încă o dată, unul dintre „h”, „d” sau „r” este adăugat la
numele coloanei pentru a specifica unitățile, dar în acest caz, trebuie să existe două puncte „:” între
denumirea și specificația unității.

În cazul în care -l [listfile] se folosește comutatorul, apoi unul sau mai multe dintre centrul RA, centrul Dec și
raza poate fi luată dintr-un fișier listă (care poate fi un tabel FITS sau un text de coloană ASCII
fişier). În acest caz, a treia (centrul RA), a patra (centrul Dec) și a cincea (raza)
Argumentele liniei de comandă pot fi fie un nume de coloană în fișierul listă (dacă acel parametru
variază) sau altfel o valoare numerică (dacă acel parametru este static). Când un nume de coloană este
specificat pentru RA, Dec sau rază, puteți adăuga două puncte urmate de „h”, „d” sau „r”
pentru a specifica unitățile (de asemenea, „ și „ pentru rază). Algoritmul de căutare a conului este rulat o dată pentru fiecare
rând din listă, luând valorile RA, Dec și raza din coloanele specificate sau din
valori numerice statice specificate pe linia de comandă.

Când utilizați o listă, toate rândurile valide din fiecare iterație sunt scrise într-un singur fișier de ieșire.
Folosește -x comutați pentru a ajuta la delimitarea liniei din fișierul listă care a fost folosită pentru a produce fișierul
rânduri date de ieșire. Acest comutator determină valorile pentru centrul RA, Dec, raza și
numărul rândului care urmează să fie atașat la fișierul de ieșire, în coloane numite RA_CEN, DEC_CEN, RAD_CEN
și, respectiv, CONE_KEY. Alternativ, -j comutatorul (alăturare) va adăuga toate coloanele
de la rândul de listă la rândul de ieșire (în esență o îmbinare a rândului de listă și a rândului de intrare),
împreună cu numărul de rând CONE_KEY. Aceste două comutatoare se exclud reciproc.

-X și -J comutatoarele scriu aceleași date ca și omologii lor cu litere mici pentru fiecare
rând care satisface o căutare de con. În plus, aceste comutatoare scriu și rânduri din
fișier eveniment care nu satisface nicio căutare de con. În astfel de cazuri, acea coloană CONE_KEY va fi
i se va da o valoare de -1, iar informațiile despre poziția centrului și a listei vor fi setate la zero
pentru rândul dat. Astfel, toate rândurile fișierului eveniment de intrare sunt garantate a fi scoase,
cu rânduri care satisfac cel puțin o căutare de con cu informații suplimentare de căutare.

-L comutatorul acționează în mod similar cu -l comutator prin faptul că ia centre dintr-un fișier listă.
Cu toate acestea, de asemenea, setează implicit comutatorul -j, astfel încât rândurile de ieșire să fie îmbinarea
rândul de introducere a evenimentului și rândul de poziție centrală. În plus, acest comutator scrie tot
rânduri de poziție centrală pentru care niciun eveniment nu satisface criteriile de căutare a conului acelui rând.
Coloanei CONE_KEY va primi o valoare de -2 pentru rândurile centrale care nu au fost aproape de niciunul
rândul de date și coloanele de evenimente vor fi eliminate pentru astfel de rânduri. În acest fel, toate centrele
se garantează că rândurile vor fi scoase cel puțin o dată.

Dacă oricare dintre „toate rândurile” comută (-X, -J, Sau -L), apoi o nouă coloană numită JSTAT
este adăugat la tabelul de ieșire. Valorile pozitive din această coloană indică centrul
poziționați numărul rândului (începând de la 1) în fișierul listă pe care acest rând de date a reușit
potrivite într-o căutare con. O valoare de -1 înseamnă că rândul de date nu se potrivește cu niciun centru
poziţie. O valoare de -2 înseamnă că poziția centrală nu a fost potrivită de niciun rând de date.

Având în vedere o poziție centrală și o rază, algoritmul de căutare a conului calculează parametrii limită
pentru o casetă care include conul specificat și testează numai rândurile ale căror poziții se află
în acele limite. Pentru fișierele mici, supraîncărcarea asociată cu acest con limită
filtrarea poate face ca programul să ruleze mai lent decât dacă toate evenimentele ar fi testate. Poti
dezactivați filtrarea limitei conului folosind -n comutați pentru a vedea dacă acest lucru accelerează procesarea
(util mai ales atunci când procesați o listă mare de poziții).

De exemplu, căutarea implicită a conului folosește coloanele „RA” și „Dec” în ore și grade
(respectiv) și poziția RA în ore, Dec și raza în grade:

funone in.se potriveste.se potriveste 23.45 34.56 0.01

Pentru a specifica poziția RA în grade:

funcone in.fits out.fits 23.45d 34.56 0.01

Pentru a obține RA și Dec dintr-o listă, dar utilizați o valoare statică pentru rază (și, de asemenea, scrieți
informații de identificare pentru fiecare rând din listă):

funcone -x -l list.txt in.fits out.fits out.fits MYRA MYDec 0.01

Coloanele specificate de utilizator în grade, poziția RA în ore (notație sexagesimală), Dec
poziție în grade (notație sexagesimală) și raza în minute de arc:

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

Utilizați funcone online folosind serviciile onworks.net