Overview

The scientific analysis performed by the user on the data collected by the three high-energy instruments on-board INTEGRAL has a lot of commonality, despite the various differences in detail. In a certain step, for example, events are corrected for instrumental fingerprints, in another one events are binned into detector maps, and in yet another step sky images are derived by image deconvolution.

In order to make this more transparent for scientists working with data from several instruments, so-called Analysis Levels were identified by the ISDC and designated with unique labels. The order of these levels, the detailed processing and the details of the outputs may differ across instruments, but in general, a given level will mean similar tasks and similar outputs for JEM-X, IBIS, and SPI. The list of all levels is given in the Introduction to the INTEGRAL Data Analysis [1]. For JEM-X the following levels have been defined:

Table: Overview of the JEM-X Scientific Analysis Levels.

Tasks	Description
COR	Data Correction
GTI	Good Time definition and handling
DEAD	Dead Time derivation
CAT_I	Catalogue source selection for Imaging
BIN_I	Event binning for Imaging
IMA	Image reconstruction, source flux determination
SPE	Source spectra and response extraction (for XSPEC)
LCR	Source light curves extraction
BIN_S	Creates full-FOV spectrum
BIN_T	Creates full-FOV light curves
IMA2	Creation of mosaic images and summary on found sources

Figure shows the Scientific Analysis overview. The details of each step are briefly discussed below.

Figure: Decomposition of the jemx_science_analysis script.

COR - Data Correction (j_correction)

Corrects science data for instrumental fingerprints such as energy and position corrections, as well as flagging events of dubious quality. Look up tables of pre-flight corrections are used, as well as tables of in-flight calibrations determined by offline analysis of science data, calibration spectra, and instrumental background lines. Dynamic determination of known transient problems (e.g. hotspots on the detector) is also done in this level. The majority of calibration tables are stored in the Instrument Model group, JMXi-IMOD-GRP (with i = 1 and 2 for JEM-X1 and JEM-X2, respectively), but the offline gain history Instrument Characteristics tables are stored separately in JMXi-GAIN-OCL data structures. The latter are also located automatically by the OSA software just like the IMOD group.

GTI - Good Time Handling (j_gti)

Good Time Intervals (GTIs) are used in the analysis to select only those data taken while the detector was considered to work correctly. The corresponding data structures consist simply of a list of start and stop times of those intervals considered ``good''. Usually, these intervals are generated based on the following data:

1. Housekeeping parameters which are compared with pre-set limits.
2. The satellite stability as recorded in the attitude data.
3. Gaps (lost packets) in the telemetry flow.

In addition, this step excludes by default periods when the instrument configuration is not adapted to the production of scientific works, either because of hardware problems or because of intentional modifications of the instrument configurations for the purpose of testing and calibrations. These periods are marked as "bad time intervals"in the Instrument Characteristics data.

DEAD - Dead and Live Times (j_dead_time)

For each 8 second onboard polling cycle, this level calculates the dead time during which photons are lost due to finite read in time of registers, event processing time, grey filter losses, buffer losses and double event triggers.

CAT_I - Catalogue Source Selection (j_cat_extract)

Selects a list of known sources from the given catalogue. Creates a source data structure, containing source location and expected flux values.

BIN_I - Event Binning for Imaging (j_image_binning)

Defines the energy bins to be used for imaging, selects good events within the GTI, and creates shadowgrams. Works only on FULL and REST data (see Table ).

IMA - Image Reconstruction (j_imaging)

Generates sky images and performs search for significant sources. If sources are detected, a new source data structure is created, including part of the information from the input catalogue concerning the identified sources. Works only on FULL and REST data (see Table )

SPE - Spectra Extraction (j_src_extract_spectra)

Extracts spectra for individual sources found at IMA step, and produces the specific response files (ARFs) needed for spectral fitting with the XSPEC package. Works only on FULL data (see Table ).

LCR - Extract Source Light Curves (j_src_extract_lc)

Produces light curves for individual sources. Works only on FULL data (see Table )

BIN_S - Event Binning for Spectral Analysis (j_bin_spectra)

Creates detector spectra, i.e spectra of all events recorded within the GTI are corrected for greyfilter, ontime and deadtime. A series of spectra resolved in time or phase over a given period can be produced.

BIN_T - Creates Detector Light Curves (j_bin_lc)

Creates binned lightcurves for entire detector area.

IMA2 - Mosaic Image Creation (j_ima_mosaic, src_collect)

Generates mosaic sky images and creates the list of all found sources. Works only on FULL and REST data (see Table )

Since October 18, 2004 all the data that are publicly available from the ISDC archive have already undergone the CORrection step, instrumental GTI and DEADtime handling. Although in principle one could then directly start JEM-X analysis from the CAT_I level, it is nevertheless recommended that users run the science analysis from the COR level onwards, especially after downloading new software, and IMOD/IC files. This will undoubtedly give better results than the archived data. Archived data necessarily fossilize our understanding of the instruments as it was at the time of the archival processing and can therefore be several years out of date since our knowledge of the instruments, and the software to process the data is still improving.