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

CHƯƠNG TRÌNH:

TÊN

funcnts - đếm các photon trong các vùng cụ thể, với phép trừ bkgd

SYNOPSIS

mặt cười [công tắc] [source_region] [bkgd_file] [bkgd_region⎪bkgd_value]

LỰA CHỌN

-e "source_exposure [; bkgd_exposure]"
# source (bkgd) FITS hình ảnh phơi sáng bằng cách sử dụng các tệp phù hợp
-w "source_exposure [; bkgd_exposure]"
# source (bkgd) Hình ảnh phơi sáng FITS sử dụng biến đổi WCS
-t "source_timecorr [; bkgd_timecorr]"
# source (bkgd) giá trị hiệu chỉnh thời gian hoặc tên thông số tiêu đề
-g # đầu ra sử dụng định dạng g đẹp
-G # đầu ra sử dụng định dạng% .14g (độ chính xác tối đa)
-i "[column;] int1; int2 ..." # khoảng dựa trên cột
-m # khớp với từng khu vực nguồn và bkgd riêng lẻ
-p # đầu ra tính bằng pixel, ngay cả khi có wcs
-r # xuất bán kính trong / ngoài (và các góc) cho hình khuyên (và gấu trúc)
-s # giá trị tổng hợp đầu ra
-v "scol [; bcol]" # cột giá trị src và bkgd cho bảng
-T # đầu ra ở định dạng starbase / rdb
-z # vùng đầu ra có vùng bằng không

MÔ TẢ

mặt cười đếm các photon trong các vùng nguồn được chỉ định và báo cáo kết quả cho từng
khu vực. Các vùng được chỉ định bằng cách sử dụng cơ chế Lọc vùng không gian. Các photon là
cũng được tính trong các vùng bkgd được chỉ định áp dụng cho cùng một tệp dữ liệu hoặc một tệp dữ liệu khác
tập tin dữ liệu. (Ngoài ra, giá trị nền không đổi về số lượng / pixel ** 2 có thể là
được chỉ định.) Các vùng bkgd được ghép nối XNUMX-XNUMX với các vùng nguồn hoặc được gộp chung
và chuẩn hóa theo khu vực, sau đó được trừ khỏi số lượng nguồn trong mỗi khu vực.
Kết quả được hiển thị bao gồm tổng số bkgd đã trừ trong mỗi khu vực, cũng như lỗi
về số lượng, diện tích trong từng vùng và độ sáng bề mặt (cnts / area ** 2)
tính cho từng vùng.

Đối số đầu tiên của chương trình chỉ định hình ảnh đầu vào FITS, mảng hoặc tệp sự kiện thô
để xử lý. 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, phần hình ảnh và bộ lọc.

Đối số thứ hai tùy chọn là bộ mô tả vùng nguồn. Nếu không có vùng nào được chỉ định,
toàn bộ lĩnh vực được sử dụng.

Các đối số nền có thể có một trong hai dạng, tùy thuộc vào việc
tệp nền được chỉ định. Nếu tệp nguồn cũng được sử dụng cho nền,
đối số thứ ba có thể là vùng nền hoặc một giá trị không đổi biểu thị
cnts / pixel nền. Ngoài ra, đối số thứ ba có thể là tệp dữ liệu nền,
trong trường hợp đó đối số thứ tư là vùng nền. Nếu không có đối số thứ ba là
được chỉ định, một giá trị không đổi của 0 được sử dụng (tức là không có nền).

Tóm lại, các đối số lệnh sau là hợp lệ:

[sh] funcnts sfile # counts trong tệp nguồn
[sh] funcnts sregion sregion # counts trong vùng nguồn
[sh] funcnts sfile sregion bregion # bkgd reg. là từ tệp nguồn
[sh] funcnts sfile sregion bvalue # bkgd reg. là không đổi
[sh] funcnts sfile sregion bfile bregion # bkgd reg. là từ tệp riêng biệt

