CCLRC / RUTHERFORD APPLETON LABORATORY SUN/98.6

Particle Physics & Astronomy Research Council

Starlink Project

Starlink User Note 98.6

D.J.Allan & R.J.Vallance
School of Physics and Space Researc, University of Birmingham
13 May 1995

ASTERIX --- X-ray Data Processing System

• Contents
• Getting started
• Command summary
• Shortform commands
• Macro commands
• User interface
  • ADAM parameters
    • Command line input
    • Default values
    • Global parameters
    • Parameters Help Subtopic
  • Lists and ranges
  • PSF System
    • ANALytic psfs
    • Documentation
    • Instrument psfs
      • ASCA
      • EXOLE
      • PWFC and WFC
      • XRT PSPC
      • XRT HRI
    • RESPFILE option
    • TABULAR psfs
    • Model psfs
      • Energy Models
      • Spatial Models
      • CSPEC model
      • POLAR model
      • RECT model
  • Text Output
    • Spooling
  • RA DEC Formats
  • Customising ASTERIX
    • FTOOLS
    • Shell Startup
    • ICL Startup
    • Site Startups
    • WWW
• Using ASTHELP
• Worked Examples
  • Phase resolved spectral fitting
• Documentation
• This release
  • ROSAT
  • ARD
  • Graphics
  • Spectral Fitting
  • Time Series Analysis
  • Utilities
  • Documentation
• Binned dataset commands
  • ASMOOTH
    • Input Output data
    • Background Subtracted Data
    • Biasing
    • Parameters
    • Masks
    • Examples
  • AXCENTROID
    • Input Output data
    • Parameters
    • Example
  • AXFLIP
    • Parameters
    • Examples
  • AXORDER
    • Parameters
    • Examples
  • BINMERGE
    • Input output data
    • Method
    • Parameters
  • BINSUBSET
    • Algorithm
    • Input output data
    • Parameters
    • Examples
  • CORRECT
    • Input output data
    • Algorithm
    • Parameters
  • DTREND+
  • ENMAP
    • Input output
    • Method
    • XRT Hints
    • Parameters
    • Examples
  • INTERP
    • Edges
    • Method
    • Parameters
    • Examples
  • MEANDAT
    • Method
      • Summing files
    • Parameters
    • Examples
  • MKCOLIM+
    • Method
    • Parameters
  • POLYFIT
    • Input Output Data
    • Shortforms
    • Parameters
  • PROJECT
    • Parameters
    • Examples
  • RADOPT
    • Method
    • Parameters
      • BCOUNT
      • DMJD
      • ENERGY
      • IFILT
      • SCOUNT
    • Examples
  • RATIO
    • Floating Point Divide by 0
    • Input Output
    • Method
    • Normalisation
    • Parameters
    • Examples
  • REBIN
    • Algorithm
    • Parameters
    • Examples
  • SCATTERGRAM
    • Input output data
    • Parameters
    • Examples
  • SIGNIF
    • Input Output data
    • Parameters
  • SLICE
    • Input Output data
    • Parameters
  • SMOOTH
    • Ends of Dataset
    • Input & Outpu
    • Masks
      • COSine
      • GAUsian
      • LAPlacian
      • TOP hat
      • User Defined
    • Quality
    • Parameters
    • Examples
  • SPLINEFIT
    • Parameters
      • SQ RES
  • SYSERR
    • Input Output data
    • Parameters
    • Examples
  • VALIDATE
    • Parameters
    • Examples
• Parameter & History commands
  • GLOBAL
  • HISTMODE
    • Parameters
    • Update Modes
    • Examples
  • HIST
    • Parameters
    • Examples
  • SETRANGES
    • Input Output Data
    • Parameters
    • Data
    • Deficiencies
    • Errors
• Event dataset commands
  • EVBIN
    • Input Output
    • Options
    • Parameters
    • Quality Lists
  • EVCSUBSET
    • Input output data
    • Parameters
    • Examples
  • EVLIST
    • Input output data
    • Parameters
  • EVMERGE
    • Input output data
    • Parameters
    • Method
  • EVPOLAR
    • Input Output
    • Parameters
    • Quality Lists
    • Examples
  • EVSIM
    • Flat Background
    • Background Model
    • Sources
    • Parameters
    • Example
  • EVSORT
    • Input output data
    • Parameters
  • EVSUBSET
    • Input output data
    • Parameters
