funtable - Online sa Cloud

PROGRAMA:

NAME

funtable - kopyahin ang mga napiling row mula sa isang Funtools file patungo sa isang FITS binary table

SINOPSIS

funtable [-a] [-i⎪-z] [-m] [-s cols] [mga hanay]

Opsyon

-a # idagdag sa umiiral na output file bilang extension ng talahanayan
-i # para sa data ng imahe, bumuo lamang ng mga X at Y na column
-m # para sa mga talahanayan, magsulat ng isang hiwalay na file para sa bawat rehiyon
-s "col1 ..." # column kung saan pag-uuri-uriin
-z # para sa data ng imahe, output na zero-valued pixels

DESCRIPTION

funtable pumipili ng mga row mula sa tinukoy na FITS Extension (binary table lang) ng isang FITS
file, o mula sa isang non-FITS raw na file ng kaganapan, at isinusulat ang mga row na iyon sa isang FITS binary table
file. Gagawa rin ito ng FITS binary table mula sa isang imahe o isang raw array file.

Ang unang argumento sa programa ay tumutukoy sa FITS file, raw event file, o raw array
file. Kung tinukoy ang "stdin", babasahin ang data mula sa karaniwang input. Gumamit ng Funtools
Bracket Notation upang tukuyin ang mga FITS extension, at mga filter. Ang pangalawang argumento ay ang
output FITS file. Kung ang "stdout" ay tinukoy, ang FITS binary table ay isinusulat sa
karaniwang output. Bilang default, ang lahat ng mga column ng input file ay kinokopya sa output file.
Ang mga napiling column ay maaaring i-output gamit ang isang opsyonal na ikatlong argumento sa form:

"column1 column1 ... columnN"

Ang funtable Karaniwang ginagamit ang programa upang pumili ng mga hilera mula sa isang FITS binary table gamit ang Table
Mga Filter at/o Mga Filter ng Spatial na Rehiyon. Halimbawa, maaari mo lamang kopyahin ang mga napiling row (at
mga napiling column lang ang output) sa pamamagitan ng pagpapatupad sa isang command tulad ng:

[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

Ang espesyal na hanay $REGION maaaring tukuyin upang isulat ang id ng rehiyon ng bawat hilera:

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

Narito lamang ang mga hilera na may wastong fractional na oras at ang posisyon ay nasa loob din ng isa sa
ang tatlong annuli ay nakasulat.

Maaaring ibukod ang mga column sa display gamit ang minus sign bago ang column:

[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

Lahat ng column maliban sa time column ay nakasulat.

Sa pangkalahatan, ang mga panuntunan para sa pag-activate at pag-deactivate ng mga column ay:

· Kung ibubukod lamang ang mga hanay ay tinukoy, ang lahat ng mga hanay ngunit ang ibukod na mga hanay ay gagawin
ma-activate.

· Kung isama lang ang mga column ang tinukoy, ang mga tinukoy na column lang ang isasaaktibo.

· Kung ang pinaghalong isama at ibukod na mga hanay ay tinukoy, lahat maliban sa ibukod
magiging aktibo ang mga column; ang huling kaso na ito ay malabo at ang panuntunan ay arbitrary.

Bilang karagdagan sa tahasang pagtukoy sa mga pangalan ng column, ang mga espesyal na simbolo + at - ay maaaring maging
ginagamit para i-activate at de-activate lahat mga hanay. Ito ay kapaki-pakinabang kung gusto mong i-activate ang
column ng $REGION kasama ng lahat ng iba pang column. Ayon sa mga panuntunan, ang syntax na "$REGION"
ina-activate lang ang column ng rehiyon at i-de-deactivate ang iba. Gamitin ang "+ $REGION" para i-activate
lahat ng column pati na rin ang column ng rehiyon.

Karaniwan, ang napiling talahanayan lamang ang kinokopya sa output file. Sa isang FITS binary table,
minsan ay kanais-nais na kopyahin ang lahat ng iba pang mga extension ng FITS sa output file bilang
mabuti. Magagawa ito sa pamamagitan ng pagdaragdag ng sign na '+' sa pangalan ng extension sa input
pangalan ng file. Halimbawa, ang unang command sa ibaba ay kinokopya lamang ang EVENT table, habang ang
Ang pangalawang utos ay kinokopya din ang iba pang mga extension:

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

Kung ang input file ay isang imahe o isang raw array file, kung gayon funtable bubuo ng FITS
binary table mula sa mga halaga ng pixel sa larawan. Tandaan na hindi posibleng tukuyin
ang mga column sa output (gamit ang command-line argument 3). Sa halip, mayroong dalawang paraan upang
lumikha ng naturang binary table mula sa isang imahe. Bilang default, nabuo ang isang 3-column table, kung saan
ang mga column ay "X", "Y", at "VALUE". Para sa bawat pixel sa larawan, isang hilera (kaganapan)
ay nabuo gamit ang mga column na "X" at "Y" na itinalaga ang dim1 at dim2 na mga halaga ng larawan
pixel, ayon sa pagkakabanggit at ang column na "VALUE" ay nagtalaga ng halaga ng pixel. Sa uri ng
mesa, tumatakbo funhist sa column na "VALUE" ay magbibigay ng parehong mga resulta gaya ng pagtakbo funhist
sa orihinal na larawan.

Kung ang -i ("indibidwal" na mga row) switch ay tinukoy, pagkatapos ay ang "X" at "Y" na mga column lamang ang
nabuo. Sa kasong ito, ang bawat positibong pixel value sa larawan ay bumubuo ng n row (mga kaganapan),
kung saan ang n ay katumbas ng integerized na halaga ng pixel na iyon (plus 0.5, para sa floating point
data). May bisa, -i humigit-kumulang na muling nililikha ang mga hilera ng isang talahanayan na sana
binned sa input na imahe. (Siyempre, ito ay tinatayang tama lamang, dahil ang
ang mga resultang x,y na posisyon ay integerized.)

Kung ang -s [col1 col2 ... coln] ("pag-uuri") switch ay tinukoy, ang mga hilera ng output ng isang binary
pag-uuri-uriin ang talahanayan gamit ang mga tinukoy na column bilang mga key ng pag-uuri. Ang mga susi sa pag-uuri ay dapat na
scalar columns at dapat ding bahagi ng output file (ibig sabihin, hindi ka maaaring mag-sort sa isang column
ngunit huwag isama ito sa output). Ginagamit ng pasilidad na ito ang _uri-uriin programa (kasama ang
funtools), na dapat ma-access sa pamamagitan ng iyong landas.

Para sa mga binary table, ang -m ("maramihang mga file") switch ay bubuo ng isang hiwalay na file para sa bawat isa
rehiyon sa detalye ng filter ie ang bawat file ay naglalaman lamang ng mga row mula sa rehiyong iyon.
Ang mga row na pumasa sa filter ngunit wala sa anumang rehiyon ay inilalagay din sa isang hiwalay na file.

Ang hiwalay na mga pangalan ng output file na nabuo ng -m switch ay awtomatikong ginawa mula sa
ang root output file na naglalaman ng region id ng nauugnay na rehiyon. (Tandaan ang rehiyong iyon
magsisimula ang mga id sa 1, upang ang pangalan ng file na nauugnay sa id 0 ay naglalaman ng mga row na pumasa sa
filter ngunit wala sa anumang partikular na rehiyon.) Ang mga pangalan ng output file ay nabuo tulad ng sumusunod:

· Ang isang $n na detalye ay maaaring gamitin saanman sa root file name (angkop na sinipi sa
protektahan ito mula sa shell) at papalawakin upang maging id number ng nauugnay
rehiyon. Halimbawa:

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

bubuo ng mga file na pinangalanang foo.goo_0.fits (para sa mga row na wala sa anumang rehiyon ngunit dumadaan pa rin
ang filter), foo.goo_1.fits (mga row sa region id #1, ang unang rehiyon), foo.goo_2.fits
(mga hilera sa rehiyon id #2), atbp. Tandaan na ang mga solong panipi sa output root ay kinakailangan
upang protektahan ang '$' mula sa shell.

· Kung hindi tinukoy ang $n, ilalagay ang region id bago ang unang tuldok (.) in
ang filename. kaya:

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

bubuo ng mga file na pinangalanang foo0.evt.fits (para sa mga row na wala sa anumang rehiyon ngunit dumadaan pa rin
ang filter), foo1.evt.fits (mga hilera sa rehiyon id #1), foo2.evt.fits (mga hilera sa rehiyon id
#2), atbp.

· Kung walang tuldok ang tinukoy sa root output file name, ang region id ay magiging
idinagdag sa filename. kaya:

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

bubuo ng mga file na pinangalanang foo_evt0 (para sa mga hilera na wala sa anumang rehiyon ngunit nagpapasa pa rin ng
filter), foo_evt1 (mga hilera sa rehiyon id #1), foo_evt2 (mga hilera sa rehiyon id #2), atbp.

Ang mekanismo ng maramihang file ay nagbibigay ng isang simpleng paraan upang makabuo ng mga indibidwal na source data file
na may isang solong pagpasa sa data.

Bilang default, ang isang bagong FITS file ay nilikha at ang binary table ay nakasulat sa una
extension. Kung ang -a (idagdag) switch ay tinukoy, ang talahanayan ay idinagdag sa isang umiiral na
FITS file bilang BINTABLE extension. Tandaan na ang output FITS file ay dapat na mayroon na.

Kung ang -z ("zero" pixel values) switch ay tinukoy at -i ay hindi tinukoy, pagkatapos ay mga pixel
ang pagkakaroon ng isang zero na halaga ay magiging output sa kanilang "VALUE" na column na nakatakda sa zero. Obviously, ito
walang saysay ang switch kapag ang mga indibidwal na kaganapan ay output.

Gumamit ng funtable online gamit ang mga serbisyo ng onworks.net