NB: không giống như các chương trình Funtools khác, vùng nguồn và vùng nền được chỉ định là
các đối số riêng biệt trên dòng lệnh, thay vì được đặt bên trong dấu ngoặc như một phần
tên tệp nguồn và nền. Điều này là do các vùng trong các phễu không chỉ đơn giản là
được sử dụng làm bộ lọc dữ liệu, nhưng cũng được sử dụng để tính toán diện tích, độ phơi sáng, v.v. Nếu bạn đặt
vùng nguồn bên trong dấu ngoặc (tức là sử dụng nó đơn giản như một bộ lọc) thay vì chỉ định
như đối số hai, chương trình vẫn sẽ chỉ đếm các photon vượt qua bộ lọc vùng.
Tuy nhiên, việc tính toán diện tích sẽ được thực hiện trên toàn bộ trường, vì đồng ruộng() là
vùng nguồn mặc định. Đây hiếm khi là hành vi mong muốn. Mặt khác, với FITS
bảng nhị phân, thường hữu ích khi đặt bộ lọc cột trong dấu ngoặc nhọn tên tệp, để
chỉ các sự kiện phù hợp với bộ lọc cột mới được tính trong khu vực.

Ví dụ: để trích xuất số lượng trong bán kính 22 pixel từ tâm của
FITS bảng nhị phân snr.ev và trừ nền được xác định từ cùng một hình ảnh bên trong
hình khuyên bán kính 50-100 pixel:

[sh] funcnts snr.ev "circle (502,512,22)" "annulus (502,512,50,100)"
# nguồn
# tệp dữ liệu: snr.ev
# độ / pix: 0.00222222
# lai lịch
# tệp dữ liệu: snr.ev
# đơn vị cột
# khu vực: arcsec ** 2
# lướt_bri: cnts / arcsec ** 2
# Sur_err: cnts / arcsec ** 2

# kết quả trừ nền
reg net_counts lỗi nền lỗi khu vực lướt_bri Sur_err
---- ------------ ------------ ------------ --------- ---- ----- --------- ---------
1 3826.403 66.465 555.597 5.972 96831.98 0.040 0.001

# nguồn và các thành phần nền sau đã được sử dụng:
(các) vùng nguồn
----------------
vòng tròn (502,512,22)

reg đếm pixel
---- ------------ ---------
1 4382.000 1513

(các) vùng nền
--------------------
annulus (502,512,50,100)

reg đếm pixel
---- ------------ ---------
tất cả 8656.000 23572

