== eSASS  naming convention changes ==

At the eSASS telecon of 5-Feb-2018 we decided to implement the following eSASS naming convention changes:

 * The contents of the INSTRUME and INSTRUMn standard eSASS FITS header keywords will be changed from FM1...FM7 to TM1...TM7, where TM stands for "Telescope Module'.

 * The new INSTRUME/INSTRUMn keywords will be implemeted in the caldb as follows: 
  1. The contents of the data/erosita/fm1...fm7 directories will be duplicated to directories data/erosita/tm1...tm7 and the new directories will be added to the caldb.config file.
  2. In the standard calibration file names in the new directory tree fm1...fm7 will be replaced with tm1...tm7. 
  3. The content of the INSTRUME keyword in the calibration file headers will be changed from FM1...FM7 to TM1...TM7. 
  4. The udcif command will be run to integrate the new calibration files into the caldb.indx files.
  5. After the changeover to the new  INSTRUME/INSTRUMn keywords is completed, the FM1...FM7 instruments can be removed from the caldb.

 * The CCDNR column of the EVENTS extensions of the calibrated event files will be renamed to TM_NR.

 * The CCDNR column of the ERMLDET source lists will be renamed to TM_NR.

Ideally the changes should be implement and tested in the next weeks, in time for the new eSASS users release planned for March 2018, which will be made available ahead of the upcoming consortium meeting. The required changes will be minor but a large number of eSASS tasks as well as the preprocessor will be affected. The following table is intended to track the times when each change is implemented. Please fill in the dates and any comments for your tasks. Also, the list may not be complete, please add missing tasks as needed. 

|| '''task'''       || '''change planned''' || '''date implemented<<BR>>+first version supporting TM*''' || '''responsible''' || '''comment'''                   ||
|| caldb            || week of Feb 19       ||                        ||    HB             || does not break pre-change eSASS ||
|| pipeline control ||                      ||                        ||    HB             || 1)                              ||
|| eroio            ||                      ||Feb 23, 2018, V2.25     ||    GL             || reads CCDNR,TM_NR, writes TM_NR ||
|| tmsplit          ||                      ||                        ||    IK             || 1)                              ||
|| preproc          ||                      ||                        ||    SF             || 1)                              ||
|| evprep           ||                      ||                        ||    MF             || 1)                              ||
|| ftbadpixfind     ||                      ||                        ||    ?              ||                                 ||
|| pattern          ||                      ||                        ||    KD             || no change necessary             ||
|| energy           ||                      ||                        ||    KD             ||                                 ||
|| attitude tasks   ||                      ||                        ||    GL             || no change necessary             ||
|| telgti/telselect ||                      ||                        ||    GL             || no change necessary             ||
|| telstage         ||                      ||                        ||    HB             || 1)                              ||
|| expmerge         ||                      ||                        ||    HB             || 1)                              ||
|| evtool           ||                      || Version 1.17, Feb 19, 2018                       ||    CG             ||                                 ||
|| expmap           ||                      ||                        ||    HB             ||                                 ||
|| erbox,ermldet    ||                      ||                        ||    GL             || no change necessary             ||
|| ersensmap        ||                      ||                        ||    GL             || no change necessary                                  ||
|| apetool, shapelib||                      ||                        ||    AG             ||                                 ||
|| catprep et al.   ||                      ||                        ||    CG             ||                                 ||
|| srctool          || week of Feb 19       || Version 1.16, Feb 23, 2018 ||    TD         || Tolerates instruments named 'FM[1-7]' or 'TM[1-7]', and eventlists containing columns called 'CCDNR' or 'TM_NR'. <<BR>> However, due to there being no 'TM[1-7]' calaibration files at the time, SRCTOOL v1.16 was hard-coded to query the CALDB only for instruments named 'FM[1-7]'. This kludge was removed from SRCTOOL versions v1.17+.  ||
|| datool           ||                      ||                        ||    CG             || should work as long as evtool is replaced                                ||
|| flaregti         ||                      || Version 1.8, Feb 20, 2018 ||    JS          || implemented (currently includes backward compatibility for evts with CCDNR) ||


1) does not affect user eSASS