Subject: Flag usage in j_ima_iros

Hallo:

Her kommer beskrivelsen af j_ima_iros 'flag' brugen.

niels

***********************************************



******  J_IMA_IROS USE OF 'FLAG' IN SRCL_RES  ****************

Niels Lund 08/11 2007

The flag value in srcl_res will be set according to the following logic:

The '1'-bit of the flag word will reflect the '1'-bit of the flag in the
'user catalog'

The '2'-bit of the flag word will reflect the '2'-bit of the flag in the
'user catalog'

The '4'-bit of the flag word will indicate that the source has been 
detected by ima_iros in the first source search energy band - or, if
the source has been flagged with a '1' or a '3' in the 'user catalog',
that the detsig value for the source is greater than 4.0.   

The '8'-bit is a corresponding flag bit for the second source search 
energy band. 

The '16'-bit is a corresponding flag bit for the third source search 
energy band. 

The '32'-bit of the flag word will indicate that the source has been 
detected by ima_iros when combining the three source search energy 
bands. 

The '64'-bit of the flag word will indicate that the source has been 
identified with a catalog source when combining the three source search 
energy bands. In this case the catalog source positions has been used 
for the final flux fits. 

The '128'-bit of the flag word will indicate if the source has been
accepted as a valid source by ima_iros - or it has been flagged with 
'3' in the 'user catalog'. 

****

A source will appear in srcl_res if at least one of the following
conditions is met:

-A) The source is detected in at least two of the three source search
energy bands.

-B) The source is detected in only one of the search bands, but the 
detection has a significance exceeding a threshold defined by the
'detSigSingle' parameter.

-C) The source is marked with '3' in the 'User catalogue'. Flag bits
'128', '64' and '32' are set to 'one' and flag bits '16', '8' and '4'
are set according to the detsig values in the corresponding energy
bands.

-D) The source is marked with '1' in the 'User catalogue'. If the
source has not also been accepted according to condition A or B the
flag bits '128', '64' and '32' are set to 'zero' and flag bits '16', 
'8' and '4' are set according to the detsig values in the corre-
sponding energy bands.


****

The nominal source search energy bands are: 3-7 keV, 7-11 keV and
11-20 keV.