Đơn vị diện tích cho các cột đầu ra có nhãn "vùng", "lướt_bri" (độ sáng bề mặt) và
"Sur_err" sẽ được cung cấp trong vòng cung giây (nếu thông tin WCS thích hợp có trong
(các) tiêu đề tệp dữ liệu hoặc tính bằng pixel. Nếu tệp dữ liệu có thông tin WCS, nhưng bạn không muốn cung cấp-
đơn vị thứ hai, sử dụng -p chuyển sang đầu ra lực lượng tính bằng pixel. Ngoài ra, các khu vực không có khu vực
thường không được bao gồm trong bảng chính (đã trừ nền), nhưng được bao gồm
trong nguồn thứ cấp và bảng bkgd. Nếu bạn muốn các vùng này được đưa vào
bảng chính, sử dụng -z công tắc điện.

Lưu ý rằng một lệnh sed đơn giản sẽ trích xuất các kết quả trừ nền để biết thêm
phân tích:

[sh] mèo funcnts.sed
1, / ----. * / D
/ ^ $ /, $ d

[sh] sed -f funcnts.sed funcnts.out
1 3826.403 66.465 555.597 5.972 96831.98 0.040 0.001

Nếu các tệp nguồn và nền riêng biệt được chỉ định, mặt cười sẽ cố gắng bình thường hóa
vùng nền để kích thước pixel nền giống với pixel nguồn
kích thước. Quá trình chuẩn hóa này chỉ có thể diễn ra nếu thông tin WCS thích hợp là
được chứa trong cả hai tệp (ví dụ: giá trị độ / pixel trong CDELT). Nếu một trong hai tệp không
chứa thông tin kích thước cần thiết, quá trình chuẩn hóa không được thực hiện. Trong trường hợp này,
người dùng có trách nhiệm đảm bảo rằng kích thước pixel giống nhau cho cả hai
các tập tin.

Thông thường, nếu nhiều vùng nền được chỉ định, mặt cười sẽ kết hợp tất cả
vào một vùng duy nhất và sử dụng vùng nền này để tạo ra nền đã trừ
kết quả cho từng vùng nguồn. Các -m (khớp với nhiều nền) chuyển đổi cho biết mặt cười
để tạo sự tương ứng XNUMX-XNUMX giữa vùng nền và vùng nguồn, thay vì
sử dụng một vùng nền kết hợp duy nhất. Ví dụ: trường hợp mặc định là kết hợp 2
các vùng nền vào một vùng duy nhất và sau đó áp dụng vùng đó cho từng nguồn
vùng:

[sh] funcnts snr.ev "annulus (502,512,0,22, n = 2)" "annulus (502,512,50,100, n = 2)"
# nguồn
# tệp dữ liệu: snr.ev
# độ / pix: 0.00222222
# lai lịch
# tệp dữ liệu: snr.ev
# đơn vị cột
# khu vực: arcsec ** 2
# lướt_bri: cnts / arcsec ** 2
# Sur_err: cnts / arcsec ** 2

# kết quả trừ nền
reg net_counts lỗi nền lỗi khu vực lướt_bri Sur_err
---- ------------ ------------ ------------ --------- ---- ----- --------- ---------
1 3101.029 56.922 136.971 1.472 23872.00 0.130 0.002
2 725.375 34.121 418.625 4.500 72959.99 0.010 0.000

# nguồn và các thành phần nền sau đã được sử dụng:
(các) vùng nguồn
----------------
annulus (502,512,0,22, n = 2)

reg đếm pixel
---- ------------ ---------
1 3238.000 373
2 1144.000 1140

(các) vùng nền
--------------------
annulus (502,512,50,100, n = 2)

reg đếm pixel
---- ------------ ---------
tất cả 8656.000 23572

Lưu ý rằng quy tắc bộ lọc vùng cơ bản "mỗi photon được đếm một lần và không có photon nào được
được tính nhiều hơn một lần "vẫn được áp dụng khi sử dụng -m để phù hợp với các vùng nền. Điều đó
là, nếu hai vùng nền chồng lên nhau, các pixel chồng chéo sẽ chỉ được tính trong một
của họ. Trong trường hợp xấu nhất, nếu hai vùng nền là cùng một vùng,
đầu tiên sẽ nhận được tất cả các số đếm và diện tích và thứ hai sẽ không nhận được.

Sử dụng -m chuyển đổi nguyên nhân mặt cười để sử dụng độc lập từng vùng trong số hai vùng nền
với mỗi vùng trong số hai vùng nguồn:

[sh] funcnts -m snr.ev "annulus (502,512,0,22, n = 2)" "ann (502,512,50,100, n = 2)"
# nguồn
# tệp dữ liệu: snr.ev
# độ / pix: 0.00222222
# lai lịch
# tệp dữ liệu: snr.ev
# đơn vị cột
# khu vực: arcsec ** 2
# lướt_bri: cnts / arcsec ** 2
# Sur_err: cnts / arcsec ** 2

# kết quả trừ nền
reg net_counts lỗi nền lỗi khu vực lướt_bri Sur_err
---- ------------ ------------ ------------ --------- ---- ----- --------- ---------
1 3087.015 56.954 150.985 2.395 23872.00 0.129 0.002
2 755.959 34.295 388.041 5.672 72959.99 0.010 0.000

# nguồn và các thành phần nền sau đã được sử dụng:
(các) vùng nguồn
----------------
annulus (502,512,0,22, n = 2)

reg đếm pixel
---- ------------ ---------
1 3238.000 373
2 1144.000 1140

(các) vùng nền
--------------------
ann (502,512,50,100, n = 2)

reg đếm pixel
---- ------------ ---------
1 3975.000 9820
2 4681.000 13752

Lưu ý rằng hầu hết các đại lượng dấu phẩy động được hiển thị bằng định dạng "f". Bạn có thể thay đổi
định dạng này sang định dạng "g" bằng cách sử dụng -g chuyển. Điều này có thể hữu ích khi số lượng trong mỗi pixel
là rất nhỏ hoặc rất lớn. Nếu bạn muốn có độ chính xác tối đa và không quan tâm đến
cột xếp hàng đẹp, sử dụng -G, xuất ra tất cả các giá trị nổi dưới dạng% .14g.

Khi đếm các photon bằng hình khuyên và hình gấu trúc (bánh và hình khuyên), nó thường là
hữu ích để có quyền truy cập vào bán kính (và góc gấu trúc) cho từng vùng riêng biệt. Các -r
switch sẽ thêm các cột bán kính và góc vào bảng đầu ra:

[sh] funcnts -r snr.ev "annulus (502,512,0,22, n = 2)" "ann (502,512,50,100, n = 2)"
# nguồn
# tệp dữ liệu: snr.ev
# độ / pix: 0.00222222
# lai lịch
# tệp dữ liệu: snr.ev
# đơn vị cột
# khu vực: arcsec ** 2
# lướt_bri: cnts / arcsec ** 2
# Sur_err: cnts / arcsec ** 2
# bán kính: arcsecs
# góc: độ

# kết quả trừ nền
reg net_counts lỗi nền lỗi khu vực lướt_bri lướt_err bán kính1 bán kính2 góc1 góc2
---- ------------ ------------ ------------ --------- ---- ----- --------- --------- --------- --------- --------- ---------
1 3101.029 56.922 136.971 1.472 23872.00 0.130 0.002 0.00 88.00 NA NA
2 725.375 34.121 418.625 4.500 72959.99 0.010 0.000 88.00 176.00 NA NA

# nguồn và các thành phần nền sau đã được sử dụng:
(các) vùng nguồn
----------------
annulus (502,512,0,22, n = 2)

reg đếm pixel
---- ------------ ---------
1 3238.000 373
2 1144.000 1140

(các) vùng nền
--------------------
ann (502,512,50,100, n = 2)

reg đếm pixel
---- ------------ ---------
tất cả 8656.000 23572

Bán kính được tính theo đơn vị pixel hoặc cung-giây (tùy thuộc vào sự hiện diện của thông tin WCS),
trong khi các giá trị góc (khi có mặt) là độ. Các cột này có thể được sử dụng để vẽ
biên dạng xuyên tâm. Ví dụ, script funcnts.plot trong phân phối funtools) sẽ
vẽ một cấu hình xuyên tâm bằng gnuplot (phiên bản 3.7 trở lên). Một phiên bản đơn giản của điều này
script được hiển thị bên dưới:

