functies - Online in de cloud

PROGRAMMA:

NAAM

funcnts - tel fotonen in specifieke gebieden, met bkgd-aftrekking

KORTE INHOUD

functies [schakelaars] [bronregio] [bkgd_bestand] [bkgd_regio⎪bkgd_waarde]

OPTIES

-e "bron_exposure[;bkgd_exposure]"
# bron (bkgd) PAST belichtingsafbeelding met overeenkomende bestanden
-w "bron_exposure[;bkgd_exposure]"
# bron (bkgd) PAST belichtingsafbeelding met behulp van WCS-transformatie
-t "bron_tijdcorr[;bkgd_tijdcorr]"
# bron (bkgd) tijdcorrectiewaarde of headerparameternaam
-g # uitvoer met behulp van het mooie g-formaat
-G # uitvoer met %.14g-formaat (maximale precisie)
-i "[column;]int1;int2..." # op kolommen gebaseerde intervallen
-m # komt overeen met individuele bron- en bkgd-regio's
-p # uitvoer in pixels, zelfs als wcs aanwezig is
-r # voert binnenste/buitenste stralen (en hoeken) uit voor annuli (en panda's)
-s # uitvoer opgetelde waarden
-v "scol[;bcol]" # src- en bkgd-waardekolommen voor tabellen
-T # uitvoer in starbase/rdb-formaat
-z # uitvoergebieden met nulgebied

PRODUCTBESCHRIJVING

functies telt fotonen in de gespecificeerde brongebieden en rapporteert de resultaten voor elk
regio. Regio's worden gespecificeerd met behulp van het Spatial Region Filtering-mechanisme. Fotonen zijn dat wel
ook geteld in de opgegeven bkgd-regio's toegepast op hetzelfde gegevensbestand of een ander
data bestand. (Als alternatief kan een constante achtergrondwaarde in aantallen/pixel**2 worden gebruikt
opgegeven.) De bkgd-regio's worden één-op-één gekoppeld aan bronregio's of samengevoegd
en genormaliseerd per gebied, en vervolgens afgetrokken van de brontellingen in elke regio.
De weergegeven resultaten omvatten de met bkgd afgetrokken tellingen in elke regio, evenals de fout
op de tellingen, het gebied in elke regio en de helderheid van het oppervlak (cnts/gebied**2)
berekend voor elke regio.

Het eerste argument voor het programma specificeert het FITS-invoerbeeld, de array of het onbewerkte gebeurtenisbestand
verwerken. Als "stdin" is opgegeven, worden gegevens uit de standaardinvoer gelezen. Gebruik Funtools
Bracket-notatie om FITS-extensies, afbeeldingssecties en filters te specificeren.

Het optionele tweede argument is de descriptor van de bronregio. Als er geen regio is opgegeven,
het hele veld wordt gebruikt.

De achtergrondargumenten kunnen twee vormen aannemen, afhankelijk van of ze gescheiden zijn
achtergrondbestand is opgegeven. Als het bronbestand ook als achtergrond moet worden gebruikt, wordt het
Het derde argument kan het achtergrondgebied zijn, of een constante waarde die aangeeft
achtergrond cts/pixel. Als alternatief kan het derde argument een achtergrondgegevensbestand zijn,
in welk geval het vierde argument het achtergrondgebied is. Als er geen derde argument is
gespecificeerd, wordt een constante waarde van 0 gebruikt (dwz geen achtergrond).

Samenvattend zijn de volgende opdrachtargumenten geldig:

[sh] funcnts sfile # telt in bronbestand
[sh] funcnts sfile sregion # telt in bronregio
[sh] funcnts sfile sregion bregion # bkgd reg. komt uit het bronbestand
[sh] funcnts sfile sregion bvalue # bkgd reg. is constant
[sh] funcnts sfile sregion bfile bregion # bkgd reg. komt uit een apart bestand

