A short introduction to j_ima_iros 5.1.29 (intended for the OSA-11 release) Niels Lund, June 2017 ***** Major new features (compared to the OSA-10 version of j_ima_iros): 1) Ability to generate source light curves, taking into account the improved knowledge of the instrument peculiarities gained since launch. The light curves will appear in the 'jmxN_src_iros_lc.fits'-file. The format of this file is identical to the format of the old 'jmxN_src_lc.fits' files. 2) If the light curve feature is activated, all source light curves will be subject to a "burst"-search. Sources for which bursts are detected will be indicated in the the 'jmxN_srcl_res.fits' file with a particular flag bit set (bit value 512 set). 3) In addition to the search for bursts in the source light curves also a number of detector light curves will be generated, and will be searched for bursts. If a burst is found in the detector light curve, which has not already been associated with a known source, the program will automatically extract a sky image from the indicated time interval nd try to find the bursting source. If an interesting source is found it will be included in the 'jmxN_srcl_res.fits' file. ***** Controlling the light curve generation from j_ima_iros 5.1.29: The lightcurve feature is activated by setting the (new) parameter 'useIROS' to "y", see example below. The 'endLevel' parameter should be set to "IMA", when the j_ima_iros light curves are desired. The 'timeStep' parameter controls the light curve binning. THe time penalty for gebnerating light curves is small as long as the 'timeStep' is larger than 1 (s). Be aware that both the execution time and the memory usage will increase strongly for timeStep values less than 0.5 s. timeStep values less than 0.1 s are not allowed. ***** Requesting light curves for specific sources In the basic configuration j_ima_iros will generate light curves only for the sources which have been detected in the current science window plus detector light curves. It may happen, that a source is too weak to be detected during the normal source search, but it may exhibit a burst which is bright enough to trigger in the detector light curve. When the light curve feature is activated also such a source will be included in the 'jmxN_srcl_res.fits' file. If it is of interest to obtain light curves for specific sources even if they are too weak to be detected during the burst search, this can be achieved setting the 'flag' value to "1", in the user_catalog, 'usrCat'. For instance, during the development of the new j_ima_iros version we frequently used a 'user_catalog' in which all known R-ray bursters were marked with flag = 1. This resulted in the detection of quite a few bursts, which was not noticed in the detector light curves. ***** Example parameter file: j_ima_iros jemxNum=jemxnum endLevel=IMA obsDir=proj_name_jemxnum_block \ instMod=/scratch/jemx/nl/imod_grp/jmxjemxnum_imod_grp_zzzz.fits+1 \ response=/scratch/jemx/nl/rmf_grp/jmxjemxnum_rmf_grp_qqqq.fits+1 \ dolBPL=/scratch/jemx/nl/bpl_grp/jmxjemxnum_bpl_grp_0007.fits+1 \ usrCat=/r6/jemx/catalogs/XRB_NL_01.fits+1 \ useIROS="y" \ timeStep=5.0 \ skyImagesOut=SIGNI,PIF,DEVEL &