Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: December 2013

URL: http://cxc.harvard.edu/sherpa/ahelp/plot_bkg.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.6 Sherpa v2

plot_bkg

Context: plotting

Synopsis

Plot information about background data

Syntax

plot_bkg( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_chisqr ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_delchi ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_fit ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_fit_delchi ( [id], [bkg_id=None, replot=False, overplot=False]
)
plot_bkg_fit_resid ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_model ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_ratio ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_resid ( [id], [bkg_id=None, replot=False, overplot=False] )
plot_bkg_source ( [id], [lo=None, hi=None, bkg_id=None, replot=False,
overplot=False] )

Description

There are a number of commands to plot information about the background data:

  • plot_bkg - background counts
  • plot_bkg_chisqr - background chi squared contributions
  • plot_bkg_delchi - background delta chi (residuals divided by background uncertainties)
  • plot_bkg_fit - background counts with fitted background model
  • plot_bkg_fit_delchi - background fit and background delta chi
  • plot_bkg_fit_resid - background fit and background residuals
  • plot_bkg_model - convolved background model
  • plot_bkg_ratio - background ratio (background measured counts divided by background predicted counts)
  • plot_bkg_resid - background residuals (measured background counts minus predicted background counts)
  • plot_bkg_source - unconvolved source model

The commands take the following options:

  • id - the id of the dataset to use; if not given, uses the default dataset id (id=1 by default, see "ahelp get_default_id")
  • bkg_id - the id of the background to use, e.g. if more than one background is associated with the data; default is the first background dataset
  • lo - lower bound of the desired plotting range; default=None
  • hi - high bound of the desired plotting range; default= None
  • lo - (plot_bkg_source only) lower limit of the plot in the same units as the data (energy [keV] or wavelength [A]); default=None, which uses the value from the response file (ENERG_LO)
  • hi - (plot_bkg_source only) upper limit of the plot in the same units as the data (energy [keV] or wavelength [A]); default=None, which uses the value from the response file (ENERG_HI)
  • overplot - should the new plot be overlaid in the plotting window? False (default)=clear the window, True=overplot on any existing plots

The plot is displayed in a ChIPS plotting window. If there is no plotting window open, one is created. If a plotting window exists, the overplot parameter value determines whether the new plot is overlaid on any existing plots in the window or if the window is cleared before the plot is drawn.

ChIPS commands may be used within Sherpa to modify plot characteristics and create hardcopies; refer to the ChIPS website for information.

Plotting Multiple Objects

To plot multiple Sherpa objects - e.g. data, model, fit, residuals - in a single window, use the plot command.

Example 1

sherpa> plot_bkg()

Plot the first background set (if there is more than one) associated with the default dataset.

Example 2

sherpa> plot_bkg("src", "bg2", overplot=True)

Plot the background "bg2" associated with dataset "src", overlaying it on any existing plots.

Bugs

See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.

See Also

contrib
get_data_prof, get_data_prof_prefs, get_delchi_prof, get_delchi_prof_prefs, get_fit_prof, get_model_prof, get_model_prof_prefs, get_resid_prof, get_resid_prof_prefs, get_source_prof, get_source_prof_prefs, plot_chart_spectrum, prof_data, prof_delchi, prof_fit, prof_fit_delchi, prof_fit_resid, prof_model, prof_resid, prof_source
data
get_arf_plot, get_bkg, get_bkg_plot, set_bkg, subtract, unsubtract
info
list_bkg_ids, show_bkg_model, show_bkg_source
modeling
delete_bkg_model, normal_sample, t_sample, uniform_sample
plotting
get_energy_flux_hist, get_lrt_plot, get_lrt_results, get_photon_flux_hist, get_pvalue_plot, get_pvalue_results, get_split_plot, plot, plot_arf, plot_cdf, plot_chisqr, plot_data, plot_delchi, plot_energy_flux, plot_fit, plot_lrt, plot_model, plot_model_component, plot_order, plot_pdf, plot_photon_flux, plot_pvalue, plot_ratio, plot_resid, plot_scatter, plot_source, plot_source_component, plot_trace, set_xlinear, set_xlog, set_ylinear, set_ylog
psfs
plot_kernel
statistics
get_chisqr_plot, get_delchi_plot
visualization
contour_resid

Last modified: December 2013
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email:   cxcweb@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2014. All rights reserved.