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

CHƯƠNG TRÌNH:

TÊN

funjoin - tham gia hai hoặc nhiều bảng nhị phân FITS trên các cột được chỉ định

SYNOPSIS

vui vẻ [công tắc] ...

LỰA CHỌN

-a cols # cột để kích hoạt trong tất cả các tệp
-a1 cols ... một cols # cột để kích hoạt trong mỗi tệp
-b 'c1: bvl, c2: bv2' # giá trị trống cho các cột chung trong tất cả các tệp
-bn 'c1: bv1, c2: bv2' # giá trị trống cho các cột trong tệp cụ thể
-j col # cột để tham gia vào tất cả các tệp
-j1 col ... jn col # cột để tham gia vào mỗi tệp
-m min # min so khớp để xuất ra một hàng
-M max # max so khớp để xuất ra một hàng
-s # thêm cột trạng thái 'jfiles'
-S col # thêm col làm cột trạng thái
-t tol # dung sai để tham gia cột số [chỉ 2 tệp]

MÔ TẢ

vui vẻ nối các hàng từ hai hoặc nhiều hơn (tối đa 32) tệp Bảng nhị phân FITS, dựa trên
giá trị của các cột nối được chỉ định trong mỗi tệp. NB: các cột nối phải có chỉ mục
tệp được liên kết với nó. Các tệp này được tạo bằng cách sử dụng funindex chương trình.

Đối số đầu tiên của chương trình chỉ định bảng FITS đầu vào đầu tiên hoặc tệp sự kiện thô.
Nếu "stdin" được chỉ định, dữ liệu được đọc từ đầu vào chuẩn. Các đối số tiếp theo
chỉ định các tệp và bảng sự kiện bổ sung để tham gia. Đối số cuối cùng là đầu ra FITS
tập tin.

NB: Làm không sử dụng Ký hiệu dấu ngoặc nhọn Funtools để chỉ định tiện ích mở rộng FITS và bộ lọc hàng khi
chạy funjoin hoặc bạn sẽ nhận được kết quả sai. Các hàng được truy cập và tham gia bằng cách sử dụng
lập chỉ mục tệp trực tiếp và điều này bỏ qua tất cả quá trình lọc.

Các cột nối được chỉ định bằng cách sử dụng -j col chuyển đổi (chỉ định tên cột thành
sử dụng cho tất cả các tệp) hoặc với -j1 cột1, -j2 cột2, ... -jn cột công tắc (chỉ định một
tên cột để sử dụng cho mỗi tệp). Một cột nối phải được chỉ định cho mỗi tệp. Nếu cả hai
-j col và -jn cột được chỉ định cho một tệp nhất định, sau đó tệp sau được sử dụng. Nối các cột
phải thuộc kiểu chuỗi hoặc kiểu số; trộn số và chuỗi là bất hợp pháp
các cột trong một phép nối đã cho. Ví dụ: để nối ba tệp bằng cách sử dụng cùng một cột khóa cho
mỗi tệp, sử dụng:

phím funjoin -j in1.fits in2.fits in3.fits out.fits

Một khóa khác có thể được chỉ định cho tệp thứ ba theo cách này:

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

Sản phẩm -a "cols" chuyển đổi (và .A1 "col1", .A2 "cols2" đối tác) có thể được sử dụng để chỉ định
các cột để kích hoạt (tức là ghi vào tệp đầu ra) cho mỗi tệp đầu vào. Theo mặc định, tất cả
các cột là đầu ra.

Nếu hai hoặc nhiều cột từ các tệp riêng biệt có cùng tên, cột thứ hai (và các cột tiếp theo)
các cột được đổi tên để có dấu gạch dưới và thêm giá trị số.

Sản phẩm -m phút và -M tối đa công tắc chỉ định số lượng liên kết tối thiểu và tối đa cần thiết để
viết ra một hàng. Giá trị tối thiểu mặc định là 0 liên kết (nghĩa là tất cả các hàng được viết ra) và
mặc định tối đa là 63 (số lượng tối đa các phép nối có thể có với giới hạn 32 đầu vào
các tập tin). Ví dụ: chỉ viết ra những hàng trong đó có đúng hai tệp có cột
trận đấu đó (tức là một lần tham gia):

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

Một hàng nhất định có thể có số lượng liên kết cần thiết mà không cần tất cả các tệp được nối
(ví dụ: ba tệp đang được nối nhưng chỉ có hai tệp có giá trị khóa nối nhất định). Trong này
trường hợp, tất cả các cột của tệp không liên kết được viết ra, theo mặc định, sử dụng khoảng trống
(số không hoặc NULL). Các -b c1: bv1, c2: bv2 và -b1 'c1: bv1, c2: bv2' -b2 'c1: bv1, c2 - bv2' ...
công tắc có thể được sử dụng để đặt giá trị trống cho các cột chung cho tất cả các tệp và / hoặc cột
trong một tệp được chỉ định, tương ứng. Mỗi chuỗi giá trị trống chứa một danh sách được phân tách bằng dấu phẩy
of column: blank_val specifier. Đối với các giá trị dấu phẩy động (đơn hoặc kép), một trường hợp-
Giá trị chuỗi không nhạy của "nan" có nghĩa là IEEE NaN (không phải là số) nên được sử dụng.
Vì vậy, ví dụ:

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

