|AHELP for CIAO 4.3 Sherpa v1||
Plot a radial or elliptical profile of the source model for imaging data.
prof_source( [id], [model=None, rstep=None, rmin=None, rmax=None, rlo=None, rhi=None, xpos=None, ypos=None, ellip=None, theta=None, group_counts=None, group_snr=None, label=True, recalc=True, overplot=False] )
The prof_source command calculates the radial - or elliptical - profile of the source model to an imaging dataset and plots it. The profile is defined by the existing model compenents, although it is possible to over-ride these values.
The model values used to calculate the profile are those intrinsic to the source, and so are not broadened by any PSF model applied using the set_psf() command. Please use the prof_model() command if you want to plot the PSF-convolved model values.
The routine can be loaded into Sherpa by saying:
from sherpa_contrib.profiles import *
The argument options are the same as for the prof_data() command, and are described in its ahelp page.
Errors are not calculated for the model component.
The get_source_prof_prefs() returns the current plot preferences used by prof_source(). Changing these settings will therefore change the appearance of any new plots created by prof_source(). For example
sherpa> get_source_prof_prefs()["xlog"] = True
will cause any new plots to use logarithmic scaling for the X axis. A full list of the preferences can be found by saying
unix% ahelp get_source_prof_prefs
sherpa> prof_source() sherpa> log_scale() ... sherpa> prefs = get_source_prof_prefs() sherpa> prefs["xlog"] = True sherpa> prefs["ylog"] = True sherpa> prof_source()
The preferences are set so that both the x and y axes should be drawn using log scaling. Setting the get_source_prof_prefs values only affects plots made after the change; to change an existing plot you need to use ChIPS commands such as log_scale() and linear_scale().
The source data is plotted after the bins have been grouped so that each bin has a signal to noise ratio of 15 or more, where the calculation is done using the data and not the model values.
sherpa> prof_data() sherpa> prof_source(overplot=True) sherpa> prof_model(overplot=True) sherpa> set_histogram(["line.color","blue"])
Plots the profile for the data and then overplots the model profile, for the source and measured profiles (the later is changed to be drawn with a blue line).
See the bugs pages on the Sherpa website for an up-to-date listing of known bugs.
- 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, sherpa_profiles
- get_arf_plot, get_bkg_plot
- get_energy_flux_hist, get_photon_flux_hist, get_split_plot, plot, plot_arf, plot_bkg, plot_chisqr, plot_data, plot_delchi, plot_energy_flux, plot_fit, plot_model, plot_model_component, plot_order, plot_photon_flux, plot_ratio, plot_resid, plot_source, plot_source_component, set_xlinear, set_xlog, set_ylinear, set_ylog
- get_chisqr_plot, get_delchi_plot