• Download HEASOFT
  • ******************************************************************************
                           RELEASE NOTES FOR HEASOFT 6.1.2
                                  December 6, 2006
    ******************************************************************************
    
    The HEASoft 6.1.2 release is primarily driven by the release of the Swift 
    (version 2.6) and Suzaku (version 3), but also includes updates to several 
    tasks in the attitude subpackage, and in the FTOOLS, XANADU, HEAGEN, & RXTE  
    utilities which have been revised to mirror the current development versions 
    in use at the HEASARC.  This release also includes CFITSIO v3.02 and a new
    version of the parameter interface APE (version 1.1) to more closely align
    its behavior with PIL and XPI.
    
    As before, configuration-related changes thoughout the package means that
    users who already have HEASoft v6.x.x installed will need to completely
    replace their software installation; there is no clean way to simply
    overlay this new release or to update an existing installation.
    
    New with the HEASOFT 6.1.2 release are pre-compiled binaries for the
    64-bit Linux architecture.  Support for the OSF/Alpha architecture
    has been dropped.
    
    ******************************************************************************
                                       ATTITUDE
    ******************************************************************************
    Attitude software changes since HEASoft v6.1:
    
     coordinator:
        
      - Include DATE* keywords by default in CALDB query.
    
     tristarid:
    	
      - Record correction details in FITS keywords.
    
    
    ******************************************************************************
                                       HEACORE
    ******************************************************************************
    
    - Added another copy of tai-utc.dat decoupled from the XTE software, i.e.
      so that it is installed in $LHEA_DATA for all downloads.
    
    
    ******************************************************************************
                                       CFITSIO
    ******************************************************************************
    
    CFITSIO Version 3.02 -  Main changes since the HEASOFT 6.1 release
    
      - Includes support for new hcompress image compression algorithm. Several 
        minor bug fixes related to: support of 64-bit integer columns; the command 
        line parser; displaying large numeric values; and reading a vector column 
        in a table as an image.
    
      See the file headas-6.1.2/heacore/cfitsio/changes.txt for more details.
    
    
    ******************************************************************************
                                       CCFITS
    ******************************************************************************
    
    CCFITS Version 1.6 -
    
      - Added capbility to write compressed images.  Assorted bug fixes.
        See the file headas-6.1.2/heacore/CCfits/CHANGES for more details.
    
    
    ******************************************************************************
                                       HEAGEN
    ******************************************************************************
    Heagen software changes since HEASoft v6.1:
    	
     barycorr:
    
      - Changed file opens to READONLY whenever possible
    
      - Deleted outdated check of orbit file gaps (Swift only)
    
      - Perform clock correction before barycentering times (Swift only)
    
      - Remove UTCFINIT keyword from final output file if TIMESYS=TDB
    
    	
    *****************************************************************************
                                       HEASARC
    ******************************************************************************
    HEASARC changes since HEAsoft v6.1
    	
     extractor (v4.71):
    	
      - Added support for ds9 regions in physical coordinates in addition to those 
        in image, fk4, or fk5 (the latter two in either degrees or hms).
    
      - Fixed unusual case that causes divide-by-zero error.
    		
      - Adjusted behavior when TIME is used in a filename filter expression.
    		
      - Fixed the case where event files have differing WCS and the user does an 
        extract events so that sky positions are corrected to the same WCS.
    
     rbnpha :
    
      - Fix memory error on Intel Mac.
    
    
    *****************************************************************************
                                       HEATOOLS
    ******************************************************************************
    HEATOOLS software changes since HEASoft v6.1:
    
     ftimgcalc:
    
      - Bug fix: for the handling of bunit or otherext parameters when numbers 
        were specified but not parsed correctly.
    
      - Add warning message if users pick 'T' or 'F' for variable names; these 
        are not allowed by the CFITSIO calculator,
    		
      - Remove old CFITSIO library checks; remove the CREATOR keyword.
    
      - Documentation fixes.
    
     ftmerge:
    
      - Fixed crash on x86_64 platform.
    
    
    *****************************************************************************
                                       RXTE
    ******************************************************************************
    RXTE software changes since HEASoft v6.1:
    		
     fgabor:
    
      - Added WCS keywords to output image.
    
     hextebackest: 
    
      - NEW TOOL. Estimate background for HEXTE Cluster A.
    	
     hxtrsp:
    
      - Corrected marfrmf call.
    
    *****************************************************************************
                                      SUZAKU
    *****************************************************************************
    Suzaku software changes since HEASoft v6.1.1:
    
    ----------------------
    XIS Specific tools
    ----------------------
    
     mkphlist:
    
      - Update.  Added a 'GEOMAREA' keyword in the output photon file.
    
     xiscontamicalc:
    	
      - Update. Users can multiply the transmission of the XIS OBF
        contaminant to the specified ARF file. The column density of
        C and O for the contaminant are shown separately.
    
     xisrmfgen:
    	
      - NEW TOOL. Generate XIS responses
    
     xissim:
    	
      - Update.Bug fix in the calculation of aberration (parallax) correction.
        On-the-fly photon generation is capable by setting the parameter,
        'enable_photongen=yes'
    
     xissimarfgen:
    
      - Several built-in energy steps are recognized for the 'estepfile' parameter.
       'full' : calculate effective area in each RMF energy bins. Very slow.
       'dense' or 'default' : dense sampling (2303 steps). Slow.
       'medium' : medium sampling (157 steps). Moderate.
       'sparse' : sparse sampling (55 steps). Fast.
    
      - Transmission of the thermal shield and the XIS OBF contaminant are
        treated separately from the XRT effective area, so that even the
        'sparse' energy step gives much better quality ARF response than before.
        This feature is useful in saving the calculation time.
    
      - The XRT_EFFAREA, SHIELD_TRANSMIS columns are added to the output ARF,
        and the AVGWEI column has been removed.
    
      - The -1 value is stored to the primary extension image, for the out-of-
        bounds region.  The primary extension image contains  now integers unless
        users provide weighted region file, which had been floating point numbers
        weighted to the transmissions of the thermal shield and the XIS OBF
        contaminant.
    
      - The SOURCE_RATIO_REG keyword is written to the ARF header, representing
        source image ratio inside the selected region.  This number is useful in
        calculating the flux inside the selected region.
    
      - Bug fix in reading RA_NOM, DEC_NOM from attitude file.
    
      - Add WCS keywords to the primary image in the generated ARF.
    
      - Accept WCS coordinates DS9 region files when region_mode=SKYREG.
    
    	
    ******************************************************************************
                                      SWIFT
    ******************************************************************************
    Swift software changes since HEASoft v6.1
    
    ----------------------
    General  tools
    ----------------------
    
     attjumpcorr:
    
      - Bug fix: for the case of a "slew in place" which does not reset the 
        '10 arcminute' settling flag.
    
      - New keyword AJUMPAPP indicates if the task has been run previously.
    
     swiftxform:
    
      - Record used UVOT TELDEF file in FITS keywords
    
    ----------------------
    BAT Specific tools
    ----------------------
     batbinevt:
    
      - Now write detector images with BAT_DPI_n extension name instead of
        just BAT_DPI.
    
      - New task parameters {min,max}dph{time,frac}overlap allow more flexibility 
        to accept individual survey DPHs,but the default is conservative.
    
     batcelldetect:
    
      - Bug fix: clusters of point sources were being merged together improperly; 
        affects fluxes of bunches of nearby sources.
    	
      - New parameter 'keepbadsources', which when set, removes sources from 
        the output catalog that failed the analysis process.
    	
      - New parameter 'sortcolumns' parameter, controls the sort order of the 
        console listing; the FITS file order is unchanged.
    
      - Improved logic for the handling of non-BAT images (maximum number of 
        pixels per source; Poisson-distributed data).
    	
      - New parameter 'imagestatistics'
    
     batdetmask:
    
       - NEW TOOL. Establish BAT global good/bad detectors for a given time.
    
     batdph2dpi:
    
       - No longer supported for scientific analysis. Use 'batbinevt' to convert 
         a survey DPH to a detector plane image.
    
     batdph2pha:
    
       - No longer supported for scientific analysis. Use 'batbinevt' to convert 
         a survey DPH to a spectrum.
    
     batfftimage:
    
       - Bug fix: always write BDISTAPP = 'F', even if the input event list has 
         had ray-tracing with a distortion map.
    
     batglobalgti:
    
       - NEW TOOL. Establish BAT global good/bad science analysis time filter.
    
     batgrbproduct:
    
       - NEW TOOL. Perform fully automatic gamma-ray burst analysis of BAT data.
    
     bathotpix:
    
       - Bug fix: documentation of the QUALITY output column has been corrected 
         (no code change).
    
       - More statistics are provided in the output file: NHOTPIX, NCOLDPIX, 
         NGOODPIX, and NDISPIX which are, respectively, hot, cold, good and 
         disabled pixel counts.
    
     batmasktaglc:
    
       - Bug fix: avoid out of bounds memory access when dealing with GTIs.
    
       - Bug fix: avoid potential string buffer overflows.
    
       - Task parameters 'maskwt' and 'ebounds' accept both INFILE or FILE.
    
     batmaskwtevt:
    
       - New parameter 'filtexpr' allows arbitrary event filtering (used to remove
         multi-hit and calibration events).
    
       - Bug fix: remove BDISTAPP from output event file, if it should not be
         present.
    
     batmaskwtimg:
    
       - Delete the output file if no input file is specified (prevents the user 
         from using the results of an old run).
    
       - Bug fix: avoid segfault when calling printf().
    
       - Bug fix: remove BDISTAPP from output event file, if it should not be
         present.
    		
       - Bug fix: avoid accessing an already-closed FITS file pointer.
    
     batoccultgti:
    	
       - The task now works with both the prefilter "SAO" file and the regular 
         Swift attitude file (if all you are doing is field of view checking).
    
     batsumdph:
    	
        - No longer supported for scientific analysis. Use 'batbinevt' to sum
         survey DPHs.
    
     batupdatephakw:
    	
       - Bug fix: the task now properly deletes keys when columns of the same
         name are added.
    
    ----------------------
    UVOT Specific tools
    ----------------------
     uvotattcorr:
    
       - Base snapshot determination on time separation of attitude records
    		
     uvotdetect/sextractor:
    	
       - Patched to allow compiling with gcc 4+ and optimizations
    
     uvotevtlc:
    
       - NEW TOOL. Make a background subtracted light curve from event data
    
     uvotimage:
    	
       - Write keyword ASPCORR=NONE to each non-RAW image HDU
    
        - Record UVOT TELDEF file used with FITS keywords
    
     uvotimsum:
    
        - Generate a warning instead of an error if there is nothing to sum
    
     uvotmag:
    	
        - Modified coincidence loss correction
    
     uvotmaghist:
    	
        - Corrections to calculation of RATE_BKG
    
        - Treat input region file(s) consistently with uvotsource
    
     uvotskycorr:
    	
        - Added support for interpolating aspect corrections
    
        - Base snapshot determination on time separation of attitude records
    
     uvotsource:
    
       - Correction to net error calculation
    
    ----------------------
    XRT Specific tools
    ----------------------
    
     xrtwtcorr:
    
       - Added a new method (biasmode=M20P) to correct the WT bias subtracted
         on-board.  The new method calculates the median of the last telemetred
         20 pixels using a set of configurable number of consecutive frames
         (nframe); compares the on-ground bias and the median of the last 20
         pixels of the bias row and adjust the bias, if the difference is
         greater then 'biasdiff', using a constant shift for the entire window.
    
       - Added to the old method (biasmode=SP) the possibility to specify the
         number of consecutive frames for the on-ground median calculation.
    	
       - New input parameters 'biasmode' and 'nframe'.
    
     xrttam:
    
       - Apply the caldb query for the teldef file depending on the observation
         start time.
    
     xrthkproc:
    
       - Apply the caldb query for the teldef file depending on the observation
         start time.
    	
       - Update the TSTART and TSTOP keywords also in the primary header.
    
     xrttimetag: 
    
       - Apply the caldb query for the teldef file depending on the observation
         start time.
    
       - Add the 'ATTFLAG'="xxx"  keyword to the file header that specify the
         kind of attitude used for the coordinate transformation. Values possible
         are: "100" for the regular attitude, "110" for the jump attitude, "111"
         for the uvot attitude with the jump and 101 uvot attitude without the jump.
    
     xrttdrss2:
    
       - Add the "ATTFLAG" keyword after the coordinates transformation.
    
       - Apply the caldb query for the teldef file depending on the observation
         start time.
        
       - Fix a bug to keep the correct number of extension whan translating images
         from Raw to Sky coordinates
    
     xrtexpomap:
    
       - Apply the caldb query for the teldef file depending on the observation
         start time.
    
     xrtpipeline:
    
       - Apply the caldb query for the teldef file depending on the observation
         start time.
    
       - Add the "ATTFLAG" keyword after the 'coordinator' and 'swiftxform' call.
    	
       - Added 2 new input parameters 'wtbiasmode' and 'wtnframe'.
    	
    
    *****************************************************************************
                                       XSELECT
    *****************************************************************************
    XSELECT software changes since HEASoft v6.1.1:		
    
       - Filter intensity corrected for half-bin losses at GTI ends.
    
       - Increased flexibility when reading event files; now both read and choose 
         will work correctly for gti extensions called either GTI or STDGTI 
         regardless of the setting of the gti setting in xselect.mdb.
    
       - Fixed bug in filter time which was causing an error return if 'r' was 
          given as the end time for the interval.
    
       - Fixed bug in filter time such that the time input by the user is
          relative to the offset in the plot.
    
       - xselect mission databse file: Switched Suzaku default WMAP coordinates 
         to DET coordinates and removed references to TIME-OBS and TIME-END 
         which are no longer used in the event file.
    	
    
    *****************************************************************************
                                       XIMAGE
    ******************************************************************************
    XIMAGE software changes since HEASoft v6.1:
    
       - Uses the post-launch version of the Swift PSF released in Caldb 
         with this software realese
    
    	
    *****************************************************************************
                                       XRONOS
    ******************************************************************************
    XRONOS software changes since HEASoft v6.1:
    	
       - Fix a bug that affect input event file with vector column RATE containing 
         rates at different energy. Rates are now summed instead of averaged if sum
         is requested.
    

    Help lines: FTOOLS or xanprob@athena.gsfc.nasa.gov

    Web page maintained by Bryan K. Irby



    HEASARC Home | Observatories | Archive | Calibration | Software | Tools | Students/Teachers/Public

    Last modified: Tuesday, 23-Oct-2007 16:44:01 EDT