NB: in tegenstelling tot andere Funtools-programma's worden bron- en achtergrondregio's gespecificeerd als
afzonderlijke argumenten op de opdrachtregel, in plaats van als onderdeel tussen haakjes te worden geplaatst
van de bron- en achtergrondbestandsnamen. Dit komt omdat regio's in functies niet eenvoudigweg zijn
gebruikt als gegevensfilters, maar worden ook gebruikt om gebieden, blootstelling, enz. te berekenen. Als u de
brongebied binnen de haakjes (dwz gebruik het eenvoudigweg als filter) in plaats van op te geven
Als argument twee telt het programma nog steeds alleen fotonen die het regiofilter passeren.
De oppervlakteberekening wordt echter op het hele perceel uitgevoerd veld() is de
standaard bronregio. Dit is zelden het gewenste gedrag. Aan de andere kant, met FITS
binaire tabellen is het vaak handig om een ​​kolomfilter tussen de haakjes van de bestandsnaam te plaatsen, zodat
alleen gebeurtenissen die overeenkomen met het kolomfilter worden binnen de regio geteld.

Als u bijvoorbeeld de tellingen wilt extraheren binnen een straal van 22 pixels vanaf het midden van de
PAST binaire tabel snr.ev en trekt de achtergrond af die is bepaald op basis van dezelfde afbeelding erin
een ring met stralen 50-100 pixels:

[sh] funcnts snr.ev "circle(502,512,22)" "annulus(502,512,50,100)"
# bron
# gegevensbestand: snr.ev
# graden/pixel: 0.00222222
# achtergrond
# gegevensbestand: snr.ev
# kolomeenheden
# gebied: boogseconden**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# resultaten met achtergrondaftrek
reg net_counts fout achtergrond berror gebied surf_bri surf_err
---- ------------ --------- ------------ --------- ---- ----- --------- ---------
1 3826.403 66.465 555.597 5.972 96831.98 0.040 0.001