#!/ Bin / sh

if [x "$ 1" = xgnuplot]; sau đó
if [x`which gnuplot 2> / dev / null` = x]; sau đó
echo "LỖI: gnuplot không khả dụng"
thoát 1
fi
awk '
BEGIN {HEADER = 1; DỮ LIỆU = 0; FILES = ""; XLABEL = "không xác định"; YLABEL = "không xác định"}
HEADER == 1 {
if ($ 1 == "#" && $ 2 == "data" && $ 3 == "tệp:") {
if (FILES! = "") FILES = FILES ","
FILES = FILES $ 4
}
khác nếu ($ 1 == "#" && $ 2 == "bán kính:") {
XLABEL = $ 3
}
khác nếu ($ 1 == "#" && $ 2 == "Sur_bri:") {
YLABEL = $ 3
}
khác nếu ($ 1 == "----") {
printf "set nokey; set title \" funcnts (% s) \ "\ n", FILES
printf "đặt xlabel \" radius (% s) \ "\ n", XLABEL
printf "đặt ylabel \" Sur_bri (% s) \ "\ n", YLABEL
in "plot \" - \ "sử dụng 3: 4: 6: 7: 8 với boxerrorbars"
ĐẦU = 0
DỮ LIỆU = 1
tiếp theo
}
}
DỮ LIỆU == 1 {
nếu (NF == 12) {
in $ 9, $ 10, ($ 9 + $ 10) / 2, $ 7, $ 8, $ 7- $ 8, $ 7 + $ 8, $ 10- $ 9
}
khác {
ra
}
}
'⎪ gnuplot -persist - 1> / dev / null 2> & 1