• Quality processing commands
  • Quality values
  • Masking quality
  • Magic values
  • CQUALITY
    • Axis Ordering
    • OverWriting
    • Parameters
    • ShortForms
    • Examples
  • CIGNORE+
  • CRESTORE+
  • CSETQUAL+
  • MAGIC
    • Parameters
    • Examples
  • MASK
    • Parameters
    • Examples
  • QUALITY
    • OverWriting
    • Parameters
    • Auxilliary Input
    • Examples
    • Quality values
    • Range Selection
    • ShortForms
    • Spatial files
  • ARDQUAL+
  • IGNORE+
  • RESTORE+
  • SETQUAL+
• Format conversion commands
  • ASTCONV
    • Parameters
    • Examples
  • AST2QDP
    • Parameters
    • Example
  • ASTQDP*
    • Devices
    • Example
  • AST2XSP
    • Changes in V1.6
    • ROSAT WFC
    • ROSAT PSPC
    • Parameters
    • Examples
  • AXCONV
    • Parameters
  • EVBIN
  • EXPORT
    • Input Output
    • Parameters
  • HDS2TEXT
    • Parameters
    • Example
  • IMPORT
    • Quick Guide
    • Asymmetric Errors
    • Data Part
    • File Format
    • Header Part
      • Quality Bit Names
    • Parameters
    • Examples
      • 1D dataset
      • 2D dataset
      • Asymmetric Errors
  • TEXT2HDS
    • Input & Outpu
    • SCARFILE
    • Parameters
      • NCOLS
      • NROWS
      • CNAME
    • Examples
  • FITS2HDS
    • Parameters
    • Examples
  • OMD2HDS
    • Parameters
  • XRTCONV
• Source Searching commands
  • Source Search DataSets
  • Techniques
    • Finding Sources
    • Removing Sources
    • Upper limits
  • BSUB
    • Algorithm
    • Problem images
    • Parameters
    • Examples
  • COVERAGE
    • Parameters
  • CREPSF
    • Parameters
    • Example
  • IMSIM
    • Parameters
    • Examples
  • PSS
    • Introduction
    • EXPERT Mode
    • Text Output
    • Background Rescaling
    • Confidence Levels
    • Error Form
    • Extension Test
    • Oversampling
    • Using Psfs
    • Restarting PSS
    • Source Subtraction
    • Source Confusion
    • Diagnostic Mode
    • Future Plans
    • Parameters
    • Examples
  • SPCONVOL
    • Parameters
    • Examples
  • SPRESP
    • Parameters
    • Examples
  • SSANOT
    • Parameters
  • SSCARIN
    • Parameters
  • SSDUMP
    • Parameters
    • Examples
  • SSGET
    • Data Items
    • Parameters
    • Examples
  • SSMERGE
    • Parameters
    • Examples
  • SSZAP*
    • Parameters
    • Examples
    • Warning
• Graphics display commands
  • 1-Introduction
  • 2-Devices
  • 3-XWindows
    • CXMAKE*
      • Examples
    • MXMAKE*
      • Examples
  • 4-Graphics control
    • 1-Linestyle
    • 2-Linewidth
    • 3-Line colour
    • 4-Character fonts
    • 5-Character size
    • 6-Character boldness
    • 7-Symbols
  • DOPEN
    • Parameters
    • Examples
  • DCLOSE
  • DERASE
  • DLIST
  • DSHOW
  • DSPOOL
    • Parameters
    • Examples
  • GDRAW
    • Parameters
  • GMULTI
    • NEW
    • APPend
    • DELete
    • SPLit
    • SHOw
    • LAYout
    • COMbine
    • Parameters
    • Examples
  • GSET
    • DEFaults
      • Parameters
    • AXEs
      • Parameters
      • Axis options
    • XAXis
      • Parameters
    • YAXis
      • Parameters
    • LABels
      • Parameters
    • XLAbel
      • Parameters
    • YLAbel
      • Parameters
    • TITles
      • Parameters
    • POSit
      • Parameters
    • POLyline
      • Parameters
    • STEpline
      • Parameters
    • POInts
      • Parameters
    • ERRors
      • Parameters
    • PIXel
      • Parameters
    • CONtour
      • Parameters
    • SURface
      • Parameters
    • NOTes
      • Parameters
    • MARks
      • Parameters
    • SHApes
      • Parameters
    • GRId
      • Parameters
    • KEY
      • Parameters
    • COLours
      • Parameters
    • Parameters
    • Examples
  • GLOAD
    • Parameters
  • GCLOSE
  • POS
    • Parameters
  • WINDOW
    • Parameters
  • AXES
    • Parameters
  • MOVE
    • Parameters
  • PLOT
    • Parameters
  • LINE
    • Parameters
  • MARK
    • Parameters
  • LABEL
    • Parameters
  • TEXT
    • Parameters
  • CURS
    • Parameters
  • Shortforms
