Richard Saxton & Eduardo Ojero
XMM-Newton SOC
The version of the SAS installed can be displayed with the command:sasversion
This release does not include new tasks but a few important bug fixes and improvements, all of which are detailed below.
The changes introduced in this release are the following:
The pysas core package has been improved to provide the correct handling of mandatory subparameters. This change allow to run a full data processing session entirely from Python using a combination of pure Python tasks and SAS native tasks.
Simultaneously with this release, several SAS Threads implemented fully in Python have been released as examples of data processing sessions from ai Python Jupyter Notebook.
The startsas package has been enhanced with new parameters workdir and sasfiles, to provide sufficient flexibility to organize user's work.
This version of SAS is released in two binary versions for Linux, CentOS 7.3 and Ubuntu 18.04, and one for macOS 10.15.7 (Catalina). These versions have been tested and found to run correctly on several other platforms including RHEL 7 and 8, Ubuntu 20 and 21, and macOS Mojave and BigSur.
NEW:None
WITHDRAWN
DELETED: None
ChangeLog Version 1.98.5 - 2021-03-10 (RDS) ------------ (doc/arfgen_description.tex) - refers to a new CAL TN which gives details of the method of using an image to correct for
ChangeLog Version 0.8.1 - 2021-01-15 (EO) ------------- + doc/images.ps: Image was exported to eps to be used in HTML documentation. Size decreased from 2,2 MB to 0.15 MB. + doc/eimageget_description.tex: images.ps -> images.eps.
ChangeLog Version 1.47.2 - 2021-01-21 (EO) -------------- + ChangeLog: Fixed typo in Version. Version 1.47.1 - 2021-01-21 (EO) -------------- + doc/Makefile: Removed unnecessary elements.
ChangeLog Version 0.7 - 2021-02-18 (RDS) ----------------------------- + src/qpbselect.cc Scale the exposure time in the doc/qpbselect_description output spectrum/image rather than converting the counts into a rate (SCR-7591)
ChangeLog Version 1.43.1 - 2021-01-25 (EO) -------------- + doc/fast_blocks2.ps: Exported to EPS format to fix problem in HTML format figure display, which showed not labels inside diagram box.
ChangeLog Version 1.12.1 - 2021-01-25 (EO) -------------- + doc/gscheme3.ps: HTML figure unreadable. Exported to EPS format to make it more readable.
ChangeLog Version 1.74.7 - 2021-03-09 (EO) -------------- + src/omichain.pl: Function HighLightedMessage called in lines 1553 and 3904 is typed wrong It does not exist. It is HighlightedMessage what exists and is defined. Version 1.74.6 - 2021-02-10 (EO) -------------- + test/testomichain: Fixed outdir. Version 1.74.5 - 2021-02-09 (EO & SR) -------------- + doc/omichain_description.tex: Added some corrections to explain better the processing of mosaiced images (thanks to Simon Rosen). Version 1.74.4 - 2021-02-08 (EO) -------------- + doc/omichain_desxcription.tex: Added note at the end of the section on "Running the omichain", to warn users on encountering memory limits when running the source detection process on a large mosaic field. Closes SPR 7590. + doc/omichain_aprt[1-4].ps: Exported to EPS files. psfig command in tex file updated.
ChangeLog Version 2.11 - 2021-02-21 (RDS) ------------------------------- +(src/ommosaic.cc Remove limitation of 4096x4096 pixels src/omwcs.cc) (SPR-7523)
ChangeLog Version 2.4.3 - 2021-02-28 (EO) ------------- + DEPEND: pysas 0.7 -> 1.0
ChangeLog Version 1.1 - 2021-03-12 (EO) ----------- + src/pysas/sastask.py: While checking for mandatory parameters and subparameters, added checking for the "implicit" case: When all the mandatory subparameters of a given parent are present in the command line or in the input args list, it is not necessary to include the parent parameter. It is assumed to be present with value alternate to the default: When the parameter type is boolean, the alternate value is the contrary to 'yes'|'no' set as default. When the parameter type is a string, the alternate value is given in dictionary 'rev_mandpar_string_dict', computed in param.py. + src/pysas/param.py: Fixed typo in the creation of dictionary 'rev_mandpar_string_dict'. + src/pysas/version.py: Ensuring it is updated properly. Version 1.0 - 2021-02-24 (EO) ----------- + src/pysas/param.py : Full refurbishment of the module. Now the module identifies all the subparameters dependent on a given parameter and treats properly the dependencies of mandatory subparameters with its parent parameter. It applies the SAS Parameter Interface rules as documented in package 'param'. Fixed SPRs: 7583 and 7585. + src/pysas/sastask.py: Added new logic to check both the validity of any parameters entered to a task and specially the relationship between mandatory parameters and subparameters. Version 0.10 - 2021-02-18 (EO) ------------ + src/pysas/logger.py: The logging code included initially in sastask.py is now moved to a new module named logger.py. This module defines class TaskLogger which can be used to instantiate a logger to be used in the code as logger = TaskLogger('<taskname>') logger.log('level','<message>') where level can be one of debug, info, warning, error or critical, and <message> is the message to be logged. By default, the logger comes with two handlers, one console handler and one file handler. The file handler produces a log file named as <taskname>.log, with a fixed log level of DEBUG (all messages are registered). However, the console handler provides more or less messages, according to the value of the 'verbosity' which is controlled by means of option -V or the SAS_VERBOSITY environment variable. To be used in modules, the instatiation of the logger must be done out of function definitions. Then, within each function, we can include calls to logger.log('level', '<message>'), as apropriate. + src/pysas/*.py: Changed comments by string docs where appropriate.
ChangeLog Version 0.5.3 - 2021-03-05 (EO) ------------- + DISTRIBUTION: Given that epproc depends on this package, its distribution can not be restricted to SOC.
ChangeLog Version 4.9.1 - 2021-01-25 (EO) ------------- + doc/rgsangles_description.tex: Change history reformatted to fix a problem where the task does not appear in the general index of all tasks.
ChangeLog Version 1.603.6 - 2021-03-17 (EO) --------------- + AKA: Previous version had wrong value 20.0.0. Set now to 19.1.0. Version 1.603.5 - 2021-03-16 (EO) --------------- + bin/saslibs: macOS : Fixed to classify properly internal and external libraries which include the keyword "@loader_path" in their paths as the result of using the RPATH mechanism to find them from binaries. Version 1.603.4 - 2021-01-21 (EO) --------------- + doc/lib/sasref.perl: Change to conditional the require to use the labels.pl from a reference to a given package. This is particularly important for package 'param', which is referred by many tex templates generated by pkgmaker, so they give rise to the error doc/param/labels.pl not found in @INC, unless the DEPEND file puts a dependency on package param, only for treating the documentation.
ChangeLog Version 0.5 - 2021-02-28 (EO) ----------- + DEPEND: Required pysas 1.0.
ChangeLog Version 0.5 - 2021-03-15 (EO) ----------- + config/startsas.par: - Redefined workdir as optional. Default is "pwd" which is interpreted as to take as working directory the directory from where startsas is launched. If not defined absolutely ('/' is not the first character of the string), it is assumed to be a subdirectory of the startsas launch directory. - Added parameter 'sasfiles', boolean, default 'no'. This parameter is the parent for 'sas_ccf'and 'sas_odf'. Both are kept as mandatory subparameters but now they must be defined with absolute path. Version 0.4 - 2021-03-02 (EO) ----------- + src/startsas/startsas.py: - Removed any tar files downloaded during processing. - sas_ccf and sas_odf are now mandatory with workdir as its parent parameter. In case any or both of these two subparameters are given the workdir must be present and be set as workdir=other. Then sas_ccf and sas_odf values are expected in workdir. + config/startsas.par: sas_ccf and sas_odf now are decalred mandatory with workdir defined as its parent parameter. workdir is by default set to 'pwd', but if sas_ccf and sas_odf are present in the command line or in the args list, then workdir must be present and set as workdir=other. + doc/startsas_description.tex: Updated. + src/startsas/bin/startsas: If no arguments are given then startsas is executed with args = ['-h'], so as the command 'startsas' will output the standard help for the task. Version 0.3 - 2021-03-02 (EO) ----------- + DEPEND: pysas 0.7 -> 1.0. + config/startsas.par: Added paramater 'workdir' which allow to specify the working directory. If not specified, the default is the directory from where the task is started. Can use environment variables like $HOME or even bac tick commands like `pwd`, in the directory defintion. + src/startsas/startsas.py: * String docs refurbished to provide proper help on the task. * Added logging via TaskLogger class (pysas.logger). * Task produces startsas.log with full DEBUG information. File is created in append mode. It is created in the directory where the task is started. * Kept sas_ccf and sas_odf parameters to allow setting SAS_CCF and SAS_ODF from ipython/notebook interfaces. * Logging to console is controlled via -V/--verbosity option. * stderr when working from a notebook is kept out of it.
ChangeLog Version 2.2 - 2020-11-15 (EO) ----------- + test/tasks: Removed pythontask.py and runpythontask. + src: Removed main.py. + src/main.pl: Perl she-bang set to '/usr/bin/env perl'. Added use warnings.
ChangeLog Version 0.3.7 - 2021-02-28 (EO) ------------- + DEPEND: pysas 0.7 -> 1.0