# de volgende bron- en achtergrondcomponenten zijn gebruikt:
bronregio('s)
----------------
cirkel(502,512,22)

reg telt pixels
---- ------------ ---------
1 4382.000 1513

achtergrondregio('s)
--------------------
annulus(502,512,50,100)

reg telt pixels
---- ------------ ---------
alle 8656.000 23572

De oppervlakte-eenheden voor de uitvoerkolommen met het label "area", "surf_bri" (oppervlaktehelderheid) en
"surf_err" wordt weergegeven in boogseconden (als de juiste WCS-informatie in de
header(s) van gegevensbestand) of in pixels. Als het gegevensbestand WCS-info bevat, maar u wilt geen boog-
tweede eenheden, gebruik de -p schakelaar om de uitvoer in pixels te forceren. Ook regio's met een nulgebied
worden normaal gesproken niet opgenomen in de primaire (op de achtergrond afgetrokken) tabel, maar zijn wel opgenomen
in de secundaire bron- en bkgd-tabellen. Als u wilt dat deze regio's worden opgenomen in de
primaire tabel, gebruik de -z schakelaar.

Merk op dat een eenvoudig sed-commando de op de achtergrond afgetrokken resultaten verder zal extraheren
analyse:

[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

Als afzonderlijke bron- en achtergrondbestanden zijn opgegeven, functies zal proberen te normaliseren
het achtergrondgebied zodat de achtergrondpixelgrootte hetzelfde is als de bronpixel
maat. Deze normalisatie kan alleen plaatsvinden als de juiste WCS-informatie beschikbaar is
in beide bestanden (bijvoorbeeld graden/pixelwaarden in CDELT). Als een van beide bestanden dat niet doet
de vereiste grootte-informatie bevatten, wordt de normalisatie niet uitgevoerd. In dit geval,
het is de verantwoordelijkheid van de gebruiker om ervoor te zorgen dat de pixelgroottes voor de twee hetzelfde zijn
bestanden.

Normaal gesproken, als er meer dan één achtergrondgebied is opgegeven, functies zal ze allemaal combineren
in een enkel gebied en gebruik dit achtergrondgebied om de achtergrond-afgetrokken te produceren
resultaten voor elke bronregio. De -m (match meerdere achtergronden) schakelaar vertelt functies
om een ​​één-op-één correspondentie te maken tussen achtergrond- en bronregio's, in plaats van
met behulp van een enkel gecombineerd achtergrondgebied. Het standaardscenario is bijvoorbeeld om 2 te combineren
achtergrondregio's in één enkele regio en pas die regio vervolgens toe op elk van de bronbronnen
Regio's:

[sh] funcnts snr.ev "annulus(502,512,0,22,n=2)" "annulus(502,512,50,100,n=2)"
# bron
# gegevensbestand: snr.ev
# graden/pixel: 0.00222222
# achtergrond
# gegevensbestand: snr.ev
# kolomeenheden
# gebied: boogseconden**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# resultaten met achtergrondaftrek
reg net_counts fout achtergrond berror gebied 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

# de volgende bron- en achtergrondcomponenten zijn gebruikt:
bronregio('s)
----------------
annulus(502,512,0,22,n=2)

reg telt pixels
---- ------------ ---------
1 3238.000 373
2 1144.000 1140

achtergrondregio('s)
--------------------
annulus(502,512,50,100,n=2)

reg telt pixels
---- ------------ ---------
alle 8656.000 23572

Merk op dat de basisregel voor het filteren van regio's: "Elk foton wordt één keer geteld en geen enkel foton
meer dan één keer geteld" is nog steeds van toepassing bij gebruik van The -m om achtergrondgebieden aan te passen. Dat
dat wil zeggen dat als twee achtergrondgebieden elkaar overlappen, de overlappende pixels slechts in één worden geteld
van hen. In het ergste geval, als twee achtergrondregio's dezelfde regio zijn, zal de
de eerste krijgt alle tellingen en oppervlakte en de tweede krijgt er geen.

De -m schakelaar veroorzaakt functies om elk van de twee achtergrondgebieden onafhankelijk te gebruiken
met elk van de twee bronregio's:

[sh] funcnts -m snr.ev "annulus(502,512,0,22,n=2)" "ann(502,512,50,100,n=2)"
# bron
# gegevensbestand: snr.ev
# graden/pixel: 0.00222222
# achtergrond
# gegevensbestand: snr.ev
# kolomeenheden
# gebied: boogseconden**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# resultaten met achtergrondaftrek
reg net_counts fout achtergrond berror gebied 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

# de volgende bron- en achtergrondcomponenten zijn gebruikt:
bronregio('s)
----------------
annulus(502,512,0,22,n=2)

reg telt pixels
---- ------------ ---------
1 3238.000 373
2 1144.000 1140

achtergrondregio('s)
--------------------
ann(502,512,50,100,n=2)

reg telt pixels
---- ------------ ---------
1 3975.000 9820
2 4681.000 13752

Merk op dat de meeste drijvende-kommagrootheden worden weergegeven in het "f"-formaat. Je kan veranderen
dit naar het "g"-formaat met behulp van de -g schakelaar. Dit kan handig zijn als het aantal pixels in elke pixel telt
is heel klein of heel groot. Als u maximale precisie wilt en zich niet bekommert om de
kolommen mooi op één lijn, gebruik -G, die alle zwevende waarden uitvoert als %.14g.

Bij het tellen van fotonen met behulp van de vormen annulus en panda (taart en annuli) is dit vaak het geval
handig om toegang te hebben tot de stralen (en panda-hoeken) voor elke afzonderlijke regio. De -r
switch voegt stralen- en hoekkolommen toe aan de uitvoertabel:

[sh] funcnts -r snr.ev "annulus(502,512,0,22,n=2)" "ann(502,512,50,100,n=2)"
# bron
# gegevensbestand: snr.ev
# graden/pixel: 0.00222222
# achtergrond
# gegevensbestand: snr.ev
# kolomeenheden
# gebied: boogseconden**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2
# stralen: boogseconden
# hoeken: graden

# resultaten met achtergrondaftrek
reg net_counts fout achtergrond berror gebied surf_bri surf_err radius1 radius2 hoek1 hoek2
---- ------------ --------- ------------ --------- ---- ----- --------- --------- --------- --------- --------- ---------
1 3101.029 56.922 136.971 1.472 23872.00 0.130 0.002 0.00 88.00 n.v.t. n.v.t.
2 725.375 34.121 418.625 4.500 72959.99 0.010 0.000 88.00 176.00 n.v.t. n.v.t.

# de volgende bron- en achtergrondcomponenten zijn gebruikt:
bronregio('s)
----------------
annulus(502,512,0,22,n=2)

reg telt pixels
---- ------------ ---------
1 3238.000 373
2 1144.000 1140

achtergrondregio('s)
--------------------
ann(502,512,50,100,n=2)

reg telt pixels
---- ------------ ---------
alle 8656.000 23572

Radii worden gegeven in eenheden van pixels of boogseconden (afhankelijk van de aanwezigheid van WCS-info),
terwijl de hoekwaarden (indien aanwezig) in graden zijn. Deze kolommen kunnen worden gebruikt om te plotten
radiale profielen. Het script bijvoorbeeld functies.plot in de funtools-distributie) wel
teken een radiaal profiel met behulp van gnuplot (versie 3.7 of hoger). Een vereenvoudigde versie hiervan
script wordt hieronder weergegeven:

#!/ Bin / sh

if [ x"$1" = xgnuplot ]; Dan
if [ x`welke gnuplot 2>/dev/null` = x ]; Dan
echo "FOUT: gnuplot niet beschikbaar"
verlaat 1
fi
akelig '
BEGIN{HEADER=1; GEGEVENS=0; BESTANDEN = ""; XLABEL = "onbekend"; YLABEL = "onbekend"}
KOP==1{
if( $1 == "#" && $2 == "gegevens" && $3 == "bestand:" ){
if( BESTANDEN != "" ) BESTANDEN = BESTANDEN ","
BESTANDEN = BESTANDEN $4
}
else if( $1 == "#" && $2 == "radii:" ){
XLABEL = $ 3
}
anders als( $1 == "#" && $2 == "surf_bri:" ){
YLABEL = $ 3
}
anders als( $1 == "----" ){
printf "set nokey; stel titel \"funcnts(%s)\"\n", FILES in
printf "set xlabel \" radius(%s)\"\n", XLABEL
printf "stel ylabel \"surf_bri(%s)\"\n", YLABEL in
print "plot \"-\" met behulp van 3:4:6:7:8 met boxerrorbars"
KOP = 0
GEGEVENS = 1
volgende
}
}
GEGEVENS==1{
als( NF == 12 ){
afdrukken $9, $10, ($9+$10)/2, $7, $8, $7-$8, $7+$8, $10-$9
}
anders{
afrit
}
}
' ⎪ gnuplot -persist - 1>/dev/null 2>&1

elif [ x"$1" = xds9 ]; Dan
akelig '
BEGIN{HEADER=1; GEGEVENS=0; XLABEL = "onbekend"; YLABEL = "onbekend"}
KOP==1{
if( $1 == "#" && $2 == "gegevens" && $3 == "bestand:" ){
if( BESTANDEN != "" ) BESTANDEN = BESTANDEN ","
BESTANDEN = BESTANDEN $4
}
else if( $1 == "#" && $2 == "radii:" ){
XLABEL = $ 3
}
anders als( $1 == "#" && $2 == "surf_bri:" ){
YLABEL = $ 3
}
anders als( $1 == "----" ){
printf "funcnts(%s) radius(%s) surf_bri(%s) 3\n", FILES, XLABEL, YLABEL
KOP = 0
GEGEVENS = 1
volgende
}
}
GEGEVENS==1{
als( NF == 12 ){
afdrukken van $ 9, $ 7, $ 8
}
anders{
afrit
}
}
'
anders
echo "funcnts -r ... ⎪ funcnts.plot [ds9⎪gnuplot]"
verlaat 1
fi

Dus rennen functies en plot de resultaten met behulp van gnuplot (versie 3.7 of hoger), gebruik:

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

De -s (som) schakelaaroorzaken functies om een ​​extra tabel met gesommeerde (geïntegreerde)
op de achtergrond afgetrokken waarden, samen met de standaardtabel met individuele waarden:

[sh] funcnts -s snr.ev "annulus(502,512,0,50,n=5)" "annulus(502,512,50,100)"
# bron
# gegevensbestand: snr.ev
# graden/pixel: 0.00222222
# achtergrond
# gegevensbestand: snr.ev
# kolomeenheden
# gebied: boogseconden**2
# surf_bri: cnts/arcsec**2
# surf_err: cnts/arcsec**2

# opgetelde resultaten met achtergrondaftrek
tot 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

# resultaten met achtergrondaftrek
reg telt fout achtergrond berror gebied 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

# de volgende bron- en achtergrondcomponenten zijn gebruikt:
bronregio('s)
----------------
annulus(502,512,0,50,n=5)

reg telt 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

achtergrondregio('s)
--------------------
annulus(502,512,50,100)

reg telt pixels
---- ------------ ---------
alle 8656.000 23572

De -t en -e schakelaars kunnen worden gebruikt om respectievelijk timing- en belichtingscorrecties toe te passen,
naar de gegevens. Houd er rekening mee dat deze correcties bedoeld zijn om kwalitatief te worden gebruikt, aangezien
Het toepassen van nauwkeurigere correctiefactoren is een complexe en missieafhankelijke inspanning.
Het algoritme voor het toepassen van deze eenvoudige correcties is als volgt:

C = Ruwe tellingen in bronregio
Ac= Gebied van bronregio
Tc= Blootstellingstijd voor brongegevens
Ec= Gemiddelde blootstelling in de bronregio, van de blootstellingskaart

B= Ruwe tellingen in achtergrondgebied
Ab= Gebied van achtergrondregio
Tb= (Belichtings)tijd voor achtergrondgegevens
Eb= Gemiddelde blootstelling in de achtergrondregio, van de blootstellingskaart

Dan is het nettoaantal in de bronregio

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

met de standaardpropagatie van fouten voor de Error on Net. Het netto tarief zou dan zijn

Nettotarief = Netto/(Ac*Tc*Ec)

De gemiddelde belichting in elke regio wordt berekend door de pixelwaarden in de tabel bij elkaar op te tellen
belichtingskaart voor het gegeven gebied en vervolgens gedeeld door het aantal pixels daarin
regio. Blootstellingskaarten worden vaak gegenereerd bij een blokfactor > 1 (blok 4 betekent dat bijvoorbeeld).
elke belichtingspixel bevat 4x4 pixels bij volledige resolutie) en functies zal omgaan met de
automatisch blokkeren. De ... gebruiken -e switch, kunt u zowel bron als achtergrond aanleveren
belichtingsbestanden (gescheiden door ";"), als u afzonderlijke bron- en achtergrondgegevensbestanden heeft.
Als u geen achtergrondbelichtingsbestand aanlevert, met aparte achtergrondgegevens
bestand functies gaat ervan uit dat de belichting al is toegepast op het achtergrondgegevensbestand.
Bovendien wordt ervan uitgegaan dat de fout op de pixels in het achtergrondgegevensbestand nul is.

NB: de -e switch gaat ervan uit dat de belichtingskaart het afbeeldingsbestand overlapt precies, behalve
voor de blokfactor. Elke pixel in de afbeelding wordt geschaald met de blokfactor om toegang te krijgen tot de
overeenkomstige pixel in de belichtingskaart. Als uw belichtingskaart niet precies uitgelijnd is
met de afbeelding, do niet . de -e belichtingscorrectie. In dit geval is het nog steeds mogelijk
belichtingscorrectie uit te voeren if zowel de afbeelding als de belichtingskaart hebben een geldige WCS
informatie: gebruik de -w schakelaar zodat de transformatie van beeldpixel naar belichting plaatsvindt
pixel gebruikt de WCS-informatie. Dat wil zeggen dat elke pixel in het beeldgebied dat zal zijn
eerst getransformeerd van beeldcoördinaten naar luchtcoördinaten, en vervolgens van luchtcoördinaten naar
belichtingscoördinaten. Houd er rekening mee dat het gebruik van -w kan de verwerkingstijd verlengen
de belichtingscorrectie aanzienlijk.

Er kan een tijdcorrectie worden toegepast op zowel bron- als achtergrondgegevens met behulp van de -t schakelaar.
De waarde voor de correctie kan een numerieke constante zijn of de naam van een header
parameter in het bronbestand (of achtergrondbestand):

[sh] funcnts -t 23.4 ... # nummer voor bron
[sh] funcnts -t "LIVETIME;23.4" ... # param voor bron, numeriek voor bkgd

Wanneer een tijdcorrectie is gespecificeerd, wordt deze ook toegepast op de nettotellingen (zie
algoritme hierboven), zodat de eenheden van oppervlaktehelderheid cnts/gebied**2/sec worden.

De -i (interval)schakelaar wordt gebruikt om te draaien functies op meerdere kolommen gebaseerde intervallen met
slechts één enkele doorgang door de gegevens. Het is vergelijkbaar met hardlopen functies meerdere malen
waarbij telkens een ander kolomfilter aan de bron- en achtergrondgegevens wordt toegevoegd. Voor elk
interval, het volledige functies uitvoer wordt gegenereerd, met een regeleindeteken (^L) ingevoegd
tussen elke run. Bovendien bevat de uitvoer voor elk interval het interval
specificatie in de header. Intervallen zijn zeer nuttig voor het genereren van röntgenhardheid
verhoudingen efficiënt. Uiteraard worden ze alleen ondersteund als de invoergegevens aanwezig zijn
in een tabel.

Er worden twee formaten ondersteund voor intervalspecificatie. Het meest algemene formaat is semi-
door dubbele punten gescheiden lijst met filters die als intervallen moeten worden gebruikt:

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

Conceptueel gezien komt dit overeen met hardlopen functies drie keer:

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

Echter, met behulp van de -i schakelaar vereist slechts één doorgang door de gegevens.

Houd er rekening mee dat complexe filters kunnen worden gebruikt om intervallen te specificeren:

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

Het programma voert de gegevens eenvoudigweg door elk filter heen en genereert er drie functies
uitgangen, gescheiden door het regelinvoerteken.

Hoewel het de bedoeling is om intervallen voor hardheidsverhoudingen te ondersteunen, zijn de gespecificeerde
filters hoeven helemaal geen intervallen te zijn. Er hoeft ook geen sprake te zijn van één "interval"-filter
gerelateerd aan een ander. Bijvoorbeeld:

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

is gelijk aan hardlopen functies drie keer met niet-gerelateerde filterspecificaties.

Een tweede intervalformaat wordt ondersteund voor het eenvoudige geval waarin één enkele kolom wordt gebruikt
om meerdere homogene intervallen voor die kolom op te geven. In deze notatie een kolomnaam
wordt eerst gespecificeerd, gevolgd door intervallen:

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

Dit is gelijk aan het eerste voorbeeld, maar vereist minder typen. De functies programma
zal eenvoudigweg "pha=" vóór elk van de gespecificeerde intervallen plaatsen. (Merk op dat dit formaat
bevat niet het teken "= in het kolomargument.)

Normaal gesproken, wanneer functies wordt uitgevoerd op een binaire FITS-tabel (of een onbewerkte gebeurtenistabel), one
Het aantal integralen wordt opgeteld voor elke rij (gebeurtenis) binnen een bepaald gebied. De -v
"scol[;bcol]" (waardekolom)-schakelaar accumuleert tellingen met behulp van de waarde uit de
opgegeven kolom voor de gegeven gebeurtenis. Als er slechts één kolom is opgegeven, wordt deze gebruikt voor
zowel de bron- als de achtergrondregio's. Twee afzonderlijke kolommen, gescheiden door een puntkomma,
kan worden opgegeven voor bron en achtergrond. Hiervoor kan het speciale token '$none' worden gebruikt
specificeer dat een waardekolom voor de ene kolom moet worden gebruikt, maar niet voor de andere. Bijvoorbeeld,
'pha;$none' gebruikt de pha-kolom voor de bron, maar gebruikt integrale tellingen voor de
achtergrond, terwijl '$none;pha' het tegenovergestelde zal doen. Als de waardekolom van het type is
logisch, dan is de gebruikte waarde 1 voor T en 0 voor F. Er worden waardekolommen gebruikt, voor
bijvoorbeeld om waarschijnlijkheden te integreren in plaats van integrale tellingen.

Indien de -T (rdb-tabel)-schakelaar wordt gebruikt, zal de uitvoer voldoen aan starbase/rdb-database
formaat: tabs worden tussen kolommen ingevoegd in plaats van spaties en regelinvoer
tussen tabellen ingevoegd.

Merk ten slotte op dat functies is een imageprogramma, ook al kan het rechtstreeks op FITS worden uitgevoerd
binaire tabellen. Dit betekent dat er beeldfiltering op de rijen wordt toegepast om dit te garanderen
dat dezelfde resultaten worden verkregen, ongeacht of een tabel of iets dergelijks is weggegooid
afbeelding wordt gebruikt. Hierdoor neemt echter het aantal gevonden tellingen toe functies wel
verschillen van het aantal gevonden gebeurtenissen met behulp van rijfilterprogramma's zoals geldschieter or
funtabel Voor meer informatie over deze verschillen, zie de bespreking van Regio
Grenzen.

Gebruik functies online met behulp van onworks.net-services