có nghĩa là cột AKEY không được nối trong bất kỳ tệp nào sẽ chứa chuỗi "???", không phải
đã tham gia Một cột của tệp 1 sẽ chứa giá trị -1, cột G không được nối của tệp 3
sẽ chứa IEEE NaN, trong khi các cột E và F không liên kết của cùng một tệp sẽ chứa
các giá trị -1 và -100 tương ứng. Tất nhiên, trong đó các giá trị trống phổ biến và cụ thể là
được chỉ định cho cùng một cột, giá trị trống cụ thể được sử dụng.

Để phân biệt tệp nào là các thành phần không trống của một hàng nhất định, -s (trạng thái) chuyển đổi
có thể được sử dụng để thêm một cột bitmask có tên "JFILES" vào tệp đầu ra. Trong cột này, một
bit được đặt cho mỗi tệp không trống tạo ra hàng nhất định, với bit 0 tương ứng với
tệp đầu tiên, bit 1 đến tệp thứ hai, v.v. Bản thân tên tệp được lưu trữ trong
tiêu đề FITS dưới dạng các tham số có tên JFILE1, JFILE2, v.v. -S col chuyển đổi cho phép bạn
thay đổi tên của cột trạng thái từ "JFILES" mặc định.

Một phép nối giữa các hàng là tích Descartes của tất cả các hàng trong một tệp có một phép nối nhất định
giá trị cột với tất cả các hàng trong tệp thứ hai có cùng giá trị cho cột nối của nó và
Sớm. Do đó, nếu file1 có 2 hàng với giá trị cột tham gia là 100, thì file2 có 3 hàng với
cùng giá trị và tệp 3 có 4 hàng, khi đó kết quả kết quả là 2 * 3 * 4 = 24 hàng được xuất.

Thuật toán nối xử lý trực tiếp tệp chỉ mục được liên kết với cột nối của
mỗi tệp. Giá trị nhỏ nhất của tất cả các cột hiện tại được chọn làm cơ sở và giá trị này
giá trị được sử dụng để nối các cột có giá trị bằng nhau trong các tệp khác. Theo cách này, chỉ mục
các tệp được duyệt chính xác một lần.

Sản phẩm -t tol công tắc chỉ định giá trị dung sai cho các cột số. Hiện tại, một
giá trị dung sai chỉ có thể nối hai tệp cùng một lúc. (Một thuật toán hoàn toàn khác là
bắt buộc phải kết hợp nhiều hơn hai tệp bằng cách sử dụng một dung sai, chúng tôi có thể cân nhắc
triển khai trong tương lai.)

Ví dụ sau đây cho thấy nhiều tính năng của funjoin. Các tệp đầu vào t1.fits,
t2.fits và t3.fits chứa các cột sau:

[sh] quỹ tài chính t1.fits
AKEY KEY AB
------------- ------ ------ ------
aa 0 0 1
bb 1 3 4
ccc 2 6 7
đd 3 9 10
ê 4 12 13
ff 5 15 16
ggg 6 18 19
ồ 7 21 22

quỹ t2.fits
AKEY KEY CD
------------- ------ ------ ------
iii 8 24 25
ggg 6 18 19
ê 4 12 13
ccc 2 6 7
aa 0 0 1

quỹ 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

Với các tệp đầu vào này, lệnh funjoin sau:

funjoin -s -a1 "-B" -a2 "-D" -a3 "-E" -b \
"MỘT CHÌA KHÓA:???" -b1 "AKEY: XXX, A: 255" -b3 "G: NaN, E: -1, F: -100" \
-j phím t1.fits t2.fits t3.fits foo.fits

sẽ nối các tệp trên cột KEY, xuất ra tất cả các cột ngoại trừ B (trong t1.fits), D (trong
t2.fits) và E (trong t3.fits) và đặt các giá trị trống cho AKEY (trên toàn cầu, nhưng bị ghi đè
cho t1.fits) và A (trong tệp 1) và G, E và F (trong tệp 3). Cột JFILES sẽ là
đầu ra để gắn cờ các tệp nào đã được sử dụng trong mỗi hàng:

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
đd 3 9 ??? 0 0 ddd 3 10 400.40 5
ê 4 12 ê 4 12 ??? 0 -100 nan 3
ff 5 15 ??? 0 0 ??? 0 -100 nan 1
ggg 6 18 ggg 6 18 ggg 6 19 100.10 7
hơ 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

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