[Date Prev][Date Next][Thread Prev][Thread Next][Search] [Main Index] [Thread Index] [HEASARC Mailing List Archives]

Rosat Status Report #96




		ROSAT Status Report #96
		     June 27 1994



[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]
[                                                                      ]
[                    HINTS & POINTERS for PROS Users                   ]
[   24 JUNE 1994                                                 #11   ]
[                                                                      ]
[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]]
        

	---  Release Notes for SAO/PROS Patch 2.3.1 -- June 1994  ---
-------------------------------------------------------------------------

I) Setting up to use the XRAY package
   ----------------------------------

   required packages:			
      IRAF V2.10.1 or higher 		    
	(iraf.noao.edu -or- 140.252.1.1)   
      TABLES 1.3.1 
        (stsci.edu -or- 130.167.1.2)
      PROS 2.3
        (sao-ftp.harvard.edu -or- 128.103.42.3)

   optional packages:
      EUV (cea-ftp.cea.berkeley.edu -or- 128.32.154.12)

   >>> Users must rerun the "mkiraf" task and answer 'yes' to the  <<<
   >>> 're-initialize uparm?' option before running.		   <<<


II) New TASKS in this release (PROS 2.3.1)
    --------------------------------------

   QPCALC (xproto) ->  This task runs on QPOES and is based on the 
        TCALC task in iraf.tables.  It evaluates an arbitrary expression 
        that includes event-attribute  names, constants, and operators, and 
        creates a specified event-attribute in the QPOE --- or overwrites 
        an existing  event-attribute if the specified name already exists.  
        Variables in the expression are event-attribute names in either case.  

   HXFLUX (xspectral) -> New task to compute the flux of a ROSAT HRI 
     	observation from an input QPOE.  It runs qpspec, fit, and xflux
     	in a macro task.

   ECD2PROS (xdataio.eincdrom) -> This task will retrieve Einstein data 
        from any of the CD-ROM archives (including the new IPC unscreened 
     	archive).  This task replaces the now obsolete tasks qp_get and 
     	fits_get.

   EFITS2QP (xdataio) -> New task to convert any Einstein FITS file 
        (containing BINTABLE extensions) to an RDF IRAF/PROS QPOE file.

   ECDINFO (xdataio.eincdrom) -> This task retrieves information about a 
        particular Einstein observation and displays the observation title, 
        livetime, field center, etc.

   EINDATADEMO (xdataio.eincdrom) -> Demo task for Einstein screened and
	unscreened data.  Optional Einstein distributed data files 
        installation required.


III) Major modifications to existing TASKS in this release (PROS 2.3.1)
     ------------------------------------------------------------------

   RARC2PROS, RFITS2PROS, UPQPOERDF (xdataio) -> These tasks have been updated 
     	to run QPGAPMAP when the input data are ROSAT/HRI.  The detector 
     	coordinates (DETX/DETY) are computed by applying the gapmap to the 
     	Raw coordinates (RAWX/Y) and they are added to the event-list.

   QPSPEC (xspectral) -> This task was updated to eliminate any restrictions 
        on the geometry of source regions.  Removed the 'extended' task 
	parameter.  Updated the region descriptor processing to provide prompt 
        feedback about syntactic or semantic errors in region descriptors 
        provided to qpspec.  

        Replaced particle_bkgd.tab to match Plucinsky et al paper, 
        updated ros_pi_offar.ieee to maintain consistency with PROSCON v2.3.  
        Added bal26.0tab.

   QPLINTRAN (ximages) -> This task was updated to allow re-dimensioning and 
        re-blocking when making QPOE-> QPOE conversions (already implemented 
        in QPOE -> IMAGE conversions)

   QPGAPMAP (xdataio) -> This task was updated to write the recentered 
	optical axis coordinates in the output QPOE header. 

   APPLY_BARY (xtiming.timcor) -> An intermittent crash error was fixed,  
        RA/DEC no longer read from command line (read from correction table 
        header), rationalized warning messages and time units.   

        Replaced scc_to_utc table with latest version from MPE.  

   IMCONTOUR/TVIMCONTOUR (xplot) -> Fixed source display error.  Sometimes 
        a source was missing when plotting an ascii source list. Now all 
        sources are displayed.


IV) PROS Packages and Tasks
    -----------------------

   The xray package contains the following sub-packages and tasks
      (note that:
         * denotes a new task,
         + major modifications made to a task,
         $ task has been given a new name,
         - task has been moved from one package to another):

   package     tasks           description
   ---------   ------------    ------------------------------------------
   xdataio     * efits2qp      convert Einstein FITS event list to qpoe    
               + fits2qp       fixed alignment problem for ASCA SIS data
			       fixed memory problems for IRIX port
               + rfits2pros    added upqpoerdf 
	       + rarc2pros     added upqpoerdf 
	       + qp2fits       updated to write new rdf keywords tlmin/tlmax
	       + upqpoerdf     added call to qpgapmap when ROSAT/HRI data
               - qpgapmap      added update to recenter optical axis position 
			         in the output qpoe header
   eincdrom
	       * ecd2pros      reads data from eincdroms data to disk
	       * ecdinfo       retrieves info on an Einstein observation
	       * eindatademo   demo of Einstein screened and unscreened data
   xspatial                

   detect      + lbmap         updated soft/hard/broad limit of pha 

   xtiming     + fft           fixed totcnts to avoid accumulated round-off 
			         errors

   timcor      + apply_bary    updated screen display, read ra/dec from
			         input table headers, debugged intermittent 
                                 segv error.

   xspectral   * hxflux        computes the flux from a ROSAT/HRI QPOE
               + qpspec        offaxis angle update, accept ASCA data, 
			         eliminated restrictions on source regions, 
			         added prompt feedback to regions errors

   xplot       + imcontour/
	         tvimcontour   fixed source display when ascii input
               + tabplot       updated for compatibility with TABLES 1.3.1

   ximages     + qplintran     added 2 new parameters (xdim,ydim) to allow 
			         specifying the output QPOE dimension

   xproto      * qpcalc        qpoe calculator

   xlocal      (tasks supported locally, i.e., at SAO) 
               + mpc.mpcspec   updated to write RDF-style spectral tables
   ---------   ------------    ------------------------------------------
                        

