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

CHƯƠNG TRÌNH:

TÊN

funcone - tìm kiếm hình nón của bảng nhị phân chứa các cột RA, Dec

SYNOPSIS

hình nón [cột]

LỰA CHỌN

-d deccol: [hdr] # Dec tên cột, đơn vị (def: DEC: d)
-j # nối các cột từ tệp danh sách
-J # nối các cột từ tệp danh sách, xuất tất cả các hàng
-l listfile # đọc trung tâm và bán kính từ danh sách
-L listfile # đọc trung tâm và bán kính từ danh sách, xuất các hàng danh sách
-n # không sử dụng giới hạn hình nón làm bộ lọc
-r racol: [hdr] # RA tên cột, đơn vị (def: RA: h)
-x # nối RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols
-X # nối thêm RA_CEN, DEC_CEN, RAD_CEN, CONE_KEY cols, xuất tất cả các hàng

MÔ TẢ

Funcone thực hiện tìm kiếm hình nón trên các cột RA và Dec của bảng nhị phân FITS. Các
khoảng cách từ tâm RA, vị trí Dec đến RA, Dec ở mỗi hàng trong bảng là
tính toán. Các hàng có khoảng cách nhỏ hơn bán kính được chỉ định sẽ được xuất.

Đố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.

Đối số bắt buộc thứ ba và thứ tư là vị trí trung tâm RA và Dec. Theo mặc định,
RA được chỉ định bằng giờ trong khi Dec được chỉ định bằng độ. Bạn có thể thay đổi các đơn vị của
một trong hai ký tự này bằng cách thêm ký tự "d" (độ), "h" (giờ) hoặc "r" (radian).
Kí hiệu giới tính được hỗ trợ, với dấu hai chấm hoặc dấu cách phân tách hms và dms. (Khi nào
sử dụng dấu cách, hãy đảm bảo rằng toàn bộ chuỗi được trích dẫn.)

Đối số bắt buộc thứ năm là bán kính của tìm kiếm hình nón. Theo mặc định, giá trị bán kính
được tính bằng độ. Các đơn vị có thể được thay đổi bằng cách thêm ký tự "d" (độ),
"r" (radian), "'" (vòng cung phút) hoặc' "'(giây cung).

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 bằng cách sử dụng đối số thứ sáu tùy chọn trong biểu mẫu:

"column1 column1 ... columnN"

Đối số thứ bảy cho phép bạn xuất các cột đã chọn từ tệp danh sách khi -j chuyển đổi
Được sử dụng. Lưu ý rằng cột RA và cột Dec được sử dụng trong tính toán hình nón không được
bỏ chọn.

Cũng theo mặc định, tên cột RA và Dec được đặt tên là "RA" và "Dec", và được đưa vào
đơn vị giờ và độ tương ứng. Bạn có thể thay đổi cả tên và đơn vị bằng cách sử dụng
các công tắc -r [RA] và / hoặc -d [Dec]. Một lần nữa, một trong các "h", "d" hoặc "r" được thêm vào
tên cột để chỉ định đơn vị nhưng trong trường hợp này, phải có dấu hai chấm ":" giữa
tên và đặc điểm kỹ thuật của đơn vị.