elif [x "$ 1" = xds9]; sau đó
awk '
BEGIN {HEADER = 1; DỮ LIỆU = 0; XLABEL = "không xác định"; YLABEL = "không xác định"}
HEADER == 1 {
if ($ 1 == "#" && $ 2 == "data" && $ 3 == "tệp:") {
if (FILES! = "") FILES = FILES ","
FILES = FILES $ 4
}
khác nếu ($ 1 == "#" && $ 2 == "bán kính:") {
XLABEL = $ 3
}
khác nếu ($ 1 == "#" && $ 2 == "Sur_bri:") {
YLABEL = $ 3
}
khác nếu ($ 1 == "----") {
printf "bán kính phễu (% s) (% s) Sur_bri (% s) 3 \ n", FILES, XLABEL, YLABEL
ĐẦU = 0
DỮ LIỆU = 1
tiếp theo
}
}
DỮ LIỆU == 1 {
nếu (NF == 12) {
in $ 9, $ 7, $ 8
}
khác {
ra
}
}
'
khác
echo "funcnts -r ... ⎪ funcnts.plot [ds9⎪gnuplot]"
thoát 1
fi

Do đó, để chạy mặt cười và vẽ biểu đồ kết quả bằng gnuplot (phiên bản 3.7 trở lên), sử dụng:

funcnts -r snr.ev "annulus (502,512,0,50, n = 5)" ... ⎪ funcnts.plot gnuplot

Sản phẩm -s (tổng hợp) nguyên nhân chuyển đổi mặt cười để tạo thêm một bảng tổng hợp (tích hợp)
các giá trị bị trừ trong nền, cùng với bảng mặc định của các giá trị riêng lẻ:

[sh] funcnts -s snr.ev "annulus (502,512,0,50, n = 5)" "annulus (502,512,50,100)"
# nguồn
# tệp dữ liệu: snr.ev
# độ / pix: 0.00222222
# lai lịch
# tệp dữ liệu: snr.ev
# đơn vị cột
# khu vực: arcsec ** 2
# lướt_bri: cnts / arcsec ** 2
# Sur_err: cnts / arcsec ** 2

# kết quả tổng trừ nền trừ
upto net_counts lỗi nền lỗi khu vực lướt_bri Sur_err
---- ------------ ------------ ------------ --------- ---- ----- --------- ---------
1 2880.999 54.722 112.001 1.204 19520.00 0.148 0.003
2 3776.817 65.254 457.183 4.914 79679.98 0.047 0.001
3 4025.492 71.972 1031.508 11.087 179775.96 0.022 0.000
4 4185.149 80.109 1840.851 19.786 320831.94 0.013 0.000
5 4415.540 90.790 2873.460 30.885 500799.90 0.009 0.000

