funjoin - Dalam talian di Awan

JADUAL:

NAMA

funjoin - sertai dua atau lebih jadual binari FITS pada lajur yang ditentukan

SINOPSIS

funjoin [suis] ...

PILIHAN

-a cols # lajur untuk diaktifkan dalam semua fail
-a1 cols ... cols # lajur untuk diaktifkan dalam setiap fail
-b 'c1:bvl,c2:bv2' # nilai kosong untuk lajur biasa dalam semua fail
-bn 'c1:bv1,c2:bv2' # nilai kosong untuk lajur dalam fail tertentu
-j col # lajur untuk menyertai semua fail
-j1 col ... jn col # lajur untuk disertai dalam setiap fail
-m min # min sepadan untuk mengeluarkan satu baris
-M maks # maks padanan untuk mengeluarkan satu baris
-s # tambah lajur status 'jfiles'
-S col # tambah col sebagai lajur status
-t tol # toleransi untuk menyertai kol angka [2 fail sahaja]

DESCRIPTION

funjoin menyertai baris daripada dua atau lebih (sehingga 32) fail Jadual Binari FITS, berdasarkan
nilai lajur gabungan yang ditentukan dalam setiap fail. NB: lajur gabungan mesti mempunyai indeks
fail yang berkaitan dengannya. Fail ini dijana menggunakan funindex program.

Argumen pertama untuk program menentukan input pertama jadual FITS atau fail acara mentah.
Jika "stdin" ditentukan, data dibaca daripada input standard. Hujah-hujah seterusnya
tentukan fail dan jadual acara tambahan untuk disertai. Hujah terakhir ialah output FITS
fail.

NB: Lakukan tidak gunakan Funtools Bracket Notation untuk menentukan sambungan FITS dan penapis baris apabila
menjalankan funjoin atau anda akan mendapat hasil yang salah. Baris diakses dan dicantumkan menggunakan
fail indeks secara langsung, dan ini memintas semua penapisan.

Lajur gabungan ditentukan menggunakan -j kol suis (yang menentukan nama lajur kepada
gunakan untuk semua fail) atau dengan -j1 col1, -j2 col2... -jn kol suis (yang menentukan a
nama lajur untuk digunakan untuk setiap fail). Lajur gabungan mesti ditentukan untuk setiap fail. Jika kedua-duanya
-j kol and -jn kol ditentukan untuk fail tertentu, kemudian yang terakhir digunakan. Sertai lajur
mestilah sama ada daripada jenis rentetan atau jenis angka; adalah haram untuk mencampurkan angka dan rentetan
lajur dalam gabungan yang diberikan. Contohnya, untuk menyertai tiga fail menggunakan lajur kunci yang sama untuk
setiap fail, gunakan:

funjoin -j key in1.muat masuk2.muat masuk3.muat keluar.muat

Kunci yang berbeza boleh ditentukan untuk fail ketiga dengan cara ini:

funjoin -j key -j3 otherkey in1.muat dalam2.muat dalam3.muat keluar.muat

. -a "cols" suis (dan -a1 "col1", -a2 "cols2" rakan sejawat) boleh digunakan untuk menentukan
lajur untuk diaktifkan (iaitu tulis ke fail output) untuk setiap fail input. Secara lalai, semua
lajur adalah output.

Jika dua atau lebih lajur daripada fail berasingan mempunyai nama yang sama, yang kedua (dan seterusnya)
lajur dinamakan semula untuk mempunyai garis bawah dan nilai berangka dilampirkan.

. -m minit and -M maks suis menentukan bilangan sambungan minimum dan maksimum yang diperlukan untuk
tulis satu baris. Minimum lalai ialah 0 cantuman (iaitu semua baris ditulis) dan
maksimum lalai ialah 63 (bilangan maksimum kemungkinan gabungan dengan had 32 input
fail). Sebagai contoh, untuk menulis hanya baris di mana dua fail mempunyai lajur
perlawanan itu (iaitu satu penyertaan):

funjoin -j key -m 1 -M 1 in1.muat masuk2.muat dalam3.muat ... keluar.muat

