********************************************************************************
                          Release Notes For Swift v1.1
                                  13 Jan 2005 
********************************************************************************

This release includes : 
 - Updates of the Swift software
 - HEASoft 5.3.1 with a change in xselect (v2.2a), extractor (v4.47) and 
   caldbinfo (infocaldb v1.0.1) 

This document contains notes about the content of the Swift
software and changes to xselect, extractor and caldbinfo.  
For details about installing the Swift software, please see:

   For the source code distribution:
   http://heasarc.gsfc.nasa.gov/lheasoft/install_swift_src.html

   For the pre-compiled binary distribution:
   http://heasarc.gsfc.nasa.gov/lheasoft/install_swift_bin.html

Below are listed the Swift specific tools, the multi-mission tasks 
related to attitude, tools to manipulate FITS files and the changes
to xselect, extractor and caldbinfo. 

More information of the individual tasks can be obtained using the
fhelp utility.  Type "fhelp ftools" to obtain a full listing of all the
tools available, or "fhelp <sub-package-name>" to list all of the tools
in a particular subpackage, e.g., "fhelp swift".  Finally, type
"fhelp <toolname>" for more detailed help on a particular tool.

********************************************************************************
                                     SWIFT
********************************************************************************

BAT-SPECIFIC TOOLS

  - batbinevt - Compute mask weighted light curves or spectra from BAT event
    data.
  - batcelldetect - Perform source detection using the sliding cell method.
  - batclean - Read in a DPI and clean out a fit to the diffuse background.
  - batdph2dpi - Compress a 3-d image cube along the first (energy) dimension
    to create a 2-d image.
  - batdph2pha - Read in a DPH and output a file containing a spectrum for each
    detector.
  - batdrmgen - Compute BAT detector response matrix for a known source
    position.
  - bateconvert - Read in an event file and apply energy conversions.
  - batfftimage - Make sky image from detector plane image by FFT deconvolution.
  - bathotpix - Locate and mask out hot pixels in a BAT detector image.
  - batid2xy - Convert between detector ID and x/y position in the BAT array.
  - batmasktaglc - Derive light curves from mask tagged rate packets.
  - batmaskwtevt - Compute mask weights for an event file.
  - batmaskwtimg - Compute mask weights for the entire detector BAT plane.
  - batrebin - Read in a survey DPH and rebin the energy spectra using
    quadratic corrections.
  - batsumdph - Add specified rows in a BAT_DPH table and generate a new,
    single-row BAT_DPH extension.
  - battblocks - Estimate interesting GTIs for time-variable data.

UVOT-SPECIFIC TOOLS

  - uvot2pha - Create a pha file from a UVOT image and region files.
  - uvotbadpix - Create pixel quality map from a bad pixel list.
  - uvotdetect - Detect sources in an UVOT image using XIMAGE.
  - uvotevgrism - Filter a UVOT grism event list and determine wavelength
  - uvotexpmap - Generate exposure maps for UVOT sky images.
  - uvotflatfield - Perform flatfield correction for UVOT images.
  - uvotimgrism - Extract UVOT grism spectra and calculate wavelength scale.
  - uvotimsum - Sum UVOT sky images or exposure maps.
  - uvotmag - Photometrically calibrate sources in a UVOT image.
  - uvotmaghist - Generate magnitude history for UVOT image file.
  - uvotmodmap - Correct a UVOT image for modulo-8 spatial fixed-pattern noise.
  - uvotpict - Creat a finding chart image.
  - uvotrmfgen - Create a UVOT response matrix.
  - uvotscreen - Filter a UVOT event list.
  - uvotstarid - Match a source list against a star catalog to identify sources.
  - uvottfc - UVOT TDRSS finding chart processing.

XRT-SPECIFIC TOOLS

  - xrtcalcpi - Fill or update PI column in XRT event files (PC, WT and PD
    modes).
  - xrtcentroid - Calculate source centroid for a given area (box) using XIMAGE.
  - xrtevtrec - Reconstruct events, calculate PHA and assign grade for WT and
    PD modes.
  - xrtfilter - Run 'prefilter' and 'makefilter' to create a filter file from
    housekeeping data.
  - xrtflagpix - Flag events for bad pixels and calibration source location.
  - xrthkproc - Process XRT housekeeping header packets file.
  - xrthotpix - Search for hot and flickering pixels for XRT Photon Counting
    mode.
  - xrtimage - Subtract bias and clean bad pixels in XRT Imaging Mode data.
  - xrtmkarf - Generate an ARF file for an input RMF file.
  - xrtpcgrade - Calculate the PHA values and assign event grades.
  - xrtpdcorr - Subtract the bias to the event PHA values taken in Photodiode
    mode.
  - xrtpipeline - Run in sequence the tasks for XRT data processing.
  - xrtproducts - Generate high level product data files from a cleaned event
    file.
  - xrtscreen - Generate GTIs and use them (and other criteria) to perform
    event screening.
  - xrttam - Perform attitude correction to detector coordinates using the
    TAM device.
  - xrttdrss - Process XRT TDRSS messages.
  - xrttimetag - Assign event arrival times and fill DETX/DETY columns for
    Windowed Timing and Photodiode modes.
  - xrtversion - Prints the version and date of the Swift-XRT subpackage.

