load_image
- sherpa.astro.ui.load_image(id, arg=None, coord='logical', dstype=<class 'sherpa.astro.data.DataIMG'>) None
Load an image as a data set.
Changed in version 4.16.0: Setting coord to a value other than ‘logical’ will now correctly change the coordinate setting for
DataIMG
datasets.- Parameters:
id (int or str, optional) – The identifier for the data set to use. If not given then the default identifier is used, as returned by
get_default_id
.arg – Identify the image data: a file name, or a data structure representing the data to use, as used by the I/O backend in use by Sherpa: an
IMAGECrate
for crates, as used by CIAO, or a list of AstroPy HDU objects.coord ({ 'logical', 'image', 'physical', 'world', 'wcs' }) – The coordinate system to use. The ‘image’ option is the same as ‘logical’, and ‘wcs’ the same as ‘world’.
dstype (optional) – The data class to use. The default is
DataIMG
.
See also
load_arrays
Create a data set from array values.
load_ascii
Load an ASCII file as a data set.
load_table
Load a FITS binary file as a data set.
set_coord
Set the coordinate system to use for image analysis.
set_data
Set a data set.
unpack_image
Create an image data structure.
Notes
The function does not follow the normal Python standards for parameter use, since it is designed for easy interactive use. When called with a single un-named argument, it is taken to be the
arg
parameter. If given two un-named arguments, then they are interpreted as theid
andarg
parameters, respectively. The remaining parameters are expected to be given as named arguments.Examples
Load the image from the file “img.fits” into the default data set:
>>> load_image('img.fits')
Set the ‘bg’ data set to the contents of the file “img_bg.fits”:
>>> load_image('bg', 'img_bg.fits')
Load in the data from the file ‘src.img’ and set the coordinate system to the physical system of the file:
>>> load_image('src.img', coord='physical')