Last modified: December 2013

Jump to: Description · Examples · Bugs · See Also

AHELP for CIAO 4.12 Sherpa v1


Context: plotting


Plot the calculated energy flux distribution


plot_energy_flux( [lo=None], [hi=None, id=1, num=7500, bins=75,
correlated=False, recalc=True, overplot=False,numcores] )


The plot_energy_flux command plots the calculated energy flux distribution, which is the flux distribution for the model component accounting for the errors on the model parameters.

The sample_energy_flux() command can be used to return an array of flux values drawn from this distribution.

The plot_energy_flux command is parallelized to make use of multi-core systems (i.e., laptops or desktops with 2 or 4 cores) to provide significant improvements in efficiency compared to previous releases of Sherpa; the 'numcores' argument may be used to specify how the cores should be used when the command is run.

Function arguments

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_energy_flux()

Plot the energy flux distribution for the default dataset.

Example 2

sherpa> plot_energy_flux(0.5, 7)

Plot the energy flux distribution for the default dataset, between 0.5 and 7.0 keV.

Example 3

sherpa> plot_energy_flux(id="src")
sherpa> plot_energy_flux(0.5, 7, id="src", overplot=True)
sherpa> set_histogram(["line.color", "blue"])

Plot the energy flux distribution the "src" dataset, using the full energy range, and then overplot the 0.5 to 7 keV distribution as the blue histogram.


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

See Also

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, plot_marx_spectrum, prof_data, prof_delchi, prof_fit, prof_fit_delchi, prof_fit_resid, prof_model, prof_resid, prof_source
get_arf_plot, get_bkg_plot
normal_sample, t_sample, uniform_sample
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_bkg, plot_cdf, plot_chisqr, plot_data, plot_delchi, plot_fit, 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
get_chisqr_plot, get_delchi_plot
sample_energy_flux, sample_flux, sample_photon_flux