• Spatial file commands
  • REGIONS
    • FILE FORMAT
    • SHAPES
    • WARNING
    • Parameters
    • EXAMPLE
  • SETBAD*
  • WELLARD*
    • Method
    • WARNING
    • Parameters
• HDS general commands
  • HCOPY
    • Parameters
    • Examples
  • HCREATE
    • Valid Types
    • Parameters
    • Examples
  • HDELETE
    • Parameters
    • Examples
  • HDIR
    • Parameters
    • Examples
  • HDISPLAY
    • Parameters
    • Example
  • HFILL
    • Parameters
    • Examples
  • HGET
    • Items
    • Parameters
    • Examples
  • HMODIFY
    • Parameters
    • Examples
  • HREAD
    • Parameters
    • Examples
  • HRENAME
    • Parameters
    • Examples
  • HRESET
    • Parameters
    • Examples
  • HRESHAPE
    • Parameters
    • Examples
  • HRETYPE
    • Parameters
    • Examples
  • HTAB
    • Parameters
    • Examples
  • HTRACE
    • Parameters
    • Examples
  • HWRITE
    • Parameters
    • Examples
• Spectral Fitting commands
  • Overview
  • Likelihood fitting
    • ROSAT procedure
  • Constrained Fitting
  • Redshift
  • Models
  • IGNORE
  • RESTORE
  • FREEZE
    • Input Output Data
    • Parameters
    • Examples
  • SBG
    • Input Output Data
    • Parameters
    • Examples
  • SBIN
    • Input Output Data
    • Parameters
    • Examples
  • SDATA
    • Input Output Data
    • Parameters
    • Examples
  • SEDIT
    • Command Mode
    • Input Output Data
    • Parameters
    • Examples
  • SERROR
    • Input Output Data
    • Parameters
    • Examples
    • Method
    • Problems
    • WARNING
  • SFIT
    • Input Output Data
    • Parameters
    • Examples
    • Method
    • Errors
  • SFLUX
    • Input Output Data
    • Parameters
    • Examples
  • SGRID
    • Grid Axes
    • Input Output Data
    • Parameters
    • Method
    • Examples
    • Errors
  • SMHELP*
  • SMODEL
    • Input Output Data
    • Parameters
    • Examples
  • SPLOT
    • Parameters
    • Examples
    • Method
  • SSHOW
    • Input Output Data
    • Parameters
    • Examples
  • SSIM
    • Input Output Data
    • Parameters
    • Examples
  • TIE
    • Input Output Data
    • Parameters
    • Example
  • THAW
    • Input Output Data
    • Parameters
    • Examples
  • Future developments
