funcnts - Online sa Cloud

PROGRAMA:

NAME

funcnts - bilangin ang mga photon sa mga tinukoy na rehiyon, na may bkgd subtraction

SINOPSIS

mga function [lumipat] [source_region] [bkgd_file] [bkgd_region⎪bkgd_value]

Opsyon

-e "source_exposure[;bkgd_exposure]"
# source (bkgd) KASAMA ang exposure image gamit ang mga tumutugmang file
-w "source_exposure[;bkgd_exposure]"
# source (bkgd) FIT ang exposure image gamit ang WCS transform
-t "source_timecorr[;bkgd_timecorr]"
# source (bkgd) time correction value o pangalan ng parameter ng header
-g # output gamit ang magandang g format
-G # output gamit ang %.14g na format (maximum precision)
-i "[column;]int1;int2..." # column-based na pagitan
-m # tumutugma sa indibidwal na pinagmulan at bkgd na mga rehiyon
-p # na output sa mga pixel, kahit na mayroong wcs
-r # output inner/outer radii (at mga anggulo) para sa annuli (at pandas)
-s # na output ang summed values
-v "scol[;bcol]" # src at bkgd value column para sa mga talahanayan
-T # output sa starbase/rdb na format
-z # mga rehiyon ng output na may zero na lugar

DESCRIPTION

mga function binibilang ang mga photon sa tinukoy na mga rehiyon ng pinagmulan at iniuulat ang mga resulta para sa bawat isa
rehiyon. Tinukoy ang mga rehiyon gamit ang Spatial Region Filtering mechanism. Ang mga photon ay
binibilang din sa mga tinukoy na rehiyon ng bkgd na inilapat sa parehong file ng data o sa ibang
file ng data. (Bilang kahalili, ang isang pare-parehong halaga ng background sa mga bilang/pixel**2 ay maaaring
tinukoy.) Ang mga bkgd na rehiyon ay maaaring ipares isa-sa-isa sa mga pinagmulang rehiyon o pinagsama-sama
at na-normalize ayon sa lugar, at pagkatapos ay ibinawas mula sa mga bilang ng pinagmulan sa bawat rehiyon.
Kasama sa mga ipinapakitang resulta ang mga bilang na ibinawas ng bkgd sa bawat rehiyon, pati na rin ang error
sa mga bilang, ang lugar sa bawat rehiyon, at ang liwanag ng ibabaw (cnts/area**2)
kinakalkula para sa bawat rehiyon.

Ang unang argumento sa programa ay tumutukoy sa FITS input na imahe, array, o raw na file ng kaganapan
para mai-proseso. Kung tinukoy ang "stdin", babasahin ang data mula sa karaniwang input. Gumamit ng Funtools
Bracket Notation upang tukuyin ang mga FITS extension, mga seksyon ng imahe, at mga filter.

Ang opsyonal na pangalawang argumento ay ang source region descriptor. Kung walang tinukoy na rehiyon,
ang buong field ay ginagamit.

Ang mga argumento sa background ay maaaring tumagal ng isa sa dalawang anyo, depende sa kung hiwalay
background file ay tinukoy. Kung ang source file ay gagamitin din para sa background, ang
Ang ikatlong argumento ay maaaring alinman sa background na rehiyon, o isang pare-parehong halaga na nagsasaad
background cnts/pixel. Bilang kahalili, ang ikatlong argumento ay maaaring isang background data file,
kung saan ang ikaapat na argumento ay ang background na rehiyon. Kung walang ikatlong argumento ay
tinukoy, isang pare-parehong halaga ng 0 ang ginagamit (ibig sabihin, walang background).

Sa buod, ang mga sumusunod na argumento ng command ay wasto:

[sh] function na sfile # na bilang sa source file
[sh] functions sfile sregion # counts sa source region
[sh] functions sfile sregion bregion # bkgd reg. ay mula sa source file
[sh] function sfile sregion bvalue # bkgd reg. ay pare-pareho
[sh] function sfile sregion bfile bregion # bkgd reg. ay mula sa hiwalay na file