# kết quả trừ nền
reg đếm lỗi nền khu vực berror lướt_bri Sur_err
---- ------------ ------------ ------------ --------- ---- ----- --------- ---------
1 2880.999 54.722 112.001 1.204 19520.00 0.148 0.003
2 895.818 35.423 345.182 3.710 60159.99 0.015 0.001
3 248.675 29.345 574.325 6.173 100095.98 0.002 0.000
4 159.657 32.321 809.343 8.699 141055.97 0.001 0.000
5 230.390 37.231 1032.610 11.099 179967.96 0.001 0.000

# nguồn và các thành phần nền sau đã được sử dụng:
(các) vùng nguồn
----------------
annulus (502,512,0,50, n = 5)

reg đếm pixel sumcnts sumpix
---- ------------ ------------ ------------ ---------
1 2993.000 305 2993.000 305
2 1241.000 940 4234.000 1245
3 823.000 1564 5057.000 2809
4 969.000 2204 6026.000 5013
5 1263.000 2812 7289.000 7825

(các) vùng nền
--------------------
annulus (502,512,50,100)

reg đếm pixel
---- ------------ ---------
tất cả 8656.000 23572

Sản phẩm -t và -e các công tắc có thể được sử dụng để áp dụng các hiệu chỉnh về thời gian và độ phơi sáng tương ứng,
vào dữ liệu. Xin lưu ý rằng những chỉnh sửa này nhằm mục đích sử dụng một cách định tính, vì
việc áp dụng các yếu tố hiệu chỉnh chính xác hơn là một nỗ lực phức tạp và phụ thuộc vào nhiệm vụ.
Thuật toán áp dụng các hiệu chỉnh đơn giản này như sau:

C = Tổng số thô trong Vùng nguồn
Ac = Diện tích Vùng nguồn
Tc = Thời gian tiếp xúc cho Dữ liệu nguồn
Ec = Mức độ phơi sáng trung bình trong Vùng Nguồn, từ bản đồ phơi sáng

B = Tổng số thô trong vùng nền
Ab = Diện tích của Vùng nền
Tb = (Phơi sáng) thời gian cho Dữ liệu Nền
Eb = Độ phơi sáng trung bình trong Vùng nền, từ bản đồ phơi sáng

Sau đó, Tổng số Thực trong vùng Nguồn là

Net = C - B * (Ac * Tc * Ec) / (Ab * Tb * Eb)

với sự lan truyền chuẩn của lỗi cho Lỗi trên mạng. Tỷ lệ ròng sau đó sẽ là

Tỷ lệ ròng = Net / (Ac * Tc * Ec)

Mức độ phơi sáng trung bình ở mỗi khu vực được tính bằng cách tính tổng các giá trị pixel trong
bản đồ phơi sáng cho khu vực nhất định và sau đó chia cho số pixel trong đó
khu vực. Bản đồ phơi sáng thường được tạo ở hệ số khối> 1 (ví dụ: khối 4 có nghĩa là
mỗi pixel phơi sáng chứa 4x4 pixel ở độ phân giải đầy đủ) và mặt cười sẽ đối phó với
tự động chặn. Sử dụng -e chuyển đổi, bạn có thể cung cấp cả nguồn và nền
tệp hiển thị (được phân tách bằng ";"), nếu bạn có tệp dữ liệu nguồn và dữ liệu nền riêng biệt.
Nếu bạn không cung cấp tệp hiển thị nền để đi với dữ liệu nền riêng
tập tin, mặt cười giả định rằng độ phơi sáng đã được áp dụng cho tệp dữ liệu nền.
Ngoài ra, nó giả định rằng lỗi trên các pixel trong tệp dữ liệu nền bằng không.

