RELEASE NOTES FOR SWIFT PIPELINE, version proc3.15.03 ----------------------------------------------------- Note: proc3.15.01 and proc3.15.02 were internal development versions on sdcdev that were never put into production. * Uses HEASoft-6.11, with the following patches, which we expect will be incorporated into the next HEAsoft release: 1) Two patches to fsort.f from Bryan Irby, 3.1e and 3.1f, which permit its use on 0- and 1-row extensions (it just bypasses sorting in those cases). 2) Tim Reichard's patched ftools/image/ximage/src/readwr/wr_fithdr.c, which fixes an error in the location of the WCSAXES keywords that caused files to fail ftverify. The security context of the libraries had to be adjusted with chcon after installing this patch (see below.) (It appears that this in included in HEAsoft-6.11.1.) 3) Bob Wiegand's modified uvotproduct which keeps ds9 from stalling the job when the STScI DSS server does not return a valid image, causing ds9 to try to put up an interactive prompt window. 4) Bob's new swiftxform. This replaces 3 directories and adds 1: attitude/lib/rew/ attitude/tasks/minnow/ (new directory) swift/gen/tasks/swiftxform/ swift/uvot/tasks/uvotimage/ The old versions have been renamed to ".orig". The .tgz files Bob supplied are in the respective parent directories. The security context of the libraries had to be readjusted with chcon after installing this patch (see below). 5) In the new uvotimage supplied by Bob above, in the call to swiftxform changed the value of parameter "alignfile" to 'CALDB'. 6) Bob's "6.11.delta.tgz" patches to coordinator, getxform, swiftxform, and uvotexpmap, plus some subsequent bug fixes, also to implement the swiftxform issues above. 7) Craig Markwardt's patches to batdetmask (his taskvers=1.6 and 1.7), which try to fix the errors batdetmask sometimes produces when reading the "outfile" parameter; and to read the "clobber" parameter with PILGetBool instead of PILGetString, hopefully fixing intermittent errors that sometimes occur when reading this parameter. 8) Bob's patch to uvotgraspcorr (version 1.1, rev 1.13): infile may now be a comma-delimited list of files, or a reference to a file containing a list of file names. * Other notes concerning HEAsoft-6.11: - Built in a "clean" environment, ie. no previous headas, lheasoft, heasoft, ftools or /aps/tools directories in $PATH. - "/aps/tools/gcc/gcc-3.4.3/bin:/aps/tools/perl/bin:" at beginning of $PATH. This is required; supposedly there are, or have been, issues with later versions. - "scat" program copied in from previous version. (We think scat may have originally come from SDSS.) - Security context of libs must be adjusted after building with the command: chcon -t texrel_shlib_t * - There must be a symlink in the /bin/ directory to the ds9 program. ds9 is not by default in the path, at least on our system. * The following programs in /aps/tools/ needed to be rebuilt using HEAsoft-6.11. Note that they were built in new subdirectories named *_heasoft6.11 to indicate this. - stools - fitspackets - acs2fits - swift2fits/bat2fits, swift2fits/tdrss2fits, swift2fits/uvot2fits, swift2fits/xrt2fits * Uses caldb20110812. * sw0: - Updated "use lib" statement for proc3.15.03. * sw0.par: - New parameter "refattopt", reference attitude options which are passed by UvotAttitude.pm and UvotImages.pm to uvotexpmap, swiftxform, and uvotimage. - New parameter "targetSkipFC", a space-separated list of targets for which UvotProduct.pm should NOT try to generate finder charts (typically because the DSS server returns an error instead of a valid image). A later fix to the uvotproduct program obviates the need for this in most cases. - New parameter "watchers_JDcat" contains a list of email addresses to which UvotProduct.pm will send problems reading JD's catalog. - Updated the program path parameters to use the heasoft-6.11 versions. - Updated the "caldb" parameter to reference caldb20110812. - "starcatalog" parameter has been syncronized between the development, production, and CVS repository versions. - "version" and "watchers" parameters updated. * Subs/BATBurst.pm: - sub slew_only: if @rows is empty, skip rest of the sub and log a warning, avoiding a "missing ROW parameter" error from ftedit. * Subs/BATImages.pm: - When calling fthedit to remove the HDUNAME keyword, use operation=deleteall instead of delete, because delete complains if the keyword is not in the header, but deleteall accepts this case. * Subs/CalSources.pm, Spectra.pm, XrtGrbLc.pm: - In xspec script, add "setplot splashpage off /*" which prevents xspec from creating a title image in the first file and putting the real plot into a second file. * Subs/StartEndTimes.pm: - Avoid possible infinite loops in certain cases of overlapping GTIs. * Subs/UVOT2FITS.pm: - "Uvot damaged image file created" is now an E1 warning instead of an E2 fatal error. * Subs/UvotAttitude.pm, UvotImages.pm: - Added "refattopt" parameter, read from sw0.par, to the calls to uvotexpmap, swiftxform, and uvotimage. - Added "alignfile='CALDB'" parameter to calls to uvotexpmap and swiftxform. * Subs/UvotAttitude.pm, UvotImages.pm: - Call uvotmodmap with parameter "ncell=16" instead of =2. * Subs/UvotProduct.pm: - If the target is listed in parameter targetsSkipFC, skip the calls to ds9 and thus don't create the finder charts, by calling uvotproduct with fcprefix=NONE. - Many changes to make reading the burst catalogs more robust, especially JD Myers's (get_grb_coord and getTrigFromJDCatalog), and with more diagnotic output. - Email an alert to addresses listed in the "watchers_JDcat" parameter if there are problems parsing the entry in JD's catalog. - convertRAStringToDegrees and convertDecStringToDegrees now log warnings if the string has an invalid format or couldn't be converted to a number. They are now object methods instead of subroutines so they can log messages. - Not finding a burst in one of the catalogs now logs informational messages instead of warnings. (Not finding it in any catalog remains an E1 warning.) AddTrigTime now warns if a burst is not found in any catalog. * Subs/XRT2FITS.pm: - In the WT event files (*xwt*uf), set the TIMEPIXR keyword to 0.5, at the request of the XRT team. (This should propagate to the *xwt*ufre and *xst*cl files.) * Subs/XrtGrbLc.pm: - Add object and sequence to the "OPTICAL GRB coordinates outside XRT coordinates" alert email. * Throughout: - Removed unused sources and backup files. (Those that were in the CVS repository are still there, should they need to be retrieved.) - HISTORY headers and "Log:" tags added to source files that didn't have them. - CVS-tagged as "proc3_15_03".