NB: hindi tulad ng ibang mga programa ng Funtools, ang pinagmulan at background na mga rehiyon ay tinukoy bilang
hiwalay na mga argumento sa command line, sa halip na ilagay sa loob ng mga bracket bilang bahagi
ng pinagmulan at background na mga filename. Ito ay dahil ang mga rehiyon sa mga function ay hindi simple
ginagamit bilang mga filter ng data, ngunit ginagamit din upang kalkulahin ang mga lugar, pagkakalantad, atbp. Kung ilalagay mo ang
pinagmulang rehiyon sa loob ng mga bracket (ibig sabihin, gamitin ito bilang isang filter) sa halip na tukuyin
ito bilang argumento dalawa, bibilangin pa rin ng programa ang mga photon na pumasa sa filter ng rehiyon.
Gayunpaman, ang pagkalkula ng lugar ay isasagawa sa buong field, dahil field() ay ang
default na rehiyon ng pinagmulan. Ito ay bihirang ang nais na pag-uugali. Sa kabilang banda, may FITS
binary table, kadalasan ay kapaki-pakinabang na maglagay ng filter ng hanay sa mga bracket ng filename, nang sa gayon
ang mga kaganapan lamang na tumutugma sa filter ng column ang binibilang sa loob ng rehiyon.

Halimbawa, upang kunin ang mga bilang sa loob ng radius na 22 pixels mula sa gitna ng
FITS binary table snr.ev at ibawas ang background na tinutukoy mula sa parehong larawan sa loob
isang annulus ng radii 50-100 pixels:

[sh] functions snr.ev "circle(502,512,22)" "annulus(502,512,50,100)"
# pinagmulan
# file ng data: snr.ev
# degrees/pix: 0.00222222
# background
# file ng data: snr.ev
# na unit ng column
# lugar: arcsec**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# resultang binawas sa background
reg net_counts error background berror area surf_bri surf_err
---- ------------ --------- ------------ --------- ---- ----- --------- ---------
1 3826.403 66.465 555.597 5.972 96831.98 0.040 0.001

# ang mga sumusunod na bahagi ng pinagmulan at background ay ginamit:
(mga) pinagmulang rehiyon
----------------
bilog(502,512,22)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
+1 4382.000 1513

(mga) background na rehiyon
--------------------
annulus(502,512,50,100)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
lahat 8656.000 23572

Ang mga unit ng lugar para sa mga column ng output na may label na "lugar", "surf_bri" (liwanag ng ibabaw) at
Ang "surf_err" ay ibibigay alinman sa arc-segundo (kung ang naaangkop na impormasyon ng WCS ay nasa
data file header(s)) o sa mga pixel. Kung ang data file ay may impormasyon sa WCS, ngunit hindi mo nais ang arc-
pangalawang yunit, gamitin ang -p lumipat sa puwersang output sa mga pixel. Gayundin, ang mga rehiyon na may zero na lugar
ay hindi karaniwang kasama sa pangunahing (binawas sa background) na talahanayan, ngunit kasama
sa pangalawang pinagmulan at bkgd na mga talahanayan. Kung nais mong mapabilang ang mga rehiyong ito sa
pangunahing talahanayan, gamitin ang -z Lumipat.

Tandaan na ang isang simpleng sed command ay kukuha ng background-subtracted na mga resulta para sa karagdagang
pagsusuri:

[sh] cat 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

Kung nakatukoy ang magkahiwalay na source at background file, mga function ay susubukan na gawing normal
ang lugar sa background upang ang laki ng background na pixel ay pareho sa pinagmulang pixel
laki. Ang normalisasyong ito ay maaari lamang maganap kung ang naaangkop na impormasyon ng WCS ay
nakapaloob sa parehong mga file (hal. degrees/pixel na mga halaga sa CDELT). Kung ang alinman sa file ay hindi
naglalaman ng kinakailangang impormasyon sa laki, hindi ginaganap ang normalisasyon. Sa kasong ito,
responsibilidad ng user na tiyakin na ang mga laki ng pixel ay pareho para sa dalawa
file.

Karaniwan, kung higit sa isang background na rehiyon ang tinukoy, mga function pagsasamahin silang lahat
sa iisang rehiyon at gamitin ang background na rehiyon na ito para makagawa ng background-subtracted
mga resulta para sa bawat pinagmulang rehiyon. Ang -m (tugma sa maraming background) switch ay nagsasabi mga function
upang gumawa ng isa sa isang pagsusulatan sa pagitan ng background at pinagmulang rehiyon, sa halip na
gamit ang isang pinagsamang background na rehiyon. Halimbawa, ang default na kaso ay pagsamahin ang 2
mga background na rehiyon sa iisang rehiyon at pagkatapos ay ilapat ang rehiyong iyon sa bawat isa sa pinagmulan
mga rehiyon:

[sh] functions snr.ev "annulus(502,512,0,22,n=2)" "annulus(502,512,50,100,n=2)"
# pinagmulan
# file ng data: snr.ev
# degrees/pix: 0.00222222
# background
# file ng data: snr.ev
# na unit ng column
# lugar: arcsec**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# resultang binawas sa background
reg net_counts error background berror area surf_bri surf_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

# ang mga sumusunod na bahagi ng pinagmulan at background ay ginamit:
(mga) pinagmulang rehiyon
----------------
annulus(502,512,0,22,n=2)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
+1 3238.000 373
+2 1144.000 1140

(mga) background na rehiyon
--------------------
annulus(502,512,50,100,n=2)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
lahat 8656.000 23572

Tandaan na ang pangunahing panuntunan sa filter ng rehiyon "ang bawat photon ay binibilang nang isang beses at walang photon
counted more than once" nalalapat pa rin kapag ginagamit ang The -m upang tumugma sa mga rehiyon sa background. yun
ay, kung mag-overlap ang dalawang rehiyon sa background, mabibilang sa isa lang ang mga magkakapatong na pixel
sa kanila. Sa isang worst-case na senaryo, kung ang dalawang background na rehiyon ay iisang rehiyon, ang
una ay makakakuha ng lahat ng mga bilang at lugar at ang pangalawa ay makakakuha ng wala.

Paggamit ng -m lumipat sanhi mga function upang magamit nang hiwalay ang bawat isa sa dalawang background na rehiyon
sa bawat isa sa dalawang pinagmulang rehiyon:

[sh] funcnts -m snr.ev "annulus(502,512,0,22,n=2)" "ann(502,512,50,100,n=2)"
# pinagmulan
# file ng data: snr.ev
# degrees/pix: 0.00222222
# background
# file ng data: snr.ev
# na unit ng column
# lugar: arcsec**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# resultang binawas sa background
reg net_counts error background berror area surf_bri surf_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

# ang mga sumusunod na bahagi ng pinagmulan at background ay ginamit:
(mga) pinagmulang rehiyon
----------------
annulus(502,512,0,22,n=2)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
+1 3238.000 373
+2 1144.000 1140

(mga) background na rehiyon
--------------------
ann(502,512,50,100,n=2)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
+1 3975.000 9820
+2 4681.000 13752

Tandaan na ang karamihan sa mga dami ng floating point ay ipinapakita gamit ang "f" na format. Pwede kang magbago
ito sa "g" na format gamit ang -g lumipat. Maaari itong maging kapaki-pakinabang kapag ang mga bilang sa bawat pixel
ay napakaliit o napakalaki. Kung gusto mo ng maximum na katumpakan at walang pakialam sa
mga hanay na nakahanay nang maayos, gamitin -G, na naglalabas ng lahat ng lumulutang na halaga bilang %.14g.

Kapag nagbibilang ng mga photon gamit ang annulus at panda (pie at annuli) na mga hugis, ito ay madalas
kapaki-pakinabang na magkaroon ng access sa radii (at mga anggulo ng panda) para sa bawat hiwalay na rehiyon. Ang -r
Ang switch ay magdaragdag ng radii at anggulo na mga column sa output table:

[sh] funcnts -r snr.ev "annulus(502,512,0,22,n=2)" "ann(502,512,50,100,n=2)"
# pinagmulan
# file ng data: snr.ev
# degrees/pix: 0.00222222
# background
# file ng data: snr.ev
# na unit ng column
# lugar: arcsec**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2
# radii: arcsecs
# anggulo: degrees

# resultang binawas sa background
reg net_counts error background berror area surf_bri surf_err radius1 radius2 angle1 angle2
---- ------------ --------- ------------ --------- ---- ----- --------- --------- --------- --------- --------- ---------
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

# ang mga sumusunod na bahagi ng pinagmulan at background ay ginamit:
(mga) pinagmulang rehiyon
----------------
annulus(502,512,0,22,n=2)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
+1 3238.000 373
+2 1144.000 1140

(mga) background na rehiyon
--------------------
ann(502,512,50,100,n=2)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
lahat 8656.000 23572

Ang radii ay ibinibigay sa mga yunit ng pixel o arc-segundo (depende sa pagkakaroon ng impormasyon ng WCS),
habang ang mga halaga ng anggulo (kapag naroroon) ay nasa mga degree. Maaaring gamitin ang mga column na ito sa pag-plot
radial profile. Halimbawa, ang script funcnts.plot sa pamamahagi ng funtools) ay
mag-plot ng radial profile gamit ang gnuplot (bersyon 3.7 o mas mataas). Isang pinasimpleng bersyon nito
ang script ay ipinapakita sa ibaba:

#!/ Bin / SH

kung [ x"$1" = xgnuplot ]; pagkatapos
kung [ x`which gnuplot 2>/dev/null` = x ]; pagkatapos
echo "ERROR: hindi available ang gnuplot"
labasan 1
fi
awk '
MAGSIMULA{HEADER=1; DATA=0; FILES=""; XLABEL="unknown"; YLABEL="unknown"}
HEADER==1{
if( $1 == "#" && $2 == "data" && $3 == "file:"){
kung( FILES != "") FILES = FILES ","
FILES = FILES $4
}
else if( $1 == "#" && $2 == "radii:"){
XLABEL = $3
}
else if( $1 == "#" && $2 == "surf_bri:"){
YLABEL = $3
}
else if( $1 == "----" ){
printf "itakda ang nokey; itakda ang pamagat na \"funcnts(%s)\"\n", FILES
printf "itakda ang xlabel \" radius(%s)\"\n", XLABEL
printf "itakda ang ylabel \"surf_bri(%s)\"\n", YLABEL
i-print ang "plot \"-\" gamit ang 3:4:6:7:8 na may boxerrorbars"
HEADER = 0
DATA = 1
susunod
}
}
DATA==1{
kung( NF == 12 ){
i-print ang $9, $10, ($9+$10)/2, $7, $8, $7-$8, $7+$8, $10-$9
}
iba pa {
lumabas
}
}
' ⎪ gnuplot - persist - 1>/dev/null 2>&1

elif [ x"$1" = xds9 ]; pagkatapos
awk '
MAGSIMULA{HEADER=1; DATA=0; XLABEL="unknown"; YLABEL="unknown"}
HEADER==1{
if( $1 == "#" && $2 == "data" && $3 == "file:"){
kung( FILES != "") FILES = FILES ","
FILES = FILES $4
}
else if( $1 == "#" && $2 == "radii:"){
XLABEL = $3
}
else if( $1 == "#" && $2 == "surf_bri:"){
YLABEL = $3
}
else if( $1 == "----" ){
printf "funcnts(%s) radius(%s) surf_bri(%s) 3\n", FILES, XLABEL, YLABEL
HEADER = 0
DATA = 1
susunod
}
}
DATA==1{
kung( NF == 12 ){
i-print ang $9, $7, $8
}
iba pa {
lumabas
}
}
'
iba
echo "funcnts -r ... ⎪ funcnts.plot [ds9⎪gnuplot]"
labasan 1
fi

Kaya, upang tumakbo mga function at i-plot ang mga resulta gamit ang gnuplot (bersyon 3.7 o mas mataas), gamitin ang:

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

Ang -s (sum) switch sanhi mga function upang makabuo ng karagdagang talahanayan ng summed (integrated)
mga binawas na halaga sa background, kasama ang default na talahanayan ng mga indibidwal na halaga:

[sh] funcnts -s snr.ev "annulus(502,512,0,50,n=5)" "annulus(502,512,50,100)"
# pinagmulan
# file ng data: snr.ev
# degrees/pix: 0.00222222
# background
# file ng data: snr.ev
# na unit ng column
# lugar: arcsec**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# summed background-subtracted na mga resulta
hanggang sa net_counts error background berror area surf_bri surf_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

# resultang binawas sa background
reg counts error background berror area surf_bri surf_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

# ang mga sumusunod na bahagi ng pinagmulan at background ay ginamit:
(mga) pinagmulang rehiyon
----------------
annulus(502,512,0,50,n=5)

reg counts pixels 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

(mga) background na rehiyon
--------------------
annulus(502,512,50,100)

ang reg ay nagbibilang ng mga pixel
---- ------------ ---------
lahat 8656.000 23572

Ang -t at -e maaaring gamitin ang mga switch para ilapat ang timing at exposure corrections, ayon sa pagkakabanggit,
sa datos. Pakitandaan na ang mga pagwawasto na ito ay nilalayong gamitin sa husay, dahil
Ang paggamit ng mas tumpak na mga salik sa pagwawasto ay isang kumplikado at nakadepende sa misyon na pagsisikap.
Ang algorithm para sa paglalapat ng mga simpleng pagwawasto na ito ay ang mga sumusunod:

C = Raw Counts sa Source Region
Ac= Lugar ng Rehiyon ng Pinagmulan
Tc= Oras ng pagkakalantad para sa Source Data
Ec= Average na exposure sa Source Region, mula sa exposure map

B= Mga Raw Count sa Background na Rehiyon
Ab= Lugar ng Background na Rehiyon
Tb= (Exposure) oras para sa Background Data
Eb= Average na exposure sa Background Region, mula sa exposure map

Pagkatapos, ang Net Counts sa Source region ay

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

kasama ang karaniwang pagpapalaganap ng mga error para sa Error sa Net. Ang netong rate ay magiging

Net Rate = Net/(Ac*Tc*Ec)

Ang average na pagkakalantad sa bawat rehiyon ay kinakalkula sa pamamagitan ng pagbubuod ng mga halaga ng pixel sa
exposure map para sa ibinigay na rehiyon at pagkatapos ay hinahati sa bilang ng mga pixel doon
rehiyon. Ang mga mapa ng pagkakalantad ay madalas na nabuo sa isang block factor > 1 (hal., ang ibig sabihin ng block 4 ay iyon
bawat exposure pixel ay naglalaman ng 4x4 pixels sa buong resolution) at mga function haharapin ang
awtomatikong pagharang. Gamit ang -e switch, maaari kang magbigay ng parehong pinagmulan at background
exposure file (na pinaghihiwalay ng ";"), kung mayroon kang hiwalay na source at background data file.
Kung hindi ka magbibigay ng background exposure file upang pumunta sa isang hiwalay na background data
file, mga function Ipinapalagay na ang pagkakalantad ay nailapat na sa background data file.
Bilang karagdagan, ipinapalagay nito na ang error sa mga pixel sa background data file ay zero.

NB: Ang -e Ipinapalagay ng switch na na-overlay ng exposure map ang image file tamang-tama, maliban
para sa block factor. Ang bawat pixel sa larawan ay sinusukat ng block factor upang ma-access ang
kaukulang pixel sa exposure map. Kung ang iyong exposure map ay hindi eksaktong linya
kasama ang imahe, do hindi gamitin ang -e pagwawasto ng pagkakalantad. Sa kasong ito, posible pa rin
upang magsagawa ng pagwawasto ng pagkakalantad if parehong may wastong WCS ang imahe at ang exposure map
impormasyon: gamitin ang -w lumipat upang ang pagbabago mula sa pixel ng imahe sa pagkakalantad
pixel ay gumagamit ng impormasyon ng WCS. Iyon ay, ang bawat pixel sa rehiyon ng imahe ay magiging
binago muna mula sa mga coordinate ng imahe patungo sa mga coordinate ng langit, pagkatapos ay mula sa mga coordinate ng langit hanggang sa
mga coordinate ng pagkakalantad. Mangyaring tandaan na ang paggamit -w maaaring dagdagan ang oras na kinakailangan upang maproseso
malaki ang pagwawasto ng pagkakalantad.

Maaaring ilapat ang pagwawasto ng oras sa parehong pinagmulan at background na data gamit ang -t Lumipat.
Ang halaga para sa pagwawasto ay maaaring isang numeric constant o ang pangalan ng isang header
parameter sa source (o background) na file:

[sh] function -t 23.4 ... # numero para sa pinagmulan
[sh] function -t "LIVETIME;23.4" ... # param para sa source, numeric para sa bkgd

Kapag tinukoy ang pagwawasto ng oras, inilalapat din ito sa mga net count (tingnan
algorithm sa itaas), upang ang mga unit ng liwanag ng ibabaw ay maging cnts/area**2/sec.

Ang -i (interval) switch ay ginagamit upang tumakbo mga function sa maramihang column-based na pagitan na may
isang solong pagpasa lamang sa data. Ito ay katumbas ng pagtakbo mga function maraming beses
na may ibang column na filter na idinaragdag sa source at background data sa bawat pagkakataon. Para sa bawat isa
pagitan, ang buong mga function nabuo ang output, na may nakalagay na linefeed na character (^L).
sa pagitan ng bawat pagtakbo. Bilang karagdagan, ang output para sa bawat pagitan ay maglalaman ng pagitan
detalye sa header nito. Ang mga agwat ay lubhang kapaki-pakinabang para sa pagbuo ng katigasan ng X-ray
mga ratios nang mahusay. Siyempre, sinusuportahan lamang ang mga ito kapag ang data ng pag-input ay nakapaloob
sa isang mesa.

