unpack_data

sherpa.astro.ui.unpack_data(filename, *args, **kwargs)

Create a sherpa data object from a file.

The object returned by unpack_data can be used in a set_data call. The data types supported are those supported by unpack_pha, unpack_image, unpack_table, and unpack_ascii.

Parameters:

• filename – A file name or a data structure representing the data to use, as used by the I/O backend in use by Sherpa: e.g. a PHACrateDataset, TABLECrate, or IMAGECrate for crates, as used by CIAO, or a list of AstroPy HDU objects.

• args – The arguments supported by unpack_pha, unpack_image, unpack_table, and unpack_ascii.

• kwargs – The keyword arguments supported by unpack_pha, unpack_image, unpack_table, and unpack_ascii.

Returns:

The data set object.

Return type:

instance

See also

get_data

Return the data set by identifier.

load_arrays

Create a data set from array values.

set_data

Set a data set.

unpack_arrays

Create a sherpa data object from arrays of data.

unpack_ascii

Unpack an ASCII file into a data structure.

unpack_image

Create an image data structure.

unpack_pha

Create a PHA data structure.

unpack_table

Unpack a FITS binary file into a data structure.

Examples

Create a data object from the contents of the file “src.dat” and use it to create a Sherpa data set called “src”:

>>> dat = unpack_data('src.dat')
>>> set_data('src', dat)