Contact Patrick Broos
if you have problems or questions
about this software.
ACIS Extract
Patrick Broos, Leisa Townsley, Konstantin Getman,
Franz Bauer
Introduction
ACIS Extract (AE) is a computer program, written in the IDL language , that can assist the
observer in performing the many tasks involved in analyzing the spectra
of large numbers of point and diffuse sources observed with the ACIS instrument
on Chandra .
An extensive searchable user's guide is available
in PDF, or in HTML.
Observers at Penn State are sometimes running a beta version of AE not yet released on the web. Look here for the corresponding unreleased version
of the manual.
What does AE do? Well, suppose you have Level 2 event data from one or multiple
ACIS observations, and you have a catalog of proposed point
sources. AE can perform virtually all the common data processing
and analysis tasks that lie on the road to producing LaTeX tables of
source properties and spectral models:
The Point Source Catalog
Source detection is not part of AE. However, source position
estimates and source significance statistics produced by AE can be used
to improve a proposed catalog of point sources.
The Extraction Regions
AE constructs two sets of regions for the point sources:
- The source extraction region are contours of the local PSF
enclosing whatever PSF fraction is desired. Crowded fields are
handled by shrinking the extractions regions so they do not overlap.
- The "mask regions", which completely cover the sources, are used to construct a background data set.
Extraction of Event Data and Backgrounds
Source and scaled local background spectra are extracted.
Calibration Products
ARFs and RMFs are constructed for each source. The ARFs are
corrected to account for the light missed by the finite extraction
regions.
Timing Analysis
Source variability is quantified. Three time series are produced for each source:
- A "grouped light curve", i.e. source flux measured in a set
of independent, unequally sized time bins with constant significance.
- The median energy of events in each time bin.
- An "adaptively smoothed light curve", i.e. source flux measured
in a set of overlapping, unequally sized time intervals with constant
significance.
Photometry
Source photometry is performed over any desired set of energy bands.
Spectral Modeling
Source spectra are grouped and spectral models are fit with XSPEC.
Collation of Results
Source properties, statistics, photometry, and spectral models are
collated into a large FITS file for analysis, generation of LaTeX
tables, etc.
Visual Review
- Source extraction region files help the observer review the observation for spurious and missed sources.
- A variety of interactive plots are produced showing various source properties across the catalog.
Multiple Observations
The source catalog can be extracted from any number of observations (at
different aim points or roll angles). AE combines the extraction
data products prior to position estimation, photometry, timing
analysis, and spectral modeling.
Diffuse Sources
If you can define extraction and background regions for diffuse
sources, then AE can extract and analyze them in much the same way as
is done for point sources.
The implementation strategy for AE is to use CIAO tools for specific computations
whenever possible, and ds9
for display and editing of extraction regions.
The authors happily acknowledge that AE is derived from the ideas, software,
and testing efforts of David Alexander, George Chartas, Eric Feigelson,
Nicolas Grosso, Scott Koch, Bertil Olsson, Yohko Tsuboi, and the authors
of various CIAO threads and manuals. Support for this effort was
provided by NASA contract NAS8-38252 to Gordon Garmire, the ACIS Principal
Investigator
Other Notable Features
- Since early 2002 AE has been used successfully on many large
ACIS projects, including observations of the Chandra Deep Field North,
Orion, and the Galactic Center.
- Hooks are provided for observer-supplied extraction and background regions to
support special handling of contaminated sources.
- Maximum Likelihood reconstructions can be performed on source neighborhoods.
- Source positions are estimated by two methods: the mean of the
event data, and the peak of the correlation between the event data and
the PSF.
- Sources spanning multiple CCDs are correctly calibrated.
- Local background regions are individually sized to enclose a specified number of counts.
- Scaling of background spectra takes into account exposure
differences (not simply geometric areas) in source and background
regions, correctly accounting for masking applied to the data.
- Grouping of spectra is based on a background-subtracted S/N threshold rather than on a
fixed number of counts. The observer has direct control over the
spectral range modelled (i.e. the boundaries of the first and last spectral groups).
- XSPEC scripts are provided for three spectral models
(1-temperature and 2-temperature thermal, powerlaw). Both chi^2
and C-stat fitting statistics are supported. The scripts can be
customized both globally and for individual sources (e.g. to freeze a
parameter).
- Source spectra with models are plotted in both the common grouped and less common cumulative forms.
- Multiple spectral models can be fit, and a tool for visually reviewing the fits is provided.
- We provide both "Getting Started" examples of basic AE usage, and
the complex AE recipe that we use in our own multi-obsid extractions of
fields with ~1000 sources.
- We provide the (undocumented) code we use to generate publishable LaTeX tables.
- We provide an example recipe which uses AE to analyze piled-up sources.
Installation Instructions
Third-party Packages
- IDL programming language (Multiple
observers have reported that IDL version 6.0 produces mysterious NaN
values in PSF images and PSF fractions that are NaN; I do not
recommend using version 6.0.)
-
Wayne Landsman's IDL Astronomy Library
- CIAO and MARX
- FTOOLS
- XSPEC
- LaTeX
Please refer to the Installation Section of the
AE user's guide for information on version requirements for each package, and for information on configuring your computing environment
for AE.
Install TARA
The AE software uses a number of IDL routines from our
TARA package
, so you must
install
that.
Install AE Programs & XSPEC Scripts
Download
the latest version of AE (the ae_._.tar.gz file with the highest
version number). Unzip and untar the tarball, e.g.
gunzip ae3.172.tar.gz
tar -xvf ae3.172.tar
Place the files extracted from the tarball in an appropriate place that is
in your IDL path.
Patrick Broos
patb@astro.psu.edu
Software Engineer, ACIS Team @PSU
814-863-7947
Astronomy & Astrophysics
Pennsylvania State University
525 Davey Lab
University Park, PA 16802
814-865-0418