NAME
iros (Iterative Removal Of Sources) reconstruct celestial image for a
detector-image.
SYNOPSIS
* iros
* iros -p [options] di irs
The program can be started with no arguments at all, in which case the
parameter values are taken from the parameterfile.
Alternatively, values can be passed via the commandline, the required items
as command arguments, the optional ones as valued switches.
The table lists all the parameters used by iros, the second column lists the
paramater key names used in the parameterfile, the first column gives the
corresponding switch letter.
iros parameters
switch key value IO description
expfile string i input di, detector image file.
resfile string o output, reduced sky and det image, sourcelist
.res
I insfile string i overrides the IDF name in expfile.
k catfile string i overrides default X-ray source catalog
(environment).
a anafile string i -NOT YET IMPLEMENTED- use analyse outputfile
'name' as initial sourcelist.
b attfile string i attitude data file, overrides default path/name
stop criterium, threshold, sources detected may
d trshld real i account for at most a fraction 'r' of the total
counts in the detector
r radius real i maximum radial distance between detected and
catalog X-ray source for identification.
c cmode int i correlation mode, correlate
absolute limit on number of iros iterations,
n niros int i default is 15, but if niros is not assigned iros
will also stop at an increase in Chi2.
1 suppress use of X-ray source catalogs.
2 interactive operation, subtract detected
sources one by one, prompting the user for
position, flux and pointspread function
modification.
4 use all detected sources in second and next
iterations, whether this source could be
identified or not.
m iros int i
8 accept any pixelconfiguartion as valid source.
16 suppres use of source list found as
(FITS)extension in input detector image (usually
simulated data).
32 treat detector as having no pointspread
function, all pixels from a reconstructed x-ray
source in the celestial image are treated
separately.
s srclim int i limit number of sources considered to subtract.
p p_filtr area i in(ex)clude section form detector image input.
- xchisq int i NOT used in this releasedet. fit control,
y inlcrcn int i set to 1 to use integral detector non-linearity
data.
h atmhght real i earth atmosphere thickness (km).
when detector image input is TSPZ(TeleSPaZio
- ofits int i format, applicable for QLA only), force FITS
output.
p debug int i only as first commandline argument: ignore
parameterfile, set debuglevel. general
i title string i file title, description cq. comments. general
L logfile string i redirect diagnostic and informational messages.
see general
mode "ql" i has meaning for (some) parameterfile
parsers/readers only.
DESCRIPTION
the output file contains a primary image and 2 extensions: (PRIMARY)
residual celestial-image, resulting from cleaned detector.
WFC_Sourcelist(BINTABLE) row for each identified source (position, name,
flux etc.) rdi (IMAGE ) residual detector-image
* correlate reconstruct the celestial image from the detector image.
* analyse locate the sources in the celestial image.
* simulate compute the (average) detector image produced with
this sourcelist. -linearisation- iv. subtract subtract the simulated
detector image from the measured one, and iterate the procedure with this
'corrected' detector image. -binning- as defined in the
instrument-file(FITS)
EXAMPLE
NOTE
SEE ALSO