Lưu ý: -e switch giả định rằng bản đồ phơi sáng phủ lên tệp hình ảnh chính xác, ngoại trừ
cho hệ số khối. Mỗi pixel trong hình ảnh được chia tỷ lệ theo hệ số khối để truy cập
pixel tương ứng trong bản đồ phơi sáng. Nếu bản đồ phơi sáng của bạn không thẳng hàng chính xác
với hình ảnh, do không sử dụng các -e hiệu chỉnh độ phơi sáng. Trong trường hợp này, nó vẫn có thể
để thực hiện hiệu chỉnh độ phơi sáng if cả hình ảnh và bản đồ phơi sáng đều có WCS hợp lệ
thông tin: sử dụng -w chuyển đổi để chuyển đổi từ pixel hình ảnh sang độ phơi sáng
pixel sử dụng thông tin WCS. Nghĩa là, mỗi pixel trong vùng hình ảnh sẽ
trước tiên được chuyển đổi từ tọa độ hình ảnh sang tọa độ bầu trời, sau đó từ tọa độ bầu trời sang
tọa độ phơi sáng. Xin lưu ý rằng sử dụng -w có thể tăng thời gian cần thiết để xử lý
hiệu chỉnh độ phơi sáng đáng kể.

Hiệu chỉnh thời gian có thể được áp dụng cho cả dữ liệu nguồn và dữ liệu nền bằng cách sử dụng -t công tắc điện.
Giá trị cho việc sửa có thể là một hằng số hoặc tên của tiêu đề
tham số trong tệp nguồn (hoặc nền):

[sh] funcnts -t 23.4 ... # số cho nguồn
[sh] funcnts -t "LIVETIME; 23.4" ... # param cho nguồn, số cho bkgd

Khi hiệu chỉnh thời gian được chỉ định, nó cũng được áp dụng cho số lượng thực (xem
thuật toán trên), để các đơn vị độ sáng bề mặt trở thành cnts / area ** 2 / giây.

Sản phẩm -i (khoảng thời gian) chuyển đổi được sử dụng để chạy mặt cười trên nhiều khoảng thời gian dựa trên cột với
chỉ một lần đi qua dữ liệu. Nó tương đương với việc chạy mặt cười vài lần
với một bộ lọc cột khác được thêm vào dữ liệu nguồn và dữ liệu nền mỗi lần. Cho mỗi
khoảng thời gian, toàn bộ mặt cười đầu ra được tạo, với một ký tự dòng cấp (^ L) được chèn
giữa mỗi lần chạy. Ngoài ra, đầu ra cho mỗi khoảng sẽ chứa khoảng
đặc điểm kỹ thuật trong tiêu đề của nó. Khoảng thời gian rất hữu ích để tạo ra độ cứng của tia X
tỷ lệ hiệu quả. Tất nhiên, chúng chỉ được hỗ trợ khi chứa dữ liệu đầu vào
trong một bảng.

Hai định dạng được hỗ trợ cho đặc điểm kỹ thuật khoảng thời gian. Định dạng chung nhất là bán
danh sách các bộ lọc được phân tách bằng dấu hai chấm sẽ được sử dụng như các khoảng thời gian:

funcnts -i "pha = 1: 5; pha = 6: 10; pha = 11: 15" snr.ev "circle (502,512,22)" ...

Về mặt khái niệm, điều này sẽ tương đương với việc chạy mặt cười ba lần:

funcnts snr.ev '[pha = 1: 5]' "vòng kết nối (502,512,22)"
funcnts snr.ev '[pha = 6: 10]' "vòng kết nối (502,512,22)"
funcnts snr.ev '[pha = 11: 15]' "vòng kết nối (502,512,22)"

Tuy nhiên, bằng cách sử dụng -i chuyển đổi sẽ chỉ yêu cầu một lần chuyển qua dữ liệu.

Lưu ý rằng các bộ lọc phức tạp có thể được sử dụng để chỉ định các khoảng thời gian:

funcnts -i "pha=1:5&&pi=4;pha=6:10&&pi=5;pha=11:15&&pi=6" snr.ev ...