SWIFT GENERAL (NON-INSTRUMENT-SPECIFIC) TOOLS

  - swiftversion - Report overall version number and date of entire
    HEAdas/Swift package.
  - swiftxform - Perform image transformations on a multi-extension Swift
    image file.

********************************************************************************
                                    HEAGEN
********************************************************************************

  - barycorr - Generalized multi-mission barycenter correction tool.

    * Uses the refdata/swco.dat file to apply the measured clock offset
      to times

********************************************************************************
                                   ATTITUDE
********************************************************************************

  - applyxform - Transform a list of coordinates.
  - aspect - Calculate the mean pointing for an attitude file.
  - attcombine - Combine the rotations in two attitude files.
  - attdump - Report the R.A., Dec, and Roll for an attitude file.
  - combinexform - Create or modify a transform.
  - coordinator - Convert raw coordinates to detector and sky coordinates.
  - det2att - Convert detector coordinate offsets to rotations.
  - draw_teldef - Produce a PostScript plot of coordinates described by a
    teldef calibration file.
  - expomap - Generate an exposure map.
  - getwcs - Extracts the WCS keywords for a teldef file coordinate system.
  - getxform - Extract a transform between coordinate systems in a teldef file.
  - imagetrans - Apply a coordinate transform to an image.
  - imagexform - Transform an image from one coordinate system to another.
  - makefilter - Create a filter file from Housekeeping files.
  - prefilter - Derive attitude and orbit related quantities.
  - transform_wcs - Modify WCS keywords according to a transform.

********************************************************************************
                                   HEATOOLS
********************************************************************************

  - ftcalc - Calculate values in a table column
  - ftchecksum - Verify or update the checksum keywords in a FITS file
  - ftcopy - Copy a file, applying optional filters
  - ftcreate - Create a FITS table from ASCII template files
  - ftdelhdu - Delete a HDU in a FITS file
  - ftdelrow - Delete rows from a table
  - ftdiff - Display differences between 2 FITS files
  - ftedit - Edit one or more image pixels or table elements
  - ftemplate - Create a new FITS file using an ASCII template file
  - fthedit - Edit one or more header keywords
  - ftimgcreate - Create a FITS image from an ASCII data file
  - ftkeypar - Read a keyword and copy its value to the parameter file
  - ftlist - List the contents of the input file
  - ftmerge - Merge rows from multiple input tables into a single table
  - ftpaste - Merge columns from 2 input tables into a single table
  - ftselect - Copy selected rows from the input table to a new table
  - ftsort - Sort rows in a table
  - ftstat - Calculate statistics of images or tables
  - ftverify - Check that a file conforms to the FITS format

********************************************************************************
                                    XSELECT 
********************************************************************************

Version 2.2a:

  - Replaced getting MJDREF from the MDB by reading MJDREF[F/I] and TIMESYS
    from the event file. These are used when time filtering based on UTC or
    MJD ranges.

  - Now includes conversion from UTC to TT if TIMESYS='TT'.

********************************************************************************
                                    HEASARC 
********************************************************************************

Extractor (Version 4.47):

   - Fixed bug in handling of DSVAL keywords that must be removed when
     filtering on the column set by the ccol parameter. Also fixed bug when
     operating on Swift UVOT event files that have separate GTI tables for
     different times instead of different detector regions (e.g. CCDs).
 
     Modified the way the EXPOSURE keyword is calculated when the ccol
     parameter is set if multiple GTI extensions contribute to the output.
     The old way was to calculate the exposure for each GTI extension and
     average. This does not work for the UVOT event files where the exposures
     must be summed. The new version combines individual ranges from all the
     selected GTI extensions and uses the merged list to calculate an exposure.
     This does the correct thing for the UVOT case. For missions with multiple
     CCDs if products are required for spatial regions covering more than one
     CCD the exposure may be slightly different. However, if the old and new
     ways give very different exposures then it is not correct to combine data
     across the CCDs anyway.

********************************************************************************
                                     CALDB 
********************************************************************************

Caldbinfo (infocaldb routine v1.0.1):

   - Fixed upper/lower case problems when comparing input values for
     mission & instrument (e.g. XRT).


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: Friday, 14-Jan-2005 14:10:09 EST