SAS Release Notes 1610 - XMM-Newton

                     Release Note for SAS 16.1.0
                     ===========================

                   Carlos Gabriel & Eduardo Ojero
                         XMM-Newton SOC




* Contents

  . SAS releases covered by this note
  . URLs
  . Summary of important changes
  . New and withdrawn packages
  . Detailed list of changes between SAS 16.0 and SAS 16.1

* SAS releases covered by this note


The version of the SAS installed can be displayed with the command:

                              sasversion

This version (16.1.0): xmmsas_20170719_1539

Last public version  (16.0.0): xmmsas_20170112_1337


* URLs

SAS pages at the XMM-Newton SOC: http://www.cosmos.esa.int/web/xmm-newton/sas-news
   http://www.cosmos.esa.int/web/xmm-newton/sas

XMM-Newton calibration information:
   http://www.cosmos.esa.int/web/xmm-newton/calibration


*Summary of important changes


The release of this sub-version is necessary for correcting some SASv16.0 issues
related to source detection, detailed below.



The changes introduced in this release are the following:


- eboxdetect:  correction of a  bug introduced  with SASv16.0  that made
 some obvious sources  to be missing in the EPIC source lists of a few
 observations.


- emldetect:  reduction  of  the  number  of  spurious detections,  and
 solution to the problem of missing valid detections close to chip gaps
 or very far off-axis.


- especget: improvement of the performance for large background regions.


- eimageget: solved a problem with tangential plane projections in large
 images.


- eimagecombine:  significant  reduction  of  the usage of  disk  space
 through compression of intermediate files.


We took also the opportunity to include a minor upgrade of esas, the task collection for
analysis of extended sources. In addition all the six packages corresponding to the patch
issued in February are also contained in this release.


This version of SAS is released  in two 64-bit binary versions for Linux
(RHEL  6.8  and Ubuntu  16),  and  two for  Mac  OS  X (El Capitan  and
Sierra).  The versions  released have  been tested  to run  correctly on
several other platforms.


* New and withdrawn packages

NEW:
Package eboxdetect: version 4.27.4 [was 4.27.3]


Package eexpmap: version 4.11.2 [was 4.11.1]


Package eimagecombine: version 0.8.1 [was 0.8]


Package eimageget: version 0.7 [was 0.6]


Package emldetect: version 7.1 [was 7.0.3]


Package epchain: version 8.76.1 [was 8.76]


Package epexposure: version 0.14.1 [was 0.14]


Package epicproc: version 2.21.1 [was 2.21]


Package epnoise: version 0.7.4 [was 0.7.3]


Package esas: version 0.9.40 [was 0.9.39]


Package especget: version 1.48.2 [was 1.44.2]


Package esplinemap: version 5.0.2 [was 5.0]


Package rgsproc: version 1.34.8 [was 1.34.7]


Package sas: version 1.580.3 [was 1.580.1]




WITHDRAWN:
none

DELETED:
none



* Detailed list of changes between SAS 16.0.0 and SAS 16.1.0

A detailed list of all upgraded tasks wrt SAS 16.0.0 follows, the corresponding
ChangeLogs are further below:

ChangeLog

Version 4.27.4 - 2017-01-16 (IT)
--------------
	+ ebox_io.f90: Fixed two typos in the new subimage coordinates of the
	  detection masks.
	+ release memory for CAL pointers
	+ increased some internal array sizes

Version 4.27.3 - 2016-12-03 (IT)
--------------
	+ Removed debugging comments from the code after testing v4.27.2.
	+ Updated documentation: Parameter withoffsets=yes (obsolete
	  eident offsets) yields a warning; no other effect anymore.

ChangeLog

Version 4.11.2 - 2017-06-22 IT
------------
	+ eexpmap_mod.f90: More pointers need to be nullified and
	  badpixtype has to be initialized with zero for gfortran.

Version 4.11.1 - 2016-11-14 (AI)
------------	
	+ (src/eexpmap_mod.f90) Initialization to null (at declaration statement)
	of those pointer that will be used by the CAL to avoid seg fault in gfortran.

ChangeLog

Version 0.8.1 - 2017-06-19 (mjf)
--------------------------------
- (src/eimagecombine.sh): compress intermediate files that are not re-used
  immediately but kept until the end (to reduce used disk space significantly)
- (test/eimagecombine_test_1): check for existence of compressed files

Version 0.8 - 2015-12-08 (nclerc)
---------------------------------
- add consistency check on SUBMODE for each image/exposure/band

ChangeLog

Version 0.7 - 2017-06-19 (rds/mjf)
----------------------------------
- (src/eimageget.sh): changed from "attcalc" to "attcalc2" projections
- (DEPEND): added attcalc2-1.3

Version 0.6.1 - 2017-01-21 (mjf)
--------------------------------
- (doc/eimageget_description.tex): minor editorial changes
- (doc/eimageget_description.tex): adapted link to new cosmos web structure
  (SPR-7416)

ChangeLog

Version 7.1 - 2017-05-29 (IT)
-----------
	+ New algorithm to determine the subimages. Cf. eboxdetect.
	+ Initialized some more arrays with zero for gfortran.
	+ emldata.f90: renamed event to events and event_type to
	  events_type, just to be on the safe side. event and event_type has
	  been introduced in iso_fortran_env (which we are currently not
	  using).
	+ emldetect_mod.f90, call to mlout: argument rawflag has to be
	  addressed according to parameter withrawrows; value true
	  accidentally remained from the test phase (SPR-7431).


Version 7.0.3 - 2016-11-08 (IT)
-------------
	+ fftpsf.f90: Sloppy indexing caused occasional segmentation
	  faults, in particular if emldetect is compiled with gfortran.
	  Also make sure that arrays are initialized with 0 for gfortran
	  compatibility. Fixes SPR-7405.