Chương trình chỉ đơn giản là chạy dữ liệu lần lượt qua từng bộ lọc và tạo ra ba mặt cười
kết quả đầu ra, được phân tách bằng ký tự nguồn cấp dữ liệu dòng.

Trên thực tế, mặc dù mục đích là hỗ trợ các khoảng cho tỷ lệ độ cứng,
bộ lọc không nhất thiết phải có khoảng thời gian. Cũng không nhất thiết phải có một bộ lọc "khoảng thời gian"
liên quan đến cái khác. Ví dụ:

funcnts -i "pha = 1: 5; pi = 6: 10; energy = 11: 15" snr.ev "circle (502,512,22)" ...

tương đương với chạy mặt cười ba lần với các thông số kỹ thuật của bộ lọc không liên quan.

Định dạng khoảng thứ hai được hỗ trợ cho trường hợp đơn giản, trong đó một cột duy nhất được sử dụng
để chỉ định nhiều khoảng đồng nhất cho cột đó. Trong định dạng này, một tên cột
được chỉ định đầu tiên, tiếp theo là các khoảng:

funcnts -i "pha; 1: 5; 6: 10; 11: 15" snr.ev "circle (502,512,22)" ...

Điều này tương đương với ví dụ đầu tiên, nhưng yêu cầu nhập ít hơn. Các mặt cười chương trình
sẽ chỉ cần thêm "pha =" trước mỗi khoảng thời gian được chỉ định. (Lưu ý rằng định dạng này
không chứa ký tự "=" trong đối số cột.)

Thông thường, khi mặt cười được chạy trên bảng nhị phân FITS (hoặc bảng sự kiện thô), một
số tích phân được tích lũy cho mỗi hàng (sự kiện) chứa trong một vùng nhất định. Các -v
"scol [; bcol]" (cột giá trị) sẽ tích lũy số lượng bằng cách sử dụng giá trị từ
cột được chỉ định cho sự kiện đã cho. Nếu chỉ một cột duy nhất được chỉ định, nó được sử dụng cho
cả vùng nguồn và vùng nền. Hai cột riêng biệt, được phân tách bằng dấu chấm phẩy,
có thể được chỉ định cho nguồn và nền. Mã thông báo đặc biệt '$ none' có thể được sử dụng để
chỉ định rằng một cột giá trị sẽ được sử dụng cho một chứ không phải cột kia. Ví dụ,
'pha; $ none' sẽ sử dụng cột pha cho nguồn nhưng sử dụng số tích phân cho
background, trong khi '$ none; pha' sẽ làm ngược lại. Nếu cột giá trị thuộc loại
logic, khi đó giá trị được sử dụng sẽ là 1 cho T và 0 cho F. Các cột giá trị được sử dụng, cho
ví dụ, để tích hợp xác suất thay vì đếm tích phân.

Nếu -T (bảng rdb) được sử dụng, đầu ra sẽ tuân theo cơ sở dữ liệu starbase / rdb
format: các tab sẽ được chèn giữa các cột thay vì khoảng trắng và nguồn cấp dữ liệu dòng sẽ
được chèn giữa các bảng.

Cuối cùng, lưu ý rằng mặt cười là một chương trình hình ảnh, mặc dù nó có thể chạy trực tiếp trên FITS
bảng nhị phân. Điều này có nghĩa là lọc hình ảnh được áp dụng cho các hàng để đảm bảo
rằng các kết quả giống nhau đều thu được bất kể bảng hoặc bảng tương đương được xếp
hình ảnh được sử dụng. Tuy nhiên, vì điều này, số lượng được tìm thấy bằng cách sử dụng mặt cười có thể
khác với số lượng sự kiện được tìm thấy bằng cách sử dụng các chương trình lọc hàng, chẳng hạn như quỹ đầu tư or
mềm dẻo Để biết thêm thông tin về sự khác biệt này, hãy xem phần thảo luận về Khu vực
Ranh giới

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