funtable - Dalam talian di Awan

JADUAL:

NAMA

funtable - salin baris terpilih daripada fail Funtools ke jadual binari FITS

SINOPSIS

funtable [-a] [-i⎪-z] [-m] [-s cols] [lajur]

PILIHAN

-a # tambahkan pada fail output sedia ada sebagai sambungan jadual
-i # untuk data imej, hanya menjana lajur X dan Y
-m # untuk jadual, tulis fail berasingan untuk setiap rantau
-s "col1 ..." # lajur untuk diisih
-z # untuk data imej, output piksel bernilai sifar

DESCRIPTION

funtable memilih baris daripada Sambungan FITS yang ditentukan (jadual binari sahaja) bagi FITS
fail, atau daripada fail acara mentah bukan FITS, dan menulis baris tersebut ke jadual binari FITS
fail. Ia juga akan mencipta jadual binari FITS daripada imej atau fail tatasusunan mentah.

Argumen pertama untuk program menentukan fail FITS, fail acara mentah atau tatasusunan mentah
fail. Jika "stdin" ditentukan, data dibaca daripada input standard. Gunakan Funtools
Notasi Kurungan untuk menentukan sambungan dan penapis FITS. Hujah kedua ialah
keluarkan fail FITS. Jika "stdout" ditentukan, jadual binari FITS ditulis ke
keluaran standard. Secara lalai, semua lajur fail input disalin ke fail output.
Lajur yang dipilih boleh dikeluarkan menggunakan argumen ketiga pilihan dalam bentuk:

"lajur1 lajur1 ... lajurN"

. funtable program biasanya digunakan untuk memilih baris daripada jadual binari FITS menggunakan Jadual
Penapis dan/atau Penapis Wilayah Spatial. Sebagai contoh, anda boleh menyalin hanya baris yang dipilih (dan
output hanya lajur yang dipilih) dengan melaksanakan dalam arahan seperti:

[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

Lajur khas $REGION boleh ditentukan untuk menulis id rantau setiap baris:

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

Di sini hanya baris dengan masa pecahan yang betul dan kedudukannya juga dalam satu daripada
tiga anuli ditulis.

Lajur boleh dikecualikan daripada paparan menggunakan tanda tolak sebelum lajur:

[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

Semua lajur kecuali lajur masa ditulis.

Secara umum, peraturan untuk mengaktifkan dan menyahaktifkan lajur ialah:

· Jika hanya kecualikan lajur ditentukan, maka semua lajur tetapi kecuali lajur akan
diaktifkan.

· Jika hanya masukkan lajur ditentukan, maka hanya lajur yang ditentukan akan diaktifkan.

· Jika campuran masukkan dan kecualikan lajur ditentukan, maka semua kecuali kecualikan
lajur akan aktif; kes terakhir ini adalah samar-samar dan peraturannya adalah sewenang-wenangnya.

Selain menyatakan nama lajur secara eksplisit, simbol khas + and - boleh
digunakan untuk mengaktifkan dan menyahaktifkan semua lajur. Ini berguna jika anda ingin mengaktifkan
lajur $REGION bersama-sama dengan semua lajur lain. Mengikut peraturan, sintaks "$REGION"
hanya mengaktifkan lajur rantau dan menyahaktifkan selebihnya. Gunakan "+ $REGION" untuk mengaktifkan
semua lajur dan juga lajur rantau.

Biasanya, hanya jadual yang dipilih disalin ke fail output. Dalam jadual binari FITS,
kadangkala adalah wajar untuk menyalin semua sambungan FITS yang lain ke fail output sebagai
baiklah. Ini boleh dilakukan dengan menambahkan tanda '+' pada nama sambungan dalam input
nama fail. Sebagai contoh, arahan pertama di bawah hanya menyalin jadual EVENT, manakala
arahan kedua menyalin sambungan lain juga:

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

Jika fail input ialah imej atau fail tatasusunan mentah, maka funtable akan menjana FITS
jadual binari daripada nilai piksel dalam imej. Ambil perhatian bahawa ia tidak mungkin untuk dinyatakan
lajur untuk dikeluarkan (menggunakan hujah baris arahan 3). Sebaliknya, terdapat dua cara untuk
cipta jadual binari sedemikian daripada imej. Secara lalai, jadual 3 lajur dijana, di mana
lajur ialah "X", "Y" dan "VALUE". Untuk setiap piksel dalam imej, satu baris (peristiwa)
dijana dengan lajur "X" dan "Y" diberikan nilai dim1 dan dim2 imej
piksel, masing-masing dan lajur "VALUE" memberikan nilai piksel. Dengan semacam
meja, berlari funhist pada lajur "VALUE" akan memberikan hasil yang sama seperti berjalan funhist
pada imej asal.

Jika -i (baris "individu") ditentukan, maka hanya lajur "X" dan "Y" sahaja
dihasilkan. Dalam kes ini, setiap nilai piksel positif dalam imej menjana n baris (peristiwa),
di mana n adalah sama dengan nilai integer bagi piksel tersebut (tambah 0.5, untuk titik terapung
data). Dalam kesan, -i kira-kira mencipta semula baris jadual yang sepatutnya
binned ke dalam imej input. (Sudah tentu, ini hanya kira-kira betul, kerana
kedudukan x,y terhasil adalah integer.)

Jika -s [col1 col2 ... kol] ("isih") suis ditentukan, baris keluaran binari
jadual akan diisih menggunakan lajur yang ditentukan sebagai kekunci isihan. Kunci jenis mestilah
lajur skalar dan juga mesti menjadi sebahagian daripada fail output (iaitu anda tidak boleh mengisih pada lajur
tetapi tidak memasukkannya dalam output). Kemudahan ini menggunakan _sort program (termasuk dengan
funtools), yang mesti boleh diakses melalui laluan anda.

Untuk jadual binari, yang -m ("berbilang fail") suis akan menjana fail berasingan untuk setiap satu
rantau dalam spesifikasi penapis iaitu setiap fail mengandungi hanya baris dari rantau itu.
Baris yang melepasi penapis tetapi tidak berada di mana-mana rantau juga diletakkan dalam fail berasingan.

Nama fail keluaran berasingan yang dijana oleh -m suis dihasilkan secara automatik daripada
fail keluaran akar untuk mengandungi id rantau bagi rantau yang berkaitan. (Perhatikan kawasan itu
id bermula pada 1, supaya nama fail yang dikaitkan dengan id 0 mengandungi baris yang melepasi
penapis tetapi tidak berada dalam mana-mana kawasan tertentu.) Nama fail output dijana seperti berikut:

· Spesifikasi $n boleh digunakan di mana-mana dalam nama fail akar (sesuai dipetik untuk
melindunginya daripada cangkerang) dan akan dikembangkan menjadi nombor id yang berkaitan
wilayah. Sebagai contoh:

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

akan menjana fail bernama foo.goo_0.fits (untuk baris bukan di mana-mana rantau tetapi masih berlalu
penapis), foo.goo_1.fits (baris dalam id wilayah #1, wilayah pertama), foo.goo_2.fits
(baris dalam id wilayah #2), dsb. Ambil perhatian bahawa petikan tunggal dalam akar output diperlukan
untuk melindungi '$' daripada cangkerang.

· Jika $n tidak dinyatakan, maka id rantau akan diletakkan sebelum titik pertama (.) dalam
nama fail. Oleh itu:

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

akan menjana fail bernama foo0.evt.fits (untuk baris bukan di mana-mana rantau tetapi masih berlalu
penapis), foo1.evt.fits (baris dalam id wilayah #1), foo2.evt.fits (baris dalam id wilayah
#2), dsb.

· Jika tiada titik dinyatakan dalam nama fail output akar, maka id rantau akan menjadi
dilampirkan pada nama fail. Oleh itu:

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

akan menjana fail bernama foo_evt0 (untuk baris bukan di mana-mana rantau tetapi masih melepasi fail
penapis), foo_evt1 (baris dalam id wilayah #1), foo_evt2 (baris dalam id wilayah #2), dsb.

Mekanisme fail berbilang menyediakan cara mudah untuk menjana fail data sumber individu
dengan satu laluan melalui data.

Secara lalai, fail FITS baharu dicipta dan jadual binari ditulis kepada yang pertama
sambungan. Sekiranya -a (tambah) suis ditentukan, jadual dilampirkan pada yang sedia ada
FITS sebagai sambungan BINTABLE. Ambil perhatian bahawa fail FITS output mesti sudah wujud.

Jika -z (nilai piksel "sifar") suis ditentukan dan -i tidak ditentukan, kemudian piksel
mempunyai nilai sifar akan dikeluarkan dengan lajur "VALUE" ditetapkan kepada sifar. Jelas sekali, ini
suis tidak masuk akal apabila peristiwa individu dikeluarkan.

Gunakan funtable dalam talian menggunakan perkhidmatan onworks.net