• Image processing commands
  • Introduction
  • Recipes
  • Getting hardcopy
  • Command summary
  • IADD
    • Parameters
    • Examples
  • IAZIMUTH
    • Parameters
    • Examples
  • IBLUR
    • Parameters
    • Examples
    • Shortforms
  • IBLURG+
  • IBLURB+
  • IBOX
    • Parameters
  • IBROWSE
    • Parameters
    • Examples
  • ICENTROID
    • Parameters
    • Examples
  • ICIRCLE
    • Parameters
  • ICLEAR
  • ICLOSE
  • ICNTSUB*
    • Method
      • Bckgnd menu
      • Multi menu
      • Source menu
  • ICOLOUR
    • Parameters
    • Examples
  • ICONTOUR
    • Parameters
    • Examples
  • ICURRENT
    • Parameters
    • Examples
  • IDISPLAY
  • IDIV
    • Parameters
    • Examples
  • IDMSTOD*
  • IDTODMS*
  • IDTOHMS*
  • IHMSTOD*
  • IEXCLUDE
    • Parameters
    • Examples
  • IGRID
    • Parameters
    • Examples
  • IHIST
    • Parameters
  • IKEY
  • ILABELS
    • Parameters
    • Examples
  • ILOAD
    • Parameters
    • Examples
  • IMARK
    • Parameters
    • Examples
  • IMASK
    • Parameters
    • Examples
  • IMODE
    • Parameters
    • Examples
  • IMOSAIC
    • Astrometry
      • Algorithmn
      • Direction of X-axis
    • No astrometry
    • Method
      • Astrometry
      • Quality
      • Variance
    • Parameters
    • Examples
  • IMULT
    • Parameters
    • Examples
  • INOISE
    • Parameters
    • Examples
  • IPATCH
    • Parameters
    • Algorithm
    • Examples
  • IPEAKS
    • Parameters
    • Examples
  • IPLOT
    • Parameters
  • IPIXEL
  • IPOLAR
    • Method
    • Quality Checking
    • Parameters
    • Examples
  • IPOSIT
    • Parameters
    • Examples
  • IPSF
    • Parameters
    • Examples
  • IRADIAL
    • Parameters
    • Examples
  • IREGION
    • Parameters
    • Examples
    • ARD input
  • ISAVE
    • Parameters
    • Examples
  • ISAVE1D
    • Parameters
    • Examples
  • ISCALE
    • Parameters
    • Examples
  • ISEP
    • Parameters
    • Examples
  • ISLICE
    • Parameters
  • ISTATS
    • Shortforms
    • Parameters
    • Examples
  • IBOXSTATS+
  • ICIRCSTATS+
  • ISUB
    • Parameters
    • Examples
  • ISURFACE
    • Parameters
  • ITEXT
    • Parameters
    • Examples
  • ITITLE
    • Parameters
    • Examples
  • IUNDO
  • IWHOLE
  • IXCONV
    • Method
    • Deficiencies
    • Parameters
    • Example
  • IZED
    • Parameters
  • IZOOM*
  • IUNZOOM*
• Statistical analysis commands
  • BINSUM
    • Parameters
  • COMPARE
    • Input output data
    • Parameters
    • Method
  • FREQUENCY
    • Parameters
    • Irregular Bins
    • Examples
  • KSTAT
    • Input output data
    • Ties
    • Parameters
  • SCATTERGRAM
    • Input output data
    • Parameters
    • Examples
  • STATISTIX
    • Input output data
    • Parameters
    • Examples
• Instrument interface commands
  • EXOSAT
  • SLOTMRG
    • Parameters
    • Example
  • WFC ROSAT
    • Getting started
    • S2 Catalogues
    • S2ADDPFLAG
      • Parameters
    • S2CATCLEAN
      • Parameters
    • S2CATLIST
      • Parameters
      • Shortform
    • S2CATMERGE
      • Algorithm
      • Parameters
    • S2CATQUAL
      • Commands
      • Parameters
      • Example
    • S2GIDECODE
      • Parameters
    • S2GIENCODE
      • Parameters
    • S2CATTAB+
    • WFCAUTO*
    • WFCBOP*
    • WFCCOUNTS*
    • WFCDBM
      • Parameters
    • WFCDISK*
    • WFCEXP
      • Parameters
    • WFCHK
      • Parameters
    • WFCIMAGE*
    • WFCLIGHT*
    • WFCPOSX
      • Parameters
    • WFCSLOTS
      • Parameters
    • WFCSLMRG
      • Parameters
    • WFCSORT
      • Parameters
    • WFCSPC*
    • WFCSPEC
      • Parameters
      • WFC Efficiency
    • WFCSUB*
  • XRT ROSAT
    • Getting started
    • The HRI
    • The Boron filter
    • Time series analysis
      • Barycentric correction
      • Processing sequence
    • Spectral analysis
      • Point sources
      • Extended sources
    • Image analysis
      • Processing sequence
    • Distributed data conversion
      • MPE MIDAS FITS
      • GSFC PROS FITS
      • RDF FITS
    • New to Version 1.8
    • FITS2HDS
      • Parameters
      • Examples
    • XRTCONV
      • Parameters
      • FITS file contents
    • XRTINDEX
      • Parameters
    • XRTHOT
      • Parameters
    • OMD2HDS
      • Parameters
    • SASSBIN+
    • SHOWXRT
      • Method
      • Parameters
      • Examples
    • XPSF*
    • XPSSCORR
      • Input output
      • Method
      • Parameters
    • XRAD
      • Parameters
      • Examples
    • XRTBOX*
      • Graphics
      • Input & outpu
      • Wrapups
    • XRTBCKBOX*
      • Method
      • Procedure
      • Graphics
      • Input & outpu
      • Wrapups
    • XRTCORR
      • Input & outpu
      • Error messages
      • Method
      • Parameters
      • Examples
    • XRTEXPMAP
      • Method
      • References
      • Parameters
    • XRTMSPEC*
      • Method
      • Parameters
      • Wrapups
    • XRTMTIME*
      • Method
      • Parameters
      • Wrapups
    • XRTHK
      • Advice
      • Corrupt HK files
      • Error messages
      • Input & outpu
      • Method
      • Parameters
      • Examples
    • XRTORB
      • Parameters
    • XRTRESP
      • Input & outpu
      • Radial spectra
      • Method
      • Scope
      • Parameters
    • XRTSUB
      • Changes since V1.6
      • Advice
      • Error messages
      • Input & outpu
      • Method
      • Particles
      • The HRI
      • Variance
      • Warning
      • Parameters
      • Examples
    • XSORT
      • Background subtraction
      • Changes since V1.6
      • Corrections
      • Input & outpu
      • Selecting data ranges
      • The HRI
      • Time ranges
      • Parameters
      • Examples
    • XSPOKES
      • Method
      • Input & outpu
      • Widening the pattern
      • Parameters