Nếu -l [tệp danh sách] công tắc được sử dụng, sau đó một hoặc nhiều trung tâm RA, trung tâm Dec, và
bán kính có thể được lấy từ tệp danh sách (có thể là bảng FITS hoặc văn bản cột ASCII
tập tin). Trong trường hợp này, thứ ba (tâm RA), thứ tư (tâm Dec) và thứ năm (bán kính)
đối số dòng lệnh có thể là tên cột trong tệp danh sách (nếu tham số đó
khác nhau) hoặc giá trị số khác (nếu tham số đó là tĩnh). Khi tên cột là
được chỉ định cho RA, Dec hoặc radius, bạn có thể thêm dấu hai chấm theo sau là "h", "d" hoặc "r"
để chỉ định đơn vị (cũng là 'và "cho bán kính). Thuật toán tìm kiếm hình nón được chạy một lần cho mỗi
hàng trong danh sách, lấy các giá trị RA, Dec và radius từ các cột được chỉ định hoặc từ
giá trị số tĩnh được chỉ định trên dòng lệnh.

Khi sử dụng danh sách, tất cả các hàng hợp lệ từ mỗi lần lặp được ghi vào một tệp đầu ra duy nhất.
Sử dụng -x để giúp xác định dòng nào của tệp danh sách đã được sử dụng để tạo ra
(các) hàng đầu ra đã cho. Công tắc này tạo ra các giá trị cho tâm RA, Dec, bán kính và
số hàng được nối vào tệp đầu ra, trong các cột được gọi là RA_CEN, DEC_CEN, RAD_CEN
và CONE_KEY, tương ứng. Ngoài ra, -j (tham gia) chuyển đổi sẽ nối tất cả các cột
từ hàng danh sách đến hàng đầu ra (về cơ bản là một phép nối của hàng danh sách và hàng đầu vào),
cùng với số hàng CONE_KEY. Hai công tắc này loại trừ lẫn nhau.

Sản phẩm -X và -J thiết bị chuyển mạch ghi ra cùng một dữ liệu như các bản sao chữ thường của chúng cho mỗi
hàng thỏa mãn một tìm kiếm hình nón. Ngoài ra, các công tắc này cũng viết ra các hàng từ
tệp sự kiện không thỏa mãn bất kỳ tìm kiếm hình nón nào. Trong những trường hợp như vậy, cột CONE_KEY đó sẽ
được cung cấp giá trị -1 và thông tin vị trí trung tâm và danh sách sẽ được đặt thành XNUMX
cho hàng đã cho. Do đó, tất cả các hàng của tệp sự kiện đầu vào được đảm bảo là đầu ra,
với các hàng đáp ứng ít nhất một tìm kiếm hình nón có thông tin tìm kiếm bổ sung.

Sản phẩm -L chuyển đổi hoạt động tương tự như -l chuyển đổi trong đó nó lấy các trung tâm từ một tệp danh sách.
Tuy nhiên, nó cũng đặt ngầm chuyển đổi -j, để các hàng đầu ra là phần nối của
hàng sự kiện đầu vào và hàng vị trí trung tâm. Ngoài ra, công tắc này cũng viết ra tất cả
các hàng vị trí trung tâm mà không có sự kiện nào đáp ứng tiêu chí tìm kiếm hình nón của hàng đó.
Cột CONE_KEY sẽ có giá trị là -2 cho các hàng chính giữa không gần với bất kỳ
hàng dữ liệu và các cột sự kiện sẽ bị xóa đối với các hàng như vậy. Bằng cách này, tất cả các trung tâm
hàng được đảm bảo xuất ra ít nhất một lần.

Nếu bất kỳ "tất cả các hàng" chuyển đổi (-X, -J, hoặc là -L) được chỉ định, sau đó một cột mới có tên JSTAT
được thêm vào bảng đầu ra. Các giá trị dương trong cột này cho biết trung tâm
vị trí số hàng (bắt đầu từ 1) trong tệp danh sách mà hàng dữ liệu này thành công
phù hợp trong một tìm kiếm hình nón. Giá trị -1 có nghĩa là hàng dữ liệu không khớp với bất kỳ trung tâm nào
Chức vụ. Giá trị -2 có nghĩa là vị trí trung tâm không được khớp với bất kỳ hàng dữ liệu nào.

Cho một vị trí tâm và bán kính, thuật toán tìm kiếm hình nón sẽ tính toán các tham số giới hạn
cho một hộp bao quanh hình nón được chỉ định và chỉ kiểm tra các hàng có giá trị vị trí nằm
trong các giới hạn đó. Đối với các tệp nhỏ, chi phí liên quan đến giới hạn hình nón này
lọc có thể khiến chương trình chạy chậm hơn so với khi tất cả các sự kiện đã được kiểm tra. Bạn có thể
tắt tính năng lọc giới hạn hình nón bằng cách sử dụng -n chuyển đổi để xem liệu điều này có tăng tốc quá trình xử lý hay không
(đặc biệt hữu ích khi xử lý một danh sách lớn các vị trí).

Ví dụ: tìm kiếm hình nón mặc định sử dụng các cột "RA" và "Tháng XNUMX" theo giờ và độ
(tương ứng) và vị trí RA tính bằng giờ, tháng mười hai và bán kính theo độ:

funone in. lợi ích ngoài. lợi ích 23.45 34.56 0.01

Để chỉ định vị trí RA theo độ:

funcone in. lợi ích ngoài. lợi ích 23.45d 34.56 0.01

Để lấy RA và Dec từ danh sách nhưng sử dụng giá trị tĩnh cho bán kính (và cũng có thể viết
thông tin xác định cho từng hàng trong danh sách):

funcone -x -l list.txt in.fits out.fits MYRA MYDec 0.01

Người dùng chỉ định các cột tính bằng độ, vị trí RA tính bằng giờ (ký hiệu hệ thập phân), tháng XNUMX
vị trí tính bằng độ (ký hiệu hệ thập phân) và bán kính tính bằng phút cung:

funcone -r myRa: d -d myDec in.fits out.fits 12: 30: 15.5 30:12 15 '

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