V) Test Data Files 
   ---------------

     The test data files in xdata$ are upgraded to RDF format with task 
     UPQPOERDF as part of this installation.  See Section VII below for
     information on other existing QPOE files. 


VI) Calibration Data Files
     ----------------------

     The file ros_pi_offar.ieee in the data directory xspectraldata, 
     used by QPSPEC, has been modified to replace zero values of effective 
     area in the first seven pi channels with ones.  The change was 
     necessitated by modifications in PROSCON v. 2.3, which now requires 
     256-channel spectra as input. 

     Changed comments and table values in xspectraldata$particle_bkgd.tab 
     to match the final published version of the Plucinsky et al paper.  
     This file had been based on a preprint; both variable names and values 
     had changed in the final paper.

     The most recent scc_to_utc.tab file from MPE is included.

     Added the Einstein IPC response matrix for the BAL value of 26.0, 
     bal26.0tab, used by xspectral.fit. 

VII) PROS User's Guide (PUG)
     -----------------------

     The PROS USERS GUIDE has been revised from the June '93 (PROS vs 2.2) 
     edition.  It now corresponds to the current PROS release, 2.3.1 and 
     will be available as an html version accessable via xmosaic as well 
     as the conventional ftp latex and postscript editions.  A forthcoming 
     H&P will provide the details.


VIII) Some answers to related IRAF/PROS Frequently Asked Questions (FAQs):
      --------------------------------------------------------------------

   1) Now that PROS has been updated to support RDF, are my existing QPOE 
      files compatible?
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
   PROS supports data in both old (REV0) and new (RDF) format, but will 
   always write files in RDF.  The PROS ROSAT FITS readers (rfits2pros,
   rarc2pros) will do any required conversions automatically.  However, any 
   EXISTING PROS QPOE files (on disk pre PROS2.3 - dec93), must be converted 
   manually by the user, with the task UPQPOERDF.

        > xdataio
        > upqpoerdf

   2) How can I verify old results before moving to the new poisson error 
      calculations in PROS? 
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
   Poisson error approximations are the default in PROS 2.3 (Dec 93).  
   Some user's may want to run with gaussian errors to verify old results 
   before moving to the new default.  The following procedure will change
   the QPOE header keyword POISSERR from T (true for POISSON errors) to 
   F (false for GAUSSIAN errors).  

   a) verify current value
        > imhead rh110267.qp long+ | match POISSERR
              POISSERR=                    T

   b) change T to F (Note the value is boolean, so DO NOT use quotes)
        > qphedit rh110267.qp POISSERR F
        rh110267.qp,POISSERR (T -> F): y
        rh110267.qp,POISSERR: T -> F
        continue ? (yes): 
        rh110267.qp updated

   b) verify update
        > imhead rh110267.qp long+ | match POISSERR
              POISSERR=                    F

   Also, see 'help explain_errors' for a description of error calculations.

   3) The syntax used to specify detector coordinates is cumbersome, is there
      a better method?
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
   IRAF 'key' syntax has been updated to use real event-attribute names:

        New syntax -> key=(detx,dety)    
        
        Old syntax -> key=(s16,s18)        ... obscure and cumbersome

   i.e. the following example will display a map using detector coords  

        > xdisplay foo.qp[key=(detx,dety)] 

   4) How can I access recent PROS documents?
   - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
   In the IRAF/XRAY package:

     Type 'help revisions' in XRAY to display these notes.
     Type 'help pros' for an overview of PROS help documents. 
							J. De Ponte

ABOUT HINTS & POINTERS
As the provider of the PROS software package ("xray" in IRAF), the
ROSAT Science Data Center (RSDC) at SAO distributes HINTS & POINTERS
to PROS Users via email.  When we find answers to often asked
questions, or when we have implemented new software solutions to
longstanding problems, we will send this information directly to our
users.  These messages will also be available via anonymous ftp*, but
to receive the email version, you should register with us. If your
username is the one associated with your site registration, you are
already registered for "HINTS & POINTERS", but we encourage other
users (even at the same sites) to register.

Mailings will be sent as the need arises, perhaps every month or so.
If you would like to suggest items for future issues of H&P or add
your name to our distribution list, please contact us at the following
address:

**************************************************************************
Internet - rsdc@cfa.harvard.edu         RSDC    MS-3
DECnet   - CFA::RSDC (6699::RSDC)       Center for Astrophysics
UUCP     - ...!harvard!cfa!rsdc         60 Garden St. Cambridge MA 02138 USA
BITNET   - rsdc@cfa                     tel: (617) 495-7134  FAX: 495-7356
**************************************************************************

* to access our anonymous ftp service:
    o   ftp -i sao-ftp.harvard.edu              # node address: 128.103.42.3
        [Name: anonymous]
        [Password: <yourusername@yoursite>]

   ftp> cd pub/pros/Hints

N.B.: you can also obtain your own copy of the PROS USERS GUIDE by
anonftp from subdir /pub/pros/PUG.

-----------------------------------------------------------------------------