• Textual display commands
  • AXSHOW
    • Parameters
    • Examples
  • BINLIST
    • Parameters
    • Examples
  • EVLIST
    • Input output data
    • Parameters
  • HEADER
    • Parameters
    • Example
  • SSDUMP
• Time series processing
  • Advice
    • POWER SPECTRUM
    • Folding
  • ACF
    • Input Output Data
    • Method
    • Parameters
  • BARYCORR
    • Simple-Mode
    • Earth-centred-corrections
    • Method
    • The Orbit File
    • Unix-differences
    • Event-lists-and-binned-datasets
    • Parameters
  • CROSSCORR
    • Deficiencies
    • Input Output Data
    • Method
    • Parameters
    • Examples
  • CROSSPEC
    • Deficiencies
    • Method
    • Parameters
  • DIFDAT
    • Input Output Data
    • Parameters
    • Examples
  • DYNAMICAL
    • Deficiencies
    • Input Output Data
    • Method
    • Parameters
    • Examples
  • EVPHASE
    • Julian Date
    • Input Output Data
    • Parameters
    • Example
  • FOLDAOV
    • Input & outpu
    • Method
    • Parameters
    • Examples
  • FOLDBIN
    • Input Output Data
    • Method
    • Parameters
    • Examples
  • FOLDLOTS
    • Input & outpu
    • Method
    • Parameters
      • NPHASE
    • Examples
  • LOMBSCAR
    • Input & outpu
    • Method
    • Parameters
      • OFAC
      • HIFAC
      • WFREQ
    • Example
  • PHASE
    • Input Output Data
    • Julian Date
    • Parameters
    • Example
  • POWER
    • Deficiencies
    • Input Output Data
    • Method
    • Parameters
    • Example
  • SINFIT
    • Deficiencies
    • Input Output Data
    • Method
    • Phase Information
    • Parameters
    • Examples
  • STREAMLINE
    • Input Output Data
    • Method
    • Parameters
    • Examples
  • TIMSIM
    • Input Output Data
    • Method
    • Parameters
    • Examples
  • TONOFF
    • Parameters
  • VARTEST
    • Method
    • Parameters
    • Examples
• Editing time series
  • TCHOP
  • TCLOSE
  • TONOFF
    • Parameters
  • TPLOT
  • TSAVE
    • Parameters
    • Examples
  • TSELECT
    • Parameters
    • Examples
  • TSLICE
    • Parameters
    • Examples
  • TLOAD
    • Parameters
    • Examples
  • TWHOLE
  • TZAP
• Mathematical commands
  • ARITHMETIC
    • Error functions
    • Floating Point Divide by 0
    • Input output data
    • Shortforms
    • Parameters
    • Examples
  • ADD+
  • SUBTRACT+
  • MULTIPLY+
  • DIVIDE+
  • OPERATE
    • Operations Available
    • Parameters
• Menu Commands
  • Buttons
  • File format
  • Method
  • BUTSET
    • Parameters
  • CHKMENU
  • DEFMENU
    • Parameters
    • Examples
  • LOADMENU
    • Parameters
  • RUNMENU*
    • Parameters
  • USEMENU
    • Parameters
• UNIX Differences
  • Running Applications
  • HDS Files
  • Missing Applications
  • Name Clashes
• About this document ...