funtable - Trực tuyến trên đám mây

CHƯƠNG TRÌNH:

TÊN

funtable - sao chép các hàng đã chọn từ tệp Funtools sang bảng nhị phân FITS

SYNOPSIS

mềm dẻo [-a] [-i⎪-z] [-m] [-s cols] [cột]

LỰA CHỌN

-a # chắp thêm vào tệp đầu ra hiện có dưới dạng phần mở rộng bảng
-i # cho dữ liệu hình ảnh, chỉ tạo cột X và Y
-m # cho các bảng, ghi một tệp riêng biệt cho từng vùng
-s "col1 ..." # cột để sắp xếp
-z # cho dữ liệu hình ảnh, xuất ra các pixel có giá trị bằng XNUMX

MÔ TẢ

mềm dẻo chọn các hàng từ Phần mở rộng FITS được chỉ định (chỉ dành cho bảng nhị phân) của một FITS
hoặc từ tệp sự kiện thô không phải FITS và ghi các hàng đó vào bảng nhị phân FITS
tập tin. Nó cũng sẽ tạo một bảng nhị phân FITS từ một hình ảnh hoặc một tệp mảng thô.

Đối số đầu tiên của chương trình chỉ định tệp FITS, tệp sự kiện thô hoặc mảng thô
tập tin. Nếu "stdin" được chỉ định, dữ liệu được đọc từ đầu vào chuẩn. Sử dụng Funtools
Ký hiệu Dấu ngoặc để chỉ định phần mở rộng FITS và bộ lọc. Đối số thứ hai là
xuất tệp FITS. Nếu "stdout" được chỉ định, bảng nhị phân FITS được ghi vào
đầu ra tiêu chuẩn. Theo mặc định, tất cả các cột của tệp đầu vào được sao chép vào tệp đầu ra.
Các cột đã chọn có thể được xuất ra bằng đối số thứ ba tùy chọn trong biểu mẫu:

"column1 column1 ... columnN"

Sản phẩm mềm dẻo chương trình thường được sử dụng để chọn các hàng từ bảng nhị phân FITS bằng cách sử dụng Bảng
Bộ lọc và / hoặc Bộ lọc vùng không gian. Ví dụ: bạn chỉ có thể sao chép các hàng đã chọn (và
chỉ xuất các cột đã chọn) bằng cách thực hiện lệnh như:

[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

Cột đặc biệt $ VÙNG có thể được chỉ định để viết id vùng của mỗi hàng:

[sh $] funtable "test.ev [time- (int) time> =. 99 && annulus (0 0 0 10 n = 3)]" stdout 'xy time $ REGION' ⎪ fundisp stdin
KHU VỰC THỜI GIAN 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

Ở đây chỉ các hàng có thời gian phân số thích hợp và vị trí của nó cũng nằm trong một trong số
ba năm được viết.

Có thể loại trừ các cột khỏi hiển thị bằng dấu trừ trước cột:

[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

Tất cả các cột ngoại trừ cột thời gian đều được viết.

Nói chung, các quy tắc để kích hoạt và hủy kích hoạt cột là:

· Nếu chỉ các cột loại trừ được chỉ định, thì tất cả các cột trừ các cột loại trừ sẽ
được kích hoạt.

· Nếu chỉ bao gồm các cột được chỉ định, thì chỉ các cột được chỉ định mới được kích hoạt.

· Nếu một hỗn hợp các cột bao gồm và loại trừ được chỉ định, thì tất cả trừ cột loại trừ
các cột sẽ hoạt động; trường hợp cuối cùng này là không rõ ràng và quy tắc là tùy ý.

Ngoài việc chỉ định tên cột một cách rõ ràng, các ký hiệu đặc biệt + và - có thể
được sử dụng để kích hoạt và hủy kích hoạt tất cả các cột. Điều này rất hữu ích nếu bạn muốn kích hoạt
Cột $ REGION cùng với tất cả các cột khác. Theo quy tắc, cú pháp "$ REGION"
chỉ kích hoạt cột khu vực và hủy kích hoạt phần còn lại. Sử dụng "+ $ REGION" để kích hoạt
tất cả các cột cũng như cột khu vực.

Thông thường, chỉ bảng đã chọn được sao chép vào tệp đầu ra. Trong bảng nhị phân FITS,
đôi khi mong muốn sao chép tất cả các phần mở rộng FITS khác vào tệp đầu ra dưới dạng
ổn. Điều này có thể được thực hiện bằng cách thêm dấu '+' vào tên của phần mở rộng trong đầu vào
tên tệp. Ví dụ: lệnh đầu tiên bên dưới chỉ sao chép bảng EVENT, trong khi lệnh
lệnh thứ hai cũng sao chép các phần mở rộng khác:

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

Nếu tệp đầu vào là hình ảnh hoặc tệp mảng thô, thì mềm dẻo sẽ tạo ra một FITS
bảng nhị phân từ các giá trị pixel trong hình ảnh. Lưu ý rằng không thể chỉ định
các cột để xuất (sử dụng đối số dòng lệnh 3). Thay vào đó, có hai cách để
tạo một bảng nhị phân như vậy từ một hình ảnh. Theo mặc định, một bảng 3 cột được tạo, trong đó
các cột là "X", "Y" và "VALUE". Đối với mỗi pixel trong hình ảnh, một hàng (sự kiện)
được tạo bằng các cột "X" và "Y" được chỉ định các giá trị dim1 và dim2 của hình ảnh
pixel, tương ứng và cột "VALUE" đã chỉ định giá trị của pixel. Với loại
bàn, đang chạy người vui tính trên cột "VALUE" sẽ cho kết quả giống như khi chạy người vui tính
trên hình ảnh gốc.

Nếu -i (các hàng "riêng lẻ") được chỉ định, khi đó chỉ các cột "X" và "Y" là
được tạo ra. Trong trường hợp này, mỗi giá trị pixel dương trong hình ảnh tạo ra n hàng (sự kiện),
trong đó n bằng giá trị số nguyên của pixel đó (cộng 0.5, đối với dấu phẩy động
dữ liệu). Trên thực tế, -i gần như tạo lại các hàng của một bảng mà lẽ ra
được ghép vào hình ảnh đầu vào. (Tất nhiên, điều này chỉ gần đúng, vì
kết quả là các vị trí x, y được cộng dồn.)

Nếu -s [col1 cột2 hữu ích. Cảm ơn ! cột] ("sắp xếp") chuyển đổi được chỉ định, các hàng đầu ra của một nhị phân
bảng sẽ được sắp xếp bằng cách sử dụng các cột được chỉ định làm khóa sắp xếp. Các phím sắp xếp phải là
cột vô hướng và cũng phải là một phần của tệp đầu ra (tức là bạn không thể sắp xếp trên một cột
nhưng không bao gồm nó trong đầu ra). Cơ sở này sử dụng _loại chương trình (bao gồm
funtools), phải có thể truy cập được qua đường dẫn của bạn.

Đối với bảng nhị phân, -m ("nhiều tệp") sẽ tạo một tệp riêng biệt cho mỗi
vùng trong đặc tả bộ lọc tức là mỗi tệp chỉ chứa các hàng từ vùng đó.
Các hàng vượt qua bộ lọc nhưng không nằm trong bất kỳ vùng nào cũng được đưa vào một tệp riêng biệt.

Các tên tệp đầu ra riêng biệt được tạo bởi -m công tắc được sản xuất tự động từ
tệp đầu ra gốc để chứa id vùng của vùng được liên kết. (Lưu ý rằng vùng
id bắt đầu từ 1, để tên tệp được liên kết với id 0 chứa các hàng vượt qua
nhưng không nằm trong bất kỳ vùng nhất định nào.) Tên tệp đầu ra được tạo như sau:

· Một đặc tả $ n có thể được sử dụng ở bất kỳ đâu trong tên tệp gốc (được trích dẫn phù hợp cho
bảo vệ nó khỏi shell) và sẽ được mở rộng thành số id của
khu vực. Ví dụ:

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

sẽ tạo các tệp có tên foo.goo_0.fits (đối với các hàng không thuộc bất kỳ vùng nào nhưng vẫn vượt qua
bộ lọc), foo.goo_1.fits (các hàng trong id vùng # 1, vùng đầu tiên), foo.goo_2.fits
(các hàng trong id vùng # 2), v.v. Lưu ý rằng bắt buộc phải có các dấu ngoặc kép trong thư mục gốc đầu ra
để bảo vệ '$' khỏi shell.

· Nếu $ n không được chỉ định, thì id vùng sẽ được đặt trước dấu chấm đầu tiên (.) Trong
tên tệp. Như vậy:

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

sẽ tạo các tệp có tên foo0.evt.fits (đối với các hàng không thuộc bất kỳ vùng nào nhưng vẫn vượt qua
bộ lọc), foo1.evt.fits (các hàng trong id vùng # 1), foo2.evt.fits (các hàng trong id vùng
# 2), v.v.

· Nếu không có dấu chấm nào được chỉ định trong tên tệp đầu ra gốc, thì id vùng sẽ là
được nối vào tên tệp. Như vậy:

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

sẽ tạo các tệp có tên foo_evt0 (đối với các hàng không thuộc bất kỳ vùng nào nhưng vẫn chuyển
bộ lọc), foo_evt1 (các hàng trong id vùng # 1), foo_evt2 (các hàng trong id vùng # 2), v.v.

Cơ chế nhiều tệp cung cấp một cách đơn giản để tạo các tệp dữ liệu nguồn riêng lẻ
với một lần truyền dữ liệu.

Theo mặc định, một tệp FITS mới được tạo và bảng nhị phân được ghi vào tệp đầu tiên
gia hạn. Nếu -a (thêm vào) chuyển đổi được chỉ định, bảng được nối vào một
Tệp FITS dưới dạng phần mở rộng BINTABLE. Lưu ý rằng tệp FITS đầu ra phải đã tồn tại.

Nếu -z (giá trị pixel "không") được chỉ định và -i không được chỉ định, sau đó là pixel
có giá trị XNUMX sẽ được xuất với cột "GIÁ TRỊ" của chúng được đặt thành XNUMX. Rõ ràng, điều này
chuyển đổi không có ý nghĩa khi các sự kiện riêng lẻ được xuất ra.

Sử dụng trực tuyến linh hoạt bằng các dịch vụ onworks.net