XMM-Newton SAS Home Page
XMM-Newton Science Analysis System


emldetect (emldetect-5.17.8) [xmmsas_20121219_1645-12.0.1]

References Home Page Errors Home Index

Meta Index / Home Page

Parameters

This section documents the parameters recognized by this task (if any).

ParameterMand Type Default Constraints
imagesetsyesfilename listimage.fits 
Names of input EPIC fits images$^{1,2}$ or event lists$^3$ (if useevents = true; event-list mode not yet implemented)
 
expimagesetsnofilename listexpimage.fits 
Names of exposure images$^{1,2}$
 
detmasksetsnofilename listdetmask.fits 
Names of detection masks$^{3}$
 
bkgimagesetsyesfilename listbkgimage.fits 
Names of background maps$^{1,2}$
 
boxlistsetyesfilenameeboxlist.fits 
Name of eboxdetect source list
 
mllistsetyesfilenameemllist.fits 
Name of output emldetect source list
 
mergedlistsetnofilenamemergedlist.fits 
Name of merged source list - obsolete
 
mlminnofloat10.0[1.0$<$param$<$50.0]
Minimum detection likelihood for inclusion of source in output list
 
dmlextminnofloat10.0[1.0$<$param$<$100.0]
Required likelihood improvement for source extent
 
scutnofloat0.9[0.4$<$param$<$0.99]
Source selection radius for multi-source fitting (expressed as fraction of the normalized PSF integrated to the desired radius)
 
ecutnofloat0.68[0.4$<$param$<$100.0]
Event cut-out radius for multi-source fitting (expressed as fraction of the normalized PSF integrated to the desired cut-out radius).$^4$ Values larger than 1.0 are interpreted as a fixed event cut-out radius given in units of image pixels.
 
ecfnofloat1.0[0.001$<$param$<$1000]
Energy conversion factors, given in units of $10^{11}$ counts cm$^2$ erg$^{-1}$ $^{1,2}$
 
xidecfnofloat1.0[0.001$<$param$<$1000]
XID band energy conversion factors, given in units of $10^{11}$ counts cm$^2$ erg$^{-1}$ $^3$
 
useeventsnobinaryfalse 
Photon mode flag$^5$ (mode not yet implemented)
 
fitpositionnobinarytrue 
Fit source positions
 
fitextentnobinaryfalse 
Fit source extent
 
fitcountsnobinarytrue 
Fit source counts
 
fitnegativenobinaryfalse 
Allow fitted count rates to become negative
 
determineerrorsnobinarytrue 
Determine statistical errors
 
withexpimagenobinarytrue 
Use exposure maps
 
withdetmasknobinaryfalse 
If true, only sky pixels inside the detection mask will be used in the PSF fits.
 
withoffsetsnobooleanfalse 
Flag for reading offsets from eident source list - obsolete
 
withxidbandnobooleanfalse 
Controls whether XID band output will be written
 
withsourcemapnobooleanfalse 
Controls whether source maps (one per input image) will be written
 
sourceimagesetsnofilename listsrcmap.fits 
Names of source maps (one per input image)
 
usecalpsfnobooleantrue 
Read PSF from the calibration database. This parameter is obsolete and has no effect anymore.
 
extentmodelnostringgaussiangaussian|beta
Model function for source extent
 
psfmodelnostringellbetaellbeta|medium
Model PSF: fully 2d parameterized analytical EPIC PSFs (ellbeta, default from version 5.17.2 on) or medium accuracy PSF
 
minextentnofloat1.5[0.0$<$param$<$300.]
Minimum allowed value for the extent parameter of an extent model in image pixels
 
maxextentnofloat20.0[0.1$<$param$<$300.]
Maximum allowed value for the extent parameter of an extent model in image pixels
 
withhotpixelfilternobooleanfalse 
If true, the likelihood contribution of the brightest pixel will be ignored (i.e., detections relying on a single pixel will be disregarded).
 
nmaxfitnointeger11,6
Maximum number of neighbouring sources to be fit simultaneously
 
nmulsounointeger11,3
Allow fit to split up one input source in maximum nmulsou sources (nmaxfit$*$nmulsou$\leq
10$)
 
piminnointeger2000[0$<$param$<$20000]
Lower energy boundaries of exposure images; units: eV; one value per input image
 
pimaxnointeger4500[0$<$param$<$20000]
Higher energy boundaries of exposure images; units: eV; one value per input image
 
hrpndefnointeger1 2 2 3 3 40,10
Array of six integer numbers specifying the upper and lower energy band for each of the hardness ratios for PN
 
hrm1defnointeger1 2 2 3 3 40,10
Array of six integer numbers specifying the upper and lower energy band for each of the hardness ratios for MOS1
 
hrm2defnointeger1 2 2 3 3 40,10
Array of six integer numbers specifying the upper and lower energy band for each of the hardness ratios for MOS2
 
xidpndefnointeger2 30,10
energy bands used as XID band for PN
 
xidm1defnointeger2 30,10
energy bands used as XID band for MOS1
 
xidm2defnointeger2 30,10
energy bands used as XID band for MOS 2
 
xidfixednobooleanfalse 
Run emldetect on XID band image with positions and source extent fixed to input values
 
withthresholdnobooleanfalse 
Allow splitting up into multi-PSF fitting only for sources above threshold
 
thresholdnofloat20[1.0$<$param$<$50.0]
Value of threshold for multi-PSF fitting
 
threshcolumnnostringLIKELIKE|SCTS|RATE
Column in input list on which threshold will be applied
 
withtwostagenobooleanfalse 
Use two stage process for multi PSF (nmulsou$>$ 1) fitting
 
imagebuffersizenointeger640100$<$param$<$10000
Parameter that controls memory requirements for raster scan data.
 
withimagebuffersizenobooleanno 
Allow user-defined values of imagebuffersize.
 
ParameterMand Type Default Constraints

$^1$ Space separated list, sorted by instrument and energy band. I.e., energy band one to energy band $n$ of instrument one is followed by energy band one to $n$ of instrument two.
$^2$ One per instrument per energy band
$^3$ One per instrument
$^4$ A parameter value of $1.0$ would thus correspond to an infinite radius.
$^5$ Photon mode is not yet implemented.


References Home Page Errors Home Index

XMM-Newton SOC/SSC -- 2012-12-19