funjoin - Online sa Cloud

PROGRAMA:

NAME

funjoin - sumali sa dalawa o higit pang FITS binary table sa mga tinukoy na column

SINOPSIS

funjoin [lumipat] ...

Opsyon

-a cols # columns para i-activate sa lahat ng file
-a1 cols ... isang cols # column na ia-activate sa bawat file
-b 'c1:bvl,c2:bv2' # blangko na halaga para sa mga karaniwang column sa lahat ng file
-bn 'c1:bv1,c2:bv2' # blangko na halaga para sa mga column sa mga partikular na file
-j col # column para makasali sa lahat ng file
-j1 col ... jn col # column na isasama sa bawat file
-m min # min tumutugma sa output ng isang row
-M max # max na tugma upang mag-output ng isang row
-s # magdagdag ng hanay ng katayuan ng 'jfiles'
-S col # magdagdag ng col bilang column ng status
-t tol # tolerance para sa pagsali sa mga numeric cols [2 file lang]

DESCRIPTION

funjoin nagsasama ng mga row mula sa dalawa o higit pa (hanggang 32) FITS Binary Table file, batay sa
mga halaga ng tinukoy na mga column ng pagsasama sa bawat file. NB: dapat may index ang mga join column
file na nauugnay dito. Ang mga file na ito ay nabuo gamit ang funindex programa.

Ang unang argumento sa programa ay tumutukoy sa unang input na FITS na talahanayan o raw na file ng kaganapan.
Kung tinukoy ang "stdin", babasahin ang data mula sa karaniwang input. Mga kasunod na argumento
tukuyin ang mga karagdagang file ng kaganapan at talahanayan na sasalihan. Ang huling argumento ay ang output FITS
file.

NB: Gawin hindi gamitin ang Funtools Bracket Notation upang tukuyin ang mga FITS extension at row filter kung kailan
tumatakbo sa funjoin o makakakuha ka ng mga maling resulta. Ang mga hilera ay ina-access at sinasali gamit ang
direktang mag-index ng mga file, at nilalampasan nito ang lahat ng pag-filter.

Tinukoy ang mga join column gamit ang -j co switch (na tumutukoy sa pangalan ng column sa
gamitin para sa lahat ng mga file) o kasama -j1 col1, -j2 col2... -jn coln switch (na tumutukoy sa a
pangalan ng column na gagamitin para sa bawat file). Dapat na tukuyin ang isang join column para sa bawat file. Kung pareho
-j co at -jn coln ay tinukoy para sa isang naibigay na file, pagkatapos ay ginagamit ang huli. Sumali sa mga column
dapat alinman sa uri ng string o uri ng numero; bawal ang paghaluin ang numeric at string
mga column sa isang ibinigay na pagsali. Halimbawa, upang sumali sa tatlong file gamit ang parehong key column para sa
bawat file, gamitin ang:

funjoin -j key in1.fits in2.fits in3.fits out.fits

Maaaring tukuyin ang ibang key para sa ikatlong file sa ganitong paraan:

funjoin -j key -j3 otherkey in1.fits in2.fits in3.fits out.fits

Ang -a "cols" lumipat (at -a1 "col1", -a2 "cols2" mga katapat) ay maaaring gamitin upang tukuyin
mga column na isaaktibo (ibig sabihin, sumulat sa output file) para sa bawat input file. Bilang default, lahat
ang mga hanay ay output.

Kung ang dalawa o higit pang mga column mula sa magkahiwalay na mga file ay may parehong pangalan, ang pangalawa (at kasunod)
Ang mga column ay pinalitan ng pangalan upang magkaroon ng underscore at may nakadugtong na halaga.

Ang -m minuto at -M max Tinutukoy ng mga switch ang minimum at maximum na bilang ng mga pagsali na kinakailangan upang
sumulat ng isang hilera. Ang default na minimum ay 0 joins (ibig sabihin, lahat ng row ay nakasulat) at ang
default na maximum ay 63 (ang maximum na bilang ng posibleng pagsali na may limitasyon na 32 input
mga file). Halimbawa, isulat lamang ang mga row kung saan eksaktong dalawang file ang may mga column
ang tugmang iyon (ibig sabihin, isang sumali):

funjoin -j key -m 1 -M 1 in1.fits in2.fits in3.fits ... out.fits

Ang isang ibinigay na hilera ay maaaring magkaroon ng kinakailangang bilang ng mga pagsali nang hindi sinasali ang lahat ng mga file
(hal. tatlong file ang isinasali ngunit dalawa lang ang may ibinigay na halaga ng key ng pagsali). Dito sa
kaso, ang lahat ng mga column ng hindi pinagsamang file ay isinulat, bilang default, gamit ang mga blangko
(mga zero o NULL). Ang -b c1:bv1,c2:bv2 at -b1 'c1:bv1,c2:bv2' -b2 'c1:bv1,c2 - bv2' ...
maaaring gamitin ang mga switch para itakda ang blangko na halaga para sa mga column na karaniwan sa lahat ng file at/o column
sa isang tinukoy na file, ayon sa pagkakabanggit. Ang bawat blangkong value string ay naglalaman ng isang listahan na pinaghihiwalay ng kuwit
ng column:blank_val specifiers. Para sa mga floating point value (single o double), isang case-
insensitive string value ng "nan" ay nangangahulugan na ang IEEE NaN (not-a-number) ay dapat gamitin.
Kaya, halimbawa:

funjoin -b "AKEY:???" -b1 "A:-1" -b3 "G:NaN,E:-1,F:-100" ...

