fundisp - Online di Cloud

PROGRAM:

NAMA

fundisp - menampilkan data dalam file data Funtools

RINGKASAN

dana [-f format] [-l] [-n] [-T] [kolom⎪bitpix=n]

PILIHAN

-f # format string untuk tampilan
-l # menampilkan gambar sebagai daftar yang berisi kolom X, Y, VAL
-n # jangan keluarkan header
-F [c] # gunakan karakter tertentu sebagai pemisah kolom (def: spasi)
-T # keluaran dalam format rdb/starbase (pemisah tab)

DESKRIPSI

dana menampilkan data dalam Ekstensi FITS dan/atau Bagian Gambar yang ditentukan dari FITS
file, atau di Bagian dari array non-FITS atau file acara mentah.

Argumen pertama untuk program menentukan gambar input FITS, array, atau file acara mentah
menampilkan. Jika "stdin" ditentukan, data dibaca dari input standar. Gunakan Funtools
Notasi Bracket untuk menentukan ekstensi FITS, bagian gambar, dan filter.

Jika data yang ditampilkan adalah kolom (baik dalam tabel biner FITS atau peristiwa mentah
file), baris individu terdaftar. Filter dapat ditambahkan menggunakan notasi braket. Dengan demikian:

[sh] fundisp "test.ev[time-(int)time>.15]"
XY PHA PI WAKTU 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: File uji tabel biner FITS test.ev, serta gambar FITS test.fits, adalah
terdapat dalam direktori funtools funtest.]

Saat sebuah tabel ditampilkan menggunakan dana, argumen opsional kedua dapat digunakan untuk
tentukan kolom yang akan ditampilkan. Sebagai contoh:

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

Kolom khusus $DAERAH dapat ditentukan untuk menampilkan id wilayah setiap baris:

[sh $] fundisp "test.ev[time-(int)time>=.99&&annulus(0 0 0 10 n=3)]" 'xy waktu $REGION'
WILAYAH WAKTU 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 waktu fraksional yang tepat dan yang posisinya juga berada dalam salah satu dari
tiga annuli ditampilkan.

Kolom dapat dikecualikan dari tampilan menggunakan tanda minus sebelum kolom:

[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

Semua kolom kecuali kolom waktu ditampilkan.

Kolom khusus $N dapat ditentukan untuk menampilkan nilai ordinal dari setiap baris. Dengan demikian,
melanjutkan contoh sebelumnya:

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

Perhatikan bahwa spesifikasi kolom diapit oleh tanda kutip tunggal untuk melindungi '$n' dari awal
diperluas oleh cangkang.

Secara umum, aturan untuk mengaktifkan dan menonaktifkan kolom adalah:

· Jika hanya kolom pengecualian yang ditentukan, maka semua kolom kecuali kolom pengecualian akan
diaktifkan.

· Jika hanya menyertakan kolom yang ditentukan, maka hanya kolom tertentu yang diaktifkan.

· Jika campuran kolom sertakan dan kecualikan ditentukan, maka semua kecuali yang dikecualikan
kolom akan aktif; kasus terakhir ini ambigu dan aturannya sewenang-wenang.

Selain menentukan nama kolom secara eksplisit, simbol khusus + dan - dapat
digunakan untuk mengaktifkan dan menonaktifkan semua kolom. Ini berguna jika Anda ingin mengaktifkan
kolom $REGION bersama dengan semua kolom lainnya. Menurut aturan, sintaks "$REGION"
hanya mengaktifkan kolom wilayah dan menonaktifkan sisanya. Gunakan "+ $REGION" untuk mengaktifkan
semua kolom serta kolom wilayah.

Jika data yang ditampilkan adalah data gambar (baik dalam gambar utama FITS, gambar FITS
ekstensi, atau file array), tampilan piksel mxn dihasilkan, di mana m dan n adalah
dimensi gambar. Secara default, nilai piksel ditampilkan menggunakan tipe data yang sama
seperti pada filenya. Namun, untuk data integer di mana parameter header BSCALE dan BZERO adalah
saat ini, data ditampilkan sebagai float. Dalam kedua kasus, tipe data tampilan dapat:
ditimpa menggunakan argumen kedua opsional dari formulir:

bitpix=n

di mana n adalah 8,16,32,-32,-64, masing-masing untuk unsigned char, short, int, float dan double.

Tentu saja, berlari dana pada apa pun kecuali gambar terkecil biasanya menghasilkan tampilan
yang ukurannya membuatnya tidak terbaca. Oleh karena itu, seseorang dapat menggunakan notasi braket (lihat di bawah) untuk
terapkan bagian dan/atau pemblokiran pada gambar sebelum membuat tampilan. Sebagai contoh:

[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

Perhatikan bahwa dimungkinkan untuk menampilkan tabel biner FITS sebagai gambar hanya dengan melewatkan
meja melalui gambar lucu pertama:

[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

Jika -l (daftar) digunakan, kemudian gambar ditampilkan sebagai daftar yang berisi
kolom: X, Y, VAL. Sebagai contoh:

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

Jika -n (nohead) switch digunakan, maka tidak ada header yang dikeluarkan untuk tabel. Ini berguna,
misalnya, ketika output fundisp diarahkan ke gnuplot.

Grafik dana program menggunakan satu set default format tampilan:

format TFORM tipe data
-------- ----- --------
ganda D "%21.8f"
float E "% 11.2f"
int J "%10d"
singkat saya "%8d"
byte B "%6d"
string A "%12.12s"
bit X "%8x"
logis L "%1x"

Jadi, tampilan default dari 1 double dan 2 short memberikan:

[sh] fundisp snr.ev "waktu xy"

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

Anda dapat mengubah format tampilan untuk masing-masing kolom atau untuk semua kolom yang diberikan
tipe data melalui tombol -f. Format string yang menyertai -f adalah spasi-
daftar kata kunci=nilai format yang dibatasi. Nilai kata kunci dapat berupa nama kolom
(dalam hal ini format terkait hanya berkaitan dengan kolom itu) atau tabel FITS TFORM
specifier (dalam hal ini format berkaitan dengan semua kolom yang memiliki tipe data tersebut). Untuk
contoh, Anda dapat mengubah format ganda dan pendek untuk semua kolom seperti ini:

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

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

Atau, Anda dapat mengubah format waktu dan kolom x seperti ini:

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

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

Perhatikan bahwa ada potensi konflik jika kolom memiliki nama yang sama dengan salah satu TFORM
penentu. Pada contoh di atas, kolom "X" pada tabel memiliki nama yang sama dengan
tipe data X (bit). Untuk mengatasi konflik ini, format string diproses sedemikian rupa sehingga
Penentu tipe data TFORM diperiksa terlebih dahulu, menggunakan perbandingan peka huruf besar/kecil. jika
nilai format yang ditentukan bukan nilai TFORM huruf besar, maka pemeriksaan case-insensitive adalah
dibuat pada nama kolom. Ini berarti, dalam contoh di atas, "X=%3d" akan merujuk ke
tipe data X (bit), sedangkan "x=%3d" akan merujuk ke kolom X:

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

XY
-------- --------
546 201
548 201
...

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

XY
---------
546 201
548 201
...

Oleh karena itu, sebagai aturan, yang terbaik adalah selalu menentukan nama kolom dalam huruf kecil dan TFORM
tipe data dalam huruf besar.

Grafik -f [format] akan mengubah format untuk satu eksekusi fundisp. Anda juga dapat menggunakan
itu MENYENANGKAN_FORMAT variabel envronment untuk mengubah format semua pemanggilan fundisp.
Format nilai variabel lingkungan ini identik dengan yang digunakan dengan -f
mengalihkan. Nilai global ini dapat diganti dalam kasus individual dengan menggunakan -f [format]
saklar.

Peringatan: Harap perhatikan juga bahwa pengguna bertanggung jawab untuk mencocokkan format
specifier ke tipe data kolom dengan benar. Perhatikan juga bahwa, untuk mempertahankan visual
penyelarasan antara nama dan kolom, nama kolom akan terpotong (di sebelah kiri) jika
lebar format kurang dari panjang nama. Namun, pemotongan tidak dilakukan
jika output dalam format RDB (menggunakan sakelar -T).

[String format gaya lama didukung tetapi tidak digunakan lagi. Ini terdiri dari ruang-dibatasi
Pernyataan format C untuk semua tipe data, ditentukan dalam urutan berikut:

double float int bit string byte pendek.

Urutan daftar ini didasarkan pada asumsi bahwa orang pada umumnya ingin
mengubah format float.

Jika "-" dimasukkan sebagai ganti pernyataan format untuk tipe data tertentu, format default
digunakan. Juga, string format dapat dihentikan tanpa menentukan semua format, dan
default akan digunakan untuk sisa daftar. Perhatikan bahwa Anda harus menyediakan bidang minimum
lebar, yaitu, "%6d" dan "%-6d" legal, "%d" tidak legal.

Dengan menggunakan -f [format], Anda dapat mengubah format ganda dan pendek seperti ini:

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

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

NB: Format ini tidak digunakan lagi dan akan dihapus pada rilis mendatang.]

Grafik -F[c] switch dapat digunakan untuk menentukan pemisah kolom (karakter tunggal) (di mana
default adalah spasi). Perhatikan bahwa pemformatan kolom hampir pasti juga akan menambahkan spasi ke
pad kolom individu dengan lebar yang dibutuhkan. Ini dapat dihapus dengan program seperti
sed, dengan biaya menghasilkan kolom yang tidak selaras. Sebagai contoh:

fundisp -F',' snr.ev'[cir 512 512 .1]'
X, Y, PHA, PI, WAKTU, 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, WAKTU, 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 waktu=%20.11f dx=%3d dy=%3d" -F',' snr.ev'[sekitar 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

Jika -T (tabel rdb) sakelar digunakan, output akan sesuai dengan basis data starbase/rdb
format: tab akan disisipkan di antara kolom, bukan spasi. Format ini tidak
tersedia saat menampilkan piksel gambar (kecuali dalam hubungannya dengan -l mengalihkan).

Akhirnya, perhatikan bahwa dana dapat digunakan untuk membuat filter kolom dari tabel bantu
dalam file FITS. Misalnya, kode shell berikut akan menghasilkan interval waktu yang baik
(GTI) filter untuk file data sinar-X yang berisi ekstensi GTI standar:

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

Jika skrip ini ditempatkan dalam file bernama "mkgti", skrip ini dapat digunakan dalam perintah seperti:

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

File filter yang dihasilkan kemudian dapat digunakan di berbagai program funtools:

funcnts foo.fits"[@gti.filter]" ...

untuk memproses hanya peristiwa dalam interval waktu yang baik.

Gunakan fundisp online menggunakan layanan onworks.net