show_data

sherpa.astro.ui.show_data(id=None, outfile=None, clobber=False)

Summarize the available data sets.

Display information on the data sets that have been loaded. The details depend on the type of the data set (e.g. 1D, image, PHA files).

Parameters:
  • id (int or str, optional) – The data set. If not given then all data sets are displayed.
  • outfile (str, optional) – If not given the results are displayed to the screen, otherwise it is taken to be the name of the file to write the results to.
  • clobber (bool, optional) – If outfile is not None, then this flag controls whether an existing file can be overwritten (True) or if it raises an exception (False, the default setting).
Raises:

sherpa.utils.err.IOErr – If outfile already exists and clobber is False.

See also

list_data_ids()
List the identifiers for the loaded data sets.
show_all()
Report the current state of the Sherpa session.

Notes

When outfile is None, the text is displayed via an external program to support paging of the information. The program used is determined by the PAGER environment variable. If PAGER is not found then ‘/usr/bin/more’ is used.