Baris yang diberikan boleh mempunyai bilangan gabungan yang diperlukan tanpa semua fail digabungkan
(cth tiga fail sedang dicantumkan tetapi hanya dua yang mempunyai nilai kunci gabungan yang diberikan). Di dalam ini
kes, semua lajur fail tidak bercantum ditulis, secara lalai, menggunakan kosong
(sifar atau NULL). The -b c1:bv1,c2:bv2 dan -b1 'c1:bv1,c2:bv2' -b2 'c1:bv1,c2 - bv2' ...
suis boleh digunakan untuk menetapkan nilai kosong untuk lajur yang biasa kepada semua fail dan/atau lajur
dalam fail tertentu, masing-masing. Setiap rentetan nilai kosong mengandungi senarai yang dipisahkan koma
daripada penentu lajur:blank_val. Untuk nilai titik terapung (tunggal atau berganda), kes-
nilai rentetan tidak sensitif "nan" bermakna bahawa IEEE NaN (bukan-nombor) harus digunakan.
Oleh itu, sebagai contoh:

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

bermakna lajur AKEY yang tidak bercantum dalam mana-mana fail akan mengandungi rentetan "???", bukan-
bergabung Lajur fail 1 akan mengandungi nilai -1, lajur G tidak bercantum fail 3
akan mengandungi NaN IEEE, manakala lajur E dan F yang tidak bercantum pada fail yang sama akan mengandungi
nilai -1 dan -100, masing-masing. Sudah tentu, di mana nilai kosong biasa dan khusus berada
ditentukan untuk lajur yang sama, nilai kosong khusus digunakan.

Untuk membezakan fail yang merupakan komponen bukan kosong bagi baris tertentu, fail -s suis (status).
boleh digunakan untuk menambah lajur bitmask bernama "JFILES" pada fail output. Dalam ruangan ini, a
bit ditetapkan untuk setiap fail bukan kosong yang menyusun baris yang diberikan, dengan bit 0 sepadan dengan
fail pertama, bit 1 hingga fail kedua, dan seterusnya. Nama fail itu sendiri disimpan dalam
pengepala FITS sebagai parameter bernama JFILE1, JFILE2, dsb -S kol suis membolehkan anda
tukar nama lajur status daripada "JFILES" lalai.

Cantuman antara baris ialah hasil darab Cartesian bagi semua baris dalam satu fail yang mempunyai cantuman tertentu
nilai lajur dengan semua baris dalam fail kedua mempunyai nilai yang sama untuk lajur gabungannya dan
seterusnya. Oleh itu, jika fail1 mempunyai 2 baris dengan nilai lajur gabungan 100, fail2 mempunyai 3 baris dengan
nilai yang sama, dan fail3 mempunyai 4 baris, maka hasil gabungan dalam 2*3*4=24 baris menjadi output.

Algoritma gabungan memproses terus fail indeks yang dikaitkan dengan lajur gabungan
setiap fail. Nilai terkecil semua lajur semasa dipilih sebagai asas, dan ini
nilai digunakan untuk menyertai lajur bernilai sama dalam fail lain. Dengan cara ini, indeks
fail dilalui tepat sekali.

. -t push suis menentukan nilai toleransi untuk lajur berangka. Pada masa ini, a
nilai toleransi boleh menyertai hanya dua fail pada satu masa. (Algoritma yang sama sekali berbeza ialah
diperlukan untuk menyertai lebih daripada dua fail menggunakan toleransi, sesuatu yang mungkin kami pertimbangkan
dilaksanakan pada masa hadapan.)

Contoh berikut menunjukkan banyak ciri funjoin. Fail input t1.fits,
t2.fits dan t3.fits mengandungi lajur berikut:

[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.fits
CD AKEY KEY
----------- ------ ------ ------
iii 8 24 25
ggg 6 18 19
eee 4 12 13
ccc 2 6 7
aaa 0 0 1

fundisp t3.fits
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

Memandangkan fail input ini, arahan funjoin berikut:

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

akan menyertai fail pada lajur KEY, mengeluarkan semua lajur kecuali B (dalam t1.fits), D (dalam
t2.fits) dan E (dalam t3.fits), dan menetapkan nilai kosong untuk AKEY (secara global, tetapi ditindih
untuk t1.fits) dan A (dalam fail 1) dan G, E dan F (dalam fail 3). Lajur JFILES akan menjadi
output untuk menandakan fail yang digunakan dalam setiap baris:

KEY AKEY 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

Gunakan funjoin dalam talian menggunakan perkhidmatan onworks.net