STScI Logo

srcinten xray.xspatial


NAME · USAGE · DESCRIPTION · PARAMETERS · EXAMPLES · BUGS · SEE_ALSO

NAME

srcinten - Calculate the count rate from a given source region

USAGE

srcinten source region bkgd bkgdregion otb_root

DESCRIPTION

SRCINTEN is a macro that uses the existing tasks in pros and iraf to compute the source intensity or upper limit from a given source region. The result is corrected for point response function, vignetting, and quantum efficiency effects. Both the count rate and upper limit columns are included in the output, but for sources above the user-specified significance threshold, only the count rate column is filled.

Currently this task runs on HRI RDF data only. The source region descriptor is limited to CIRCLE. Arcminutes (') and arcsecs (") can not be used in the region description because of a problem in Tables.

PARAMETERS

source ="" prompt = source qpoe file

Required input source qpoe file.

region="" prompt = source region descriptor

Required source region descriptor. Currently it is limited to CIRCLE only.

bkgd="" prompt = background qpoe file

Required background qpoe file. Enter "none" for no background case.

bkgdregion="" prompt = bkgd region descriptor

Required background region descriptor if bkgd qpoe file is entered. No restrictions on bkgdregion. (see help qpspec )

otb_root="" prompt = output root name (_ccr.tab)

Required output table root name. The extension is "_ccr.tab". The output file contains the columns described as below.


        RA       - RA in degrees
        DEC      - DEC in degrees
	X	 - source X position in pixels
        Y	 - source Y position in pixels
        radius   - source radius in arcsec
        cntrate	 - corrected net count rate in counts/ksec
        cntraterr- corrected net count rate error in counts/ksec
	uplimrate- corrected upper limit in counts/ksec 
        totcnt	 - total counts
        bkgcnt	 - background counts
        exptime  - exposure time in seconds
        prf_corr - correction factor for point response function
        qe_corr  - correction factor for quantum efficiency
        vign_corr- correction factor for vignetting
(display = 1) [int]

The display level. Input 0 for no output, 1 for output filename and 5 for the maximum level.

(clobber = no) [boolean]

Boolean flag specifying whether the output table can be overwritten if it already exists.

(deltmpfil = yes) [boolean]

Boolean flag specifying whether the intermediate files can be deleted.

(vign_correct = no) [boolean]

Boolean flag specifying whether to perform vignetting correction on background.

(nsigma = 3.0) [real]

User-specified threshold.

EXAMPLES

1. Read a source qpoe file and create a file "src_ccr.tab"


	xp> srcinten display=5
        source qpoe file: xdata$rh110267n00.qp
        source region descriptor: circle 2420 2800 80
        background qpoe file: xdata$rh110267n00.qp
        bkgd region descriptor: a 2420 2800 80 100
        output root name (_ccr.tab): src
        
        --- Running SRCINTEN task ---
            
        --- Creating aspect histogram table from qpoe ---

        total count = 190.
        background count = 35.43
        net count = 154.57
        net count error = 17.78
        signal to noise ratio = 8.6934758155231
            
        --- Computing vignetting correction factor ---
            
        vign_corr =0.918367593
            
        --- Computing prf correction factor ---
        
        rr, rsq, s1sq = 39.962989527588 1597.0405319821 4.77772164
        rsq/s1sq, exp()= 334.2682249655 2.5976295193108E-73
        en10, en30 =4.604768116632 0.32476499155099
        ed10, ed30 =4.604768116632 0.90383049

        prf_corr =0.957854481

        --- Computing qe correction factor ---

        qe_corr = 0.96

        signal to noise ratio is above the threshold
        corrected count rate = 86.158579335107

        --- SRCINTEN created Output table: src_ccr.tab ---

BUGS

Currently this task runs on HRI RDF data only. The source region descriptor is limited to CIRCLE. Arcminutes (') and arcsecs (") can not be used in the region description because of a problem in Tables.

SEE ALSO

help regions and help qpspec


Source Code · Search Form · STSDAS