Dalawang format ang sinusuportahan para sa pagtutukoy ng agwat. Ang pinaka-pangkalahatang format ay semi-
colon-delimited na listahan ng mga filter na gagamitin bilang mga agwat:

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

Sa konsepto, ito ay magiging katumbas ng pagtakbo mga function tatlong beses:

funcnts snr.ev'[pha=1:5]' "circle(502,512,22)"
funcnts snr.ev'[pha=6:10]' "circle(502,512,22)"
funcnts snr.ev'[pha=11:15]' "circle(502,512,22)"

Gayunpaman, ang paggamit ng -i Ang switch ay mangangailangan lamang ng isang pass sa data.

Tandaan na ang mga kumplikadong filter ay maaaring gamitin upang tukuyin ang mga agwat:

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

Ang programa ay nagpapatakbo lamang ng data sa bawat filter at bumubuo ng tatlo mga function
mga output, na pinaghihiwalay ng character na line-feed.

Sa katunayan, kahit na ang layunin ay upang suportahan ang mga agwat para sa mga ratio ng katigasan, ang tinukoy
Ang mga filter ay hindi kailangang maging mga pagitan. Hindi rin kailangang maging isang "interval" na filter
may kaugnayan sa iba. Halimbawa:

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

ay katumbas ng pagtakbo mga function tatlong beses na may hindi nauugnay na mga detalye ng filter.

Ang pangalawang format ng pagitan ay sinusuportahan para sa simpleng kaso kung saan ginagamit ang isang column
upang tukuyin ang maramihang magkakatulad na pagitan para sa column na iyon. Sa format na ito, isang pangalan ng column
ay tinukoy muna, na sinusundan ng mga pagitan:

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

Ito ay katumbas ng unang halimbawa, ngunit nangangailangan ng mas kaunting pag-type. Ang mga function programa
ilalagay lang ang "pha=" bago ang bawat isa sa mga tinukoy na agwat. (Tandaan na ang format na ito
ay hindi naglalaman ng "=" character sa column argument.)

Karaniwan, kapag mga function ay tumatakbo sa isang FITS binary table (o isang raw event table), isa
ang integral count ay naipon para sa bawat hilera (kaganapan) na nasa loob ng isang partikular na rehiyon. Ang -v
"scol[;bcol]" (value column) switch ay mag-iipon ng mga bilang gamit ang value mula sa
tinukoy na column para sa ibinigay na kaganapan. Kung iisang column lang ang tinukoy, ginagamit ito para sa
parehong pinagmulan at background na mga rehiyon. Dalawang magkahiwalay na column, na pinaghihiwalay ng semi-colon,
maaaring tukuyin para sa pinagmulan at background. Maaaring gamitin ang espesyal na token na '$none'
tukuyin na ang isang column ng halaga ay gagamitin para sa isa ngunit hindi sa isa pa. Halimbawa,
Gagamitin ng 'pha;$none' ang pha column para sa source ngunit gagamit ng integral counts para sa
background, habang ang '$none;pha' ang gagawa ng kabaligtaran. Kung uri ang column ng value
lohikal, kung gayon ang halagang ginamit ay magiging 1 para sa T at 0 para sa F. Ginagamit ang mga hanay ng halaga, para sa
halimbawa, upang isama ang mga probabilidad sa halip na mga integral na bilang.

Kung ang -T (rdb table) switch ay ginagamit, ang output ay aayon sa starbase/rdb data base
format: ang mga tab ay ipapasok sa pagitan ng mga column kaysa sa mga puwang at line-feed
ipinasok sa pagitan ng mga talahanayan.

Sa wakas, tandaan na mga function ay isang programa ng imahe, kahit na maaari itong patakbuhin nang direkta sa FITS
binary table. Nangangahulugan ito na ang pag-filter ng imahe ay inilalapat sa mga hilera upang matiyak
na ang parehong mga resulta ay nakuha hindi alintana kung ang isang talahanayan o ang katumbas na binned
larawan ang ginagamit. Dahil dito, gayunpaman, ang bilang ng mga bilang na natagpuang gumagamit mga function maaari
naiiba sa bilang ng mga kaganapang natagpuan gamit ang mga row-filter program gaya ng fundisp or
funtable Para sa karagdagang impormasyon tungkol sa mga pagkakaibang ito, tingnan ang talakayan ng Rehiyon
Mga hangganan.

Gumamit ng mga function online gamit ang mga serbisyo ng onworks.net