BaseResidualPlot

class sherpa.plot.BaseResidualPlot

Bases: ModelPlot

Residuals of model + data.

Subclasses need to implement _calc_y and _title.

Added in version 4.16.1.

Notes

The ylog setting is ignored, whether given as a preference or a keyword argument, so the Y axis is always drawn with a linear scale.

Errors are supported on the Y axis.

Attributes Summary

plot_prefs	The preferences for the plot.
residual_axis	At what point on the y axis is the residual line drawn.
residual_color	The color of the residual line.
residual_lw	The line width of the residual line.

Methods Summary

hline(y[, xmin, xmax, linecolor, linestyle, ...])	Draw a line at constant y, extending over the plot.
overplot(*args, **kwargs)	Add the data to an existing plot.
plot([overplot, clearwindow])	Plot the data.
prepare(data, model, stat)	Create the data to plot
vline(x[, ymin, ymax, linecolor, linestyle, ...])	Draw a line at constant x, extending over the plot.

Attributes Documentation

plot_prefs = {'alpha': None, 'capsize': None, 'color': None, 'ecolor': None, 'label': None, 'linestyle': '-', 'linewidth': None, 'marker': 'None', 'markerfacecolor': None, 'markersize': None, 'xerrorbars': False, 'xlog': False, 'yerrorbars': False, 'ylog': False}

The preferences for the plot.

residual_axis: float = 0

At what point on the y axis is the residual line drawn.

residual_color: str = 'k'

The color of the residual line.

residual_lw: float = 0.8

The line width of the residual line.

Methods Documentation

static hline(y, xmin=0, xmax=1, linecolor=None, linestyle=None, linewidth=None, overplot=False, clearwindow=True)

Draw a line at constant y, extending over the plot.

overplot(*args, **kwargs)

Add the data to an existing plot.

This is the same as calling the plot method with overplot set to True.

See also

plot

plot(overplot: bool = False, clearwindow: bool = True, **kwargs) → None

Plot the data.

This will plot the data sent to the prepare method.

Parameters:

• overplot (bool, optional) – If True then add the data to an existing plot, otherwise create a new plot.

• clearwindow (bool, optional) – Should the existing plot area be cleared before creating this new plot (e.g. for multi-panel plots)?

• **kwargs – These values are passed on to the plot backend, and must match the names of the keys of the object’s plot_prefs dictionary.

See also

prepare, overplot

prepare(data: Data1D, model: Model, stat: Stat) → None

Create the data to plot

Parameters:

• data – The Sherpa data object to display (it is assumed to be one dimensional). This defines the grid over which the model is displayed.

• model – The Sherpa model expression to evaluate and display.

• stat (optional) – This parameter is unused.

See also

plot

static vline(x, ymin=0, ymax=1, linecolor=None, linestyle=None, linewidth=None, overplot=False, clearwindow=True)

Draw a line at constant x, extending over the plot.