About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2006

URL: http://cxc.harvard.edu/ciao3.4/data.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 data Context: sherpa

Synopsis

Inputs the contents of one or more source data files.

Syntax

sherpa> DATA [#] <filespec> [, [#] <filespec>,...]

where # specifies the number of the dataset to be associated with this
source data file (default dataset number is 1).

Description

Alternative means of reading in source datasets involve using the load functions of the Sherpa/S-Lang module (e.g., load_pha).

The help file for the READ command explains the <filespec> definition and has a listing of allowed file types; see also the related commands SOURCE, ERRORS, and SETDATA.

Using Data Model Filters

This command is able to take any Data Model virtual file specification (see "ahelp dmsyntax"). If you can do

unix% dmcopy "infile.fits[spec 1][spec 2]" outfile.fits

you can also do

sherpa> data "infile.fits[spec 1][spec 2]"

This is especially useful when working with very large files. For example:

sherpa> data "evt.fits[bin sky=4][opt mem=100]"

bins the event file by a factor of four and allocates additional memory. A similar command (omitting the binning factor) can be used to read in an image.

Example 1

Input an ASCII data file having a .dat extension name:

sherpa> DATA example.dat

This command reads the first two columns of the ASCII data file example.dat, as dataset number 1.

Example 2

Input an ASCII data file not having a .dat extension name:

sherpa> DATA example.qdp ASCII 1 2

This command reads columns 1 and 2 of the ASCII data file example.qdp, as dataset number 1.

Example 3

Input a FITS image data file:

sherpa> DATA 3 data/example_img.fits FITS

This command reads the FITS image data/example_img.fits,as dataset number 3.

Bugs

See the Sherpa bug pages online for an up-to-date listing of known bugs.

Hardcopy (PDF): A4 | Letter
Last modified: December 2006



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.