Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: December 2013

URL: http://cxc.harvard.edu/sherpa/ahelp/unpack_table.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.6 Sherpa v1

unpack_table

Context: data

Synopsis

Unpack tabular data from a TABLECrate

Syntax

unpack_table( filename|TABLECrate, [ncols=2, colkeys=None,
dstype=Data1D] )

Description

The unpack_table command unpacks tabular data from a FITS file, a column-based text file, or a TABLECrate object into a Sherpa data object.

If a filename is provided as input, a crate is created but hidden and cannot be used for other analysis in the session.

  • filename|TABLECrate - the name of the file (with path) or TABLECrate which contains the data
  • ncols - number of columns to read; default=2
  • colkeys - list of column names; default=None
  • dstype - dataset type: Data1D, Data1DInt, Data2D, Data2DInt; default=Data1D

The columns to load are specified by a Data Model filter on the filename or the colkeys option of the unpack_table command, as shown in the examples. Vector columns are separated to form two dstype columns when the file is loaded. If no columns are specified, the first two columns in the file are read by default. If column names are not included in the file, Sherpa calls them "col1", "col2", etc.

The columns must be listed in the order required by the dataset type:

  • Data1D: x, y, staterror=None, syserror=None
  • Data1DInt: xlo, xhi, y, staterror=None, syserror=None
  • Data2D: x0, x1, y, shape=None, staterror=None, syserror=None
  • Data2DInt: x0lo, x1lo, x0hi, x1hi, y, shape=None, staterror=None, syserror=None

Example 1

sherpa> rprof = unpack_table("rprofile_mid.fits[cols
RMID,SUR_BRI,SUR_BRI_ERR]")
sherpa> rprof = unpack_table("rprofile_mid.fits",
colkeys=["RMID","SUR_BRI","SUR_BRI_ERR"])

These commands are equivalent ways of creating a data object called "rprof" from the RMID, SUR_BRI, and SUR_BRI_ERR columns of rprofile_mid.fits, a radial profile for which the midpoint of the annular regions has been calculated.

Example 2

sherpa> tabcr = read_file("data.tab")
sherpa> tabdat = unpack_table(tabcr)

Tabular data is read into a TABLECrate (named "tabcr") from data.tab. The data is then unpacked into Sherpa from the crate.

Bugs

See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.

See Also

data
dataspace1d, dataspace2d, fake, load_arf, load_arrays, load_ascii, load_bkg, load_bkg_arf, load_bkg_rmf, load_data, load_grouping, load_image, load_multi_arfs, load_multi_rmfs, load_pha, load_quality, load_rmf, load_staterror, load_syserror, load_table, pack_image, pack_pha, pack_table, unpack_arf, unpack_arrays, unpack_ascii, unpack_bkg, unpack_data, unpack_image, unpack_pha, unpack_rmf
filtering
load_filter
info
get_default_id, list_bkg_ids, list_data_ids
modeling
add_model, add_user_pars, load_table_model, load_template_model, load_user_model, save_model, save_source
saving
save_arrays, save_data, save_delchi, save_error, save_filter, save_grouping, save_image, save_pha, save_quality, save_resid, save_staterror, save_syserror, save_table
statistics
load_user_stat

Last modified: December 2013
Smithsonian Institute Smithsonian Institute

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-2014. All rights reserved.