ChangeLog

Version 8.76.1 - 2017-01-16 (MJF)
---------------------------------
- (src/epchain): activated parameter "applyfilter" [epnoise]
closed SPRs:
- SCR-7415: epnoise parameter "applyfilter" not activated in epchain

Version 8.76 - 2016-07-15 (MJF)
-------------------------------
- (src/epchain): added parameter "withxrlimage" (task "epxrlcorr", default "N")
   that controls creation of a diagnostic X-ray loading image image (SCR-7114)
- (config/epchain.*): as above
- (doc/epchain_description.tex): as above
- (DEPEND): needs `epxrlcorr-1.0'

ChangeLog

Version 0.14.1 - 2017-01-23 (AI)
-------------------------------	
- (src/epexposure_mod.f90) Initialization to null of pointer that is passed
	  to C++ (Dope vectors). If we do not initizialize the pointers,
	  we get seg fault at run-time with gcc-6.2 (gfortran).
	
Version 0.14 - 2016-09-16 (MJF)
-------------------------------
- (src/epexposure_mod.f90): take care of empty input EVENTS extension

ChangeLog

Version 2.21.1 - 2017-01-23 (AI)
-------------- 		
	+ epnoise parameter "applyfilter" added to epproc param interface.
	
Version 2.21 - 2016-08-26 (RDS)
-------------- 		
	+ DEPEND - updated

ChangeLog

Version 0.7.4 - 2017-01-16 (MJF)
--------------------------------
- (doc/epnoise_description.tex): minor editorial changes

Version 0.7.3 - 2012-07-10 (AI)
--------------------------------
- Debug lines removed

ChangeLog

Version 0.9.40 - 2017-02-24 (BP)
	+ Minor bug fixes to mos\_back and pn\_back.
	+ Bug fix to conv\_reg.f90.
	+ Fix to cheese code (QDP plot truncation issue solved).
        + Parallel updates to GVariables.pm and parameters.init (cheese).

Version 0.9.39 - 2016-10-18 (BP)
	+ Removed tasks cheese-bands and conv-region (both redundant).
	+ Re-added task cheese (removed by mistake, SPR:7402).
	+ Cleaned up config files.
	+ Adjusted hardcoded array to accommodate new QPB files (subsn).

ChangeLog

Version 1.48.2 - 2017-06-23 (RDS)
-----------
	+ config/eupper.par             - Added new param expmode to support
	                                  combined image upper limits

Version 1.48.1 - 2017-06-19 (RDS)
-----------
	+ src/Esizeit.cc                - Fix for compatibility with GCC 4.3

Version 1.48 - 2017-06-16 (RDS)
-----------
	+ src/eupper.cc                 - Give bckgnd subtracted count rate
	                                  in output stream
	  src/especget.cc                 Faster calculation of BACKSCAL for
	                                  background region

Version 1.47 - 2017-06-05 (RDS)
-----------
	+ src/eupper.cc	       	        - Give observation ID and dates in
					  output stream

Version 1.46 - 2017-05-18 (RDS)
-----------
	+ src/Eradial.cc	        - Limit polynomial fit to linear
					  (SPR-7428)
	  src/ecoordconv.cc		  Output image pixels.
	  src/eupper.cc			  More flexible header keyword
	  				  treatment.
	  esizeit task			  Finds sky area of exposure maps
					
Version 1.45 - 2017-02-02 (RDS)
-----------
	+ src/ImageRegion.cc	        - Fixed rotation angle for DETX/Y
					  ellipse.
					
Version 1.44.2 - 2016-03-11 (RDS)
-----------
	+ doc/eupper_description.tex          - Better description of upper
	  doc/eregionanalyse_description.tex	limit calculation

ChangeLog

Version 5.0.2 - 2017-07-04 (IT)
--------------
	+ typo in esp_smooth_mod.f90, accidentally introduced with 5.0.1


Version 5.0.1 - 2017-02-22 (IT)
--------------
	+ Multiply the OOT image with the mask before subtracting it from
	  the image.
	+ esp_smooth_mod.f90: Throw a warning, if the total count numbers
	  of the cheesed input image and of the cheesed background map differ
	  by more then ten per cent.
	+ Updated documentation of cheesed image (output).

ChangeLog

Version 1.34.8 - 2017-01-23 (AI)
------------
	+ Default value for parameter "includeinputfifofull"
	set to "yes"
	
Version 1.34.7 - 2017-01-09 (AI)
------------
	+ Doc updated to include the choice parameter "badpixalgo".
	This parameter enables the option "embadpixalgo" that
	calls to "embadpixfind" task algorithm to filter
	hot pixels and columns.

ChangeLog

Version 1.580.3 - 2017-07-06 (EO)
---------------
	+ configure_install:
		- Fixed typo (urs) in function to do the screening for available
		perl installs for the case where perl is provided in /usr/local/bin
		as a real perl binary, not as a soft link.
		- Syntax comments refurbished.
		- Scripts to initialise SAS are now identified by SAS RELEASE
		and AKA, not with $Id$ from CVS which is no longer used.
	+ Makefile.top: Added $(DNAME)/AKA to the files packed in target
	binary-archive so that the file AKA will be included in the SAS
	installation.

Version 1.580.2 - 2017-06-19 (EO)
---------------
	+ configure.in: Changed to 16.1.0 to be able to build SAS 16.1.0.
	+ AKA: 16.1.0.

Version 1.581 - 2017-01-24 (EO)
-------------
	+ Initiating SAS 17.0.0 devlopment.

Version 1.580.1 - 2017-01-12 (EO)
---------------
	+ configure_install: Fix perlsed when SAS_PERL is selected.