fundisp - Online în cloud

PROGRAM:

NUME

fundisp - afișați datele într-un fișier de date Funtools

REZUMAT

fundisp [format -f] [-l] [-n] [-T] [coloane⎪bitpix=n]

OPŢIUNI

-f # format șir pentru afișare
-l # afișează imaginea ca o listă care conține coloanele X, Y, VAL
-n # nu scoate antet
-F [c] # folosește caracterul specificat ca separator de coloană (def: spațiu)
-T # ieșire în format rdb/starbase (separatoare de file)

DESCRIERE

fundisp afișează datele din extensia FITS specificată și/sau secțiunea de imagine a unui FITS
fișier sau într-o secțiune a unei matrice non-FITS sau a unui fișier de eveniment brut.

Primul argument al programului specifică imaginea de intrare FITS, matricea sau fișierul eveniment brut
a afișa. Dacă este specificat „stdin”, datele sunt citite de la intrarea standard. Utilizați Funtools
Notație pentru paranteze pentru a specifica extensiile FITS, secțiunile de imagine și filtrele.

Dacă datele afișate sunt coloane (fie într-un tabel binar FITS, fie într-un eveniment brut
fișier), sunt listate rândurile individuale. Filtrele pot fi adăugate folosind notația paranteze. Prin urmare:

[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: Fișierul de testare a tabelului binar FITS test.ev, precum și imaginea FITS test.fits, sunt
conținute în directorul funtools funtest.]

Când un tabel este afișat folosind fundisp, un al doilea argument opțional poate fi folosit pentru
specificați coloanele de afișat. De exemplu:

[sh] fundisp "test.ev[time-(int)time>=.99]" "xy time"
TIMP 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

Rubrica specială $REGION poate fi specificat pentru a afișa ID-ul regiunii pentru fiecare rând:

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

Aici doar rândurile cu timpul fracționar adecvat și a căror poziție este, de asemenea, într-unul dintre
sunt afișate cele trei inele.

Coloanele pot fi excluse din afișare folosind semnul minus înaintea coloanei:

[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

Sunt afișate toate coloanele, cu excepția coloanei de timp.

Rubrica specială $N poate fi specificat pentru a afișa valoarea ordinală a fiecărui rând. Prin urmare,
continuand exemplul anterior:

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

Rețineți că specificația coloanei este inclusă între ghilimele simple pentru a proteja „$n” de la început
extins de coajă.

În general, regulile de activare și dezactivare a coloanelor sunt:

· Dacă sunt specificate numai coloanele de excludere, atunci toate coloanele, cu excepția coloanelor de excludere, vor fi specificate
fi activat.

· Dacă sunt specificate numai coloane incluse, atunci numai coloanele specificate sunt activate.

· Dacă este specificat un amestec de coloane include și exclude, atunci toate, cu excepția excluderii
coloanele vor fi active; acest ultim caz este ambiguu și regula este arbitrară.

Pe lângă specificarea numelor de coloane în mod explicit, simbolurile speciale + și - poate fi
folosit pentru a activa și dezactiva toate coloane. Acest lucru este util dacă doriți să activați
Coloana $REGION împreună cu toate celelalte coloane. Conform regulilor, sintaxa „$REGION”
activează doar coloana regiune și dezactivează restul. Folosiți „+ $REGION” pentru a activa
toate coloanele, precum și coloana regiune.

Dacă datele afișate sunt date de imagine (fie într-o imagine primară FITS, fie într-o imagine FITS
extensie sau un fișier matrice), este produs un afișaj de pixeli mxn, unde m și n sunt
dimensiunile imaginii. În mod implicit, valorile pixelilor sunt afișate folosind același tip de date
ca în dosar. Cu toate acestea, pentru datele întregi în care sunt parametrii antetului BSCALE și BZERO
prezente, datele sunt afișate ca flotanți. În ambele cazuri, tipul de date de afișare poate fi
suprascris folosind un al doilea argument opțional de forma:

bitpix=n

unde n este 8,16,32,-32,-64, pentru unsigned char, short, int, float și, respectiv, double.

Desigur, alergând fundisp pe orice, în afară de cea mai mică imagine, de obicei rezultă un afișaj
a cărui dimensiune îl face imposibil de citit. Prin urmare, se poate folosi notația paranteze (vezi mai jos) pentru
aplicați secțiune și/sau blocare imaginii înainte de a genera un afișaj. De exemplu:

[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

Rețineți că este posibil să afișați un tabel binar FITS ca imagine prin simpla trecere a
masa prin distractiv primul:

[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

În cazul în care -l este utilizat comutatorul (listă), apoi o imagine este afișată ca o listă care conține
coloane: X, Y, VAL. De exemplu:

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

În cazul în care -n Se folosește comutatorul (nohead), apoi nu este scos niciun antet pentru tabele. Acest lucru este util,
de exemplu, când ieșirea fundisp este direcționată în gnuplot.

fundisp programul folosește un set implicit de formate de afișare:

formatul de date TFORM
-------- ----- --------
dublu D „%21.8f”
float E „%11.2f”
int J „%10d”
scurt I „%8d”
octetul B „%6d”
șirul A „%12.12s”
biți X „%8x”
L logic „%1x”

Astfel, afișarea implicită a 1 dublu și 2 scurte oferă:

[sh] fundisp snr.ev „timp xy”

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

Puteți modifica formatul de afișare pentru coloanele individuale sau pentru toate coloanele dintr-un anumit
tipuri de date prin intermediul comutatorului -f. Șirul de format care însoțește -f este un spațiu-
listă delimitată de valori cheie=format. Valorile cuvintelor cheie pot fi fie nume de coloane
(caz în care formatul asociat se referă numai la acea coloană) sau tabelul FITS TFORM
specificatori (caz în care formatul se referă la toate coloanele care au acel tip de date). Pentru
De exemplu, puteți modifica formatele duble și scurte pentru toate coloanele astfel:

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

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

Alternativ, puteți modifica formatul coloanelor oră și x astfel:

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

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

Rețineți că există un potențial conflict dacă o coloană are același nume ca unul din TFORM
specificatorii. În exemplele de mai sus, coloana „X” din tabel are același nume ca și
tipul de date X (bit). Pentru a rezolva acest conflict, șirul de format este procesat astfel încât
Specificatorii tipului de date TFORM sunt verificați mai întâi, utilizând o comparație sensibilă la majuscule. Dacă
valoarea formatului specificat nu este o valoare TFORM cu majuscule, atunci o verificare care nu ține seama de majuscule
realizat pe numele coloanei. Aceasta înseamnă că, în exemplele de mai sus, „X=%3d” se va referi la
tipul de date X (bit), în timp ce „x=%3d” se va referi la coloana X:

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

X Y
-------- --------
546 201
548 201
...

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

X Y
--- --------
546 201
548 201
...

Prin urmare, de regulă, este mai bine să specificați întotdeauna numele coloanei cu litere mici și TFORM
tipuri de date cu majuscule.

-f [format] va schimba formatul pentru o singură execuție a fundisp. De asemenea, puteți folosi
il FUN_FORMAT variabilă de mediu pentru a schimba formatul pentru toate invocările de fundisp.
Formatul valorii acestei variabile de mediu este identic cu cel utilizat cu -f
intrerupator. Această valoare globală poate fi suprascrisă în cazuri individuale prin utilizarea codului -f [format]
intrerupator.

Avertismente: Vă rugăm să rețineți că este responsabilitatea utilizatorului să se potrivească cu formatul
specificatorul tipului de date al coloanei corect. De asemenea, rețineți că, pentru a menține vizual
alinierea între nume și coloane, numele coloanei va fi trunchiat (în stânga) dacă
lățimea formatului este mai mică decât lungimea numelui. Cu toate acestea, trunchierea nu este efectuată
dacă ieșirea este în format RDB (folosind comutatorul -T).

[Un șir de format în stil mai vechi este acceptat, dar este depreciat. Este alcătuit din spațiu delimitat
Instrucțiuni în format C pentru toate tipurile de date, specificate în următoarea ordine:

double float int șir de octet scurt bit.

Această ordine a listei se bazează pe presupunerea că oamenii vor dori, în general
schimbați formatele float.

Dacă se introduce „-” în locul unei instrucțiuni de format pentru un anumit tip de date, formatul implicit
este folosit. De asemenea, șirul de format poate fi terminat fără a specifica toate formatele și
valorile implicite vor fi folosite pentru restul listei. Rețineți că trebuie să furnizați un câmp minim
lățimea, adică „%6d” și „%-6d” sunt legale, „%d” nu este legal.

Folosind -f [format], puteți modifica formatele duble și scurte astfel:

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

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

NB: Acest format este învechit și va fi eliminat într-o versiune viitoare.]

-F[c] comutatorul poate fi folosit pentru a specifica un separator de coloană (cu un singur caracter) (unde
implicit este un spațiu). Rețineți că formatarea coloanei va adăuga aproape sigur și spații
tamponați coloanele individuale la lățimea necesară. Acestea pot fi eliminate cu un program precum
sed, cu prețul generării de coloane nealiniate. De exemplu:

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

În cazul în care -T (rdb table) este utilizat comutatorul, ieșirea va fi conformă cu baza de date starbase/rdb
format: filele vor fi inserate între coloane și nu spații. Acest format nu este
disponibil la afișarea pixelilor imaginii (cu excepția împreună cu -l intrerupator).

În cele din urmă, rețineți că fundisp poate fi folosit pentru a crea filtre de coloană din tabelele auxiliare
într-un fișier FITS. De exemplu, următorul cod shell va genera un interval de timp bun
(GTI) pentru fișierele de date cu raze X care conțin o extensie GTI standard:

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

Dacă acest script este plasat într-un fișier numit „mkgti”, poate fi folosit într-o comandă precum:

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

Fișierul de filtru rezultat poate fi apoi utilizat în diferite programe funtools:

funcții foo.fits"[@gti.filter]"...

să proceseze numai evenimentele din intervalele de timp bune.

Utilizați fundisp online folosind serviciile onworks.net