- sherpa.ui.plot(*args, **kwargs)
Create one or more plot types.
The plot function creates one or more plots, depending on the arguments it is sent: a plot type, followed by optional identifiers, and this can be repeated. If no data set identifier is given for a plot type, the default identifier - as returned by
get_default_id- is used.
Changed in version 4.15.0: A number of labels, such as “bkgfit”, are marked as deprecated and using them will cause a warning message to be displayed, indicating the new label to use.
Changed in version 4.12.2: Keyword arguments, such as alpha and ylog, can be sent to each plot.
sherpa.utils.err.ArgumentErr – The label is invalid.
Return the default data set identifier.
Set the units used when fitting and displaying spectral data.
New plots will display a linear X axis.
New plots will display a logarithmically-scaled X axis.
New plots will display a linear Y axis.
New plots will display a logarithmically-scaled Y axis.
The supported plot types depend on the data set type, and include the following list. There are also individual functions, with
plot_prepended to the plot type, such as
plot_data. There are also several multiple-plot commands, such as
The ARF for the data set (only for
The chi-squared statistic calculated for each bin when fitting the background.
The residuals for each bin, calculated as (data-model) divided by the error, for the background.
The data (as points) and the convolved model (as a line), for the background data set.
The convolved background model.
The residuals for each bin, calculated as data/model, for the background data set.
The residuals for each bin, calculated as (data-model), for the background data set.
The un-convolved background model.
The chi-squared statistic calculated for each bin.
The data (which may be background subtracted).
The residuals for each bin, calculated as (data-model) divided by the error.
The data (as points) and the convolved model (as a line).
The PSF kernel associated with the data set.
The convolved model.
Part of the full model expression (convolved).
Plot the model for a selected response
The unfiltered PSF kernel associated with the data set.
The residuals for each bin, calculated as data/model.
The residuals for each bin, calculated as (data-model).
The un-convolved model.
Part of the full model expression (un-convolved).
The plots can be specialized for a particular data type, such as the
set_analysiscommand controlling the units used for PHA data sets.
See the documentation for the individual routines for information on how to configure the plots.
The plot capabilities depend on what plotting backend, if any, is installed. If there is none available, a warning message will be displayed when
sherpa.astro.uiis imported, and the
plotset of commands will not create any plots. The choice of back end is made by changing the
options.plot_pkgsetting in the Sherpa configuration file.
The keyword arguments are sent to each plot (so care must be taken to ensure they are valid for all plots).
Plot the data for the default data set. This is the same as
Plot the data for data set 2.
>>> plot("data", 2)
Plot the data and ARF for the default data set, in two seaparate plots.
>>> plot("data", "arf")
Plot the fit (data and model) for data sets 1 and 2, in two separate plots.
>>> plot("fit", 1, "fit", 2)
Plot the fit (data and model) for data sets “fit” and “jet”, in two separate plots.
>>> plot("fit", "nucleus", "fit", "jet")
Draw the data and model plots both with a log-scale for the y axis:
>>> plot("data", "model", ylog=True)
Plot the backgrounds for dataset 1 using the “up” and “down” components (in this case the background identifier):
>>> plot("bkg", 1, "up", "bkg", 1, "down")