Contents

• General Introduction
• IRAF/PROS
  • Summary of Tasks in this Section
  • Bringing up IRAF
    • On a SUN workstation
  • Using IRAF
    • Help
    • Parameters
    • Editing Text
    • Listing and Printing Files, Parameters, and Tables
    • Editing Files and Parameters
  • Using the PROS software
  • IRAF/PROS Files
    • IRAF Image Arrays
    • QPOE Files
    • *.imh and *.qp Extensions - when to use them
    • Differences Between QPOE Files and Image Arrays
    • Other Types of Files
  • Features of the PROS software
    • Coordinate Systems
    • Treatment of Errors
    • Possible Pitfalls
• DATA I/O
  • Summary of Tasks in this Section
  • Reading FITS files from tape
    • *t2d* -- FITS tape to disk for files with binary tables
    • *xrfits, mperfits* -- FITS Arrays on tape to IRAF (.imh) files
  • ROSAT data
    • *rfits2pros* -- PI Data
    • Requesting Rosat Data From the Public Archive
    • *rarc2pros* -- Converting Archived Data to PROS files
  • EINSTEIN data
    • Reading Einstein FITS files
    • Access to CD-ROM FITS Files
      • eincdrom
      • Example -- Creating a QPOE file from CD ROM Data
      • Example -- Retrieve Unscreened Data from CDROM
    • MPC Data - CfA Only
  • Other missions
  • *xwfits, qp2fits, (fits2qp)* -- Writing FITS files
    • Making a FITS primary array file or an ASCII table
    • Making a binary table of photons from a qpoe file
  • A Few Words About ROSAT Directories at SAO
• QPOE Utilities
  • Summary of Tasks in this section
  • *qpcopy* -- Manipulation of PROS/IRAF data files
  • *qplist* -- Inspection of .qp files
    • *imheader* -- Inspection of .qp files
  • *qpsort* --- Sort a QPOE file
  • *qpshift* --- Shift qp file by an offset in x and y
  • *qprotate* --- Rotate a QPOE image about the origin
  • *qplintran* --- Apply linear transformation to a qp file through filter
  • *qpappend* --- Append a list of input qpoes to produce a single qpoe file
• Image Display
  • Summary of Tasks in This Section
  • SAOimage
    • SAOimage for remote users
    • General usage.
    • The SAOimage Menu (options within SAOimage)
    • To produce a region mask using SAOimage interactively.
      • Select a circle around the central point source
      • A box, to include extended emission
      • A Region mask for a radial profile in concentric, elliptical annuli
    • *fixsaoreg* --- restore SAOimage region to original image (physical) coordinates
  • Imtool [SUN users only]
  • *display, xdisplay, xexamine* -- Image Display
    • A small image (512 X 512) using display
    • To compress and display a large (e.g. ROSAT) image
    • *xdisplay* -- Image Display with scaling appropriate to x-ray images
    • To view a section of the image at full resolution
    • To both compress and view a particular section
    • To display a particular energy band
    • To display a particular time interval
    • To display other sizes
    • *display, xdisplay* --- Displaying an image in detector coordinates
    • *xexamine* --- examine a qp file
  • Celestial Coordinates from Image Coordinates
    • *tvlabel, xexamine* --- sky coordinates from a displayed image
    • *skypix* --- conversion of pixel position to sky coordinates
    • *wcscoord* --- all purpose coordinate conversion
    • Image with sky grid overlaid
  • *tvimcontour* -- Overlay contours and/or source positions on the display
  • *tvmark* -- Mark pixel positions on the display
  • *tvproj* --- one-dimensional projection on display
  • *tabplot* -- Plotting tables, lists or image sections
  • *pspc_hrcolor* -- generate an x-ray color image