nangangahulugan na ang isang hindi pinagsamang column ng AKEY sa anumang file ay maglalaman ng string na "???", ang hindi-
sumali Ang isang column ng file 1 ay maglalaman ng value na -1, ang hindi pinagsamang G column ng file 3
ay maglalaman ng mga IEEE NaN, habang ang hindi pinagsamang E at F na mga column ng parehong file ay maglalaman
mga halaga -1 at -100, ayon sa pagkakabanggit. Siyempre, kung nasaan ang mga karaniwan at partikular na mga blangko na halaga
tinukoy para sa parehong column, ginagamit ang partikular na blangko na halaga.

Upang makilala kung aling mga file ang hindi blangko na bahagi ng isang row, ang -s (status) switch
ay maaaring magamit upang magdagdag ng isang bitmask column na pinangalanang "JFILES" sa output file. Sa kolum na ito, a
bit ay nakatakda para sa bawat hindi blangko na file na bumubuo sa ibinigay na row, na may bit 0 na tumutugma sa
unang file, bit 1 hanggang sa pangalawang file, at iba pa. Ang mga pangalan ng file mismo ay naka-imbak sa
ang FITS header bilang mga parameter na pinangalanang JFILE1, JFILE2, atbp. Ang -S co switch ay nagpapahintulot sa iyo na
baguhin ang pangalan ng column ng status mula sa default na "JFILES".

Ang pagsasama sa pagitan ng mga hilera ay ang produkto ng Cartesian ng lahat ng mga hilera sa isang file na mayroong ibinigay na pagsali
value ng column kasama ang lahat ng row sa pangalawang file na may parehong value para sa join column at
iba pa. Kaya, kung ang file1 ay may 2 row na may join column value 100, ang file2 ay may 3 row na may
parehong halaga, at ang file3 ay may 4 na mga hilera, pagkatapos ay ang pagsasama ay nagreresulta sa 2*3*4=24 na mga hilera bilang output.

Direktang pinoproseso ng join algorithm ang index file na nauugnay sa join column ng
bawat file. Ang pinakamaliit na halaga ng lahat ng kasalukuyang column ay pinili bilang base, at ito
ang value ay ginagamit para sumali sa mga column na may katumbas na halaga sa iba pang mga file. Sa ganitong paraan, ang index
ang mga file ay eksaktong isang beses na tinatahak.

Ang -t tol Tinutukoy ng switch ang isang tolerance value para sa mga numeric na column. Sa kasalukuyan, a
Ang halaga ng tolerance ay maaari lamang sumali sa dalawang file sa isang pagkakataon. (Ang isang ganap na naiibang algorithm ay
kinakailangan na sumali sa higit sa dalawang file gamit ang isang pagpapaubaya, isang bagay na maaari naming isaalang-alang
pagpapatupad sa hinaharap.)

Ang sumusunod na halimbawa ay nagpapakita ng marami sa mga tampok ng funjoin. Ang mga input file t1.fits,
Ang t2.fits, at t3.fits ay naglalaman ng mga sumusunod na column:

[sh] fundisp t1.fits
AKEY KEY AB
----------- ------ ------ ------
aaa 0 0 1
bbb 1 3 4
ccc 2 6 7
ddd 3 9 10
eee 4 12 13
fff 5 15 16
ggg 6 18 19
hhh 7 21 22

fundisp t2.magkasya
AKEY KEY CD
----------- ------ ------ ------
iii 8 24 25
ggg 6 18 19
eee 4 12 13
ccc 2 6 7
aaa 0 0 1

fundisp t3.magkasya
AKEY KEY EFG ------------ ------ -------- --------
-----------
ggg 6 18 19 100.10
jjj 9 27 28 200.20
aaa 0 0 1 300.30
ddd 3 9 10 400.40

Dahil sa mga input file na ito, ang sumusunod na funjoin command:

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
"SUSI:???" -b1 "AKEY:XXX,A:255" -b3 "G:NaN,E:-1,F:-100" \
-j key t1.fits t2.fits t3.fits foo.fits

sasali sa mga file sa KEY column, na naglalabas ng lahat ng column maliban sa B (sa t1.fits), D (sa
t2.fits) at E (sa t3.fits), at pagtatakda ng mga blangkong halaga para sa AKEY (sa buong mundo, ngunit na-override
para sa t1.fits) at A (sa file 1) at G, E, at F (sa file 3). Ang isang JFILES column ay magiging
output upang i-flag kung aling mga file ang ginamit sa bawat hilera:

AKEY KEY A AKEY_2 KEY_2 C AKEY_3 KEY_3 FG JFILES
------------ ------ ------ ------------ ------ ------ -- ---------- ------ -------- ----------- --------
aaa 0 0 aaa 0 0 aaa 0 1 300.30 7
bbb 1 3 ??? 0 0 ??? 0 -100 nan 1
ccc 2 6 ccc 2 6 ??? 0 -100 nan 3
ddd 3 9 ??? 0 0 ddd 3 10 400.40 5
eee 4 12 eee 4 12 ??? 0 -100 nan 3
fff 5 15 ??? 0 0 ??? 0 -100 nan 1
ggg 6 18 ggg 6 18 ggg 6 19 100.10 7
hhh 7 21 ??? 0 0 ??? 0 -100 nan 1
XXX 0 255 iii 8 24 ??? 0 -100 nan 2
XXX 0 255 ??? 0 0 jjj 9 28 200.20 4

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