• Spatial Analysis
  • Summary of Tasks in this Section
  • Regions and Source Parameters
    • *plcreate* --- Defining a Region
    • *pllist* -- Look at the region
    • *isoreg* -- A region defined by an isointensity contour
    • *imcnts* -- Find background subtracted counts for a point source
    • *imcnts* -- Find counts in an extended region, after removing an embedded point source
    • *imexamine* -- General analysis of image containing many sources
      • Photometry
      • Contour Plot
      • Other Useful Functions
    • *tprint* -- Reading a Table File Created by imcnts
    • *imcnts* -- Use of the Sky Coordinate System
  • Radial Profiles and Projections
    • *imcnts* -- Radial Profile of an extended source at the field center
    • *tabplot* -- Displaying a Radial Profile
    • *imcnts* -- Azimuthal profile of an extended source
    • *imcnts* -- Radial Profile in a Quadrant
    • *improj* -- Make a one-dimensional projection of data within a rectangular band traversing an image
  • Smoothing and Contouring
    • *imsmooth* -- Smooth an image
    • Calculation of errors in smoothed arrays
    • *imcontour* -- Iso-intensity contour map
  • Calibration
    • Vignetting correction
      • *makevig, vigdata* -- Apply Vignetting Correction to an image
    • Exposure Map
    • Background Corrections
      • *imcalc* -- Obtain a background subtracted image for ROSAT PSPC Data
      • Radial profile of an extended source for Einstein IPC data.
    • *errcreate* -- Use of error arrays
      • Determine a background subtracted radial profile
    • To Resample Calibration Images
  • Point Response Functions
    • On-Axis Point Response Functions (PRF)
    • ROSAT and EINSTEIN Calibration Fields
  • Image Manipulation
    • *imcopy* -- Extract a small image file from a larger image
    • *imcopy* -- Compress an image and extract a small region
    • *imcalc* -- Image Arithmetic
    • *imlintran, magnify* -- Image Scale, Orientation, and Translation
  • Source Subtraction
    • *immodel* -- subtracting a King model
    • *rosprf* -- Using the analytical expressions for the point response function
  • Detect
• Spectral Analysis
  • Summary of Tasks in this Section
  • A Quick Look at Spectral Fitting
  • Notes on IPC and PSPC Spectral Fitting
  • Model Spectra for Spectral-Fitting Program
  • Structure of the Spectral Package
  • *qpspec* -- Extraction of Photon Distributions from QPOE files
    • Spectral Extraction of Point Sources
    • Spectral Extraction of Extended Sources
    • Charged Particle Subtraction
    • Error Determination
  • *fit* -- Fit Data to a Specified Model
    • Power Law fit to a Point Source
    • Raymond Model
    • Two-Temperature Raymond Model
    • Limiting Energy Channels Input to the Fit
    • Multiple Data Sets
    • Verbose Mode
    • Fit a source with a small number of net counts
    • Inspection of results
  • *counts_plot* -- Inspection of Results
  • *search_grid* -- Grid of - default mode
    • *search_grid* -- Customized grid
  • *grid_plot* -- Plot Results on Screen
  • *xflux, hxflux* -- Calculation of X-ray Flux
  • *upspecrdf, downspecrdf* -- Transform between RDF and pre-RDF spectral tables
  • *xspec* -- External Fitting Program
• Timing Analysis
  • Summary of tasks in this section
  • An example of a typical timing analysis
  • *timsort*
    • Extraction of time-sorted events
    • Extraction of limited time intervals
  • *timfilter* -- List start & stop times of good data intervals
  • Counting rate vs. time
    • *ltcurv* -- Generation of the light curve
    • *ltcplot* -- Plot the light curve
  • *timprint* -- Inspect tables on screen
  • *calc_bary, apply_bary* -- Barycentric Time Corrections
    • *calc_bary* -- Computing Barycentric Corrections
    • *apply_bary* -- Applying Barycentric Corrections to QPOE times
    • *scc_to_utc* -- Converting Spacecraft time to UTC
  • *fft* -- Period search using Fast Fourier Transform
    • A ``short'' FFT
    • *fftplot* -- Plot power vs. frequency
    • A ``long'' FFT
    • A summed or incoherent FFT
    • *ftpplot* -- Distribution of FFT coefficient values
  • *period* -- Period search using epoch folding
  • *fold* -- Make a folded light curve
  • *vartst* -- Test for Source Variability
  • *qpphase* -- Append phase to events in QPOE file
• Glossary
• List of Related Documents
• List of PROS and Selected IRAF Tasks
• OLD ROSAT DATA FILES
• About this document ...