Last modified: December 2013

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


AHELP for CIAO 4.11 Sherpa v1

get_source_component_plot

Context: modeling

Synopsis

Returns the data and preferences defining the unconvolved model component plot

Syntax

get_source_component_plot([id], name)

Description

The get_source_component_plot() command returns the data arrays and preferences which define a plot of unconvolved model components created with the plot_source_component() command. Once a data set has been loaded into the Sherpa session, this command can be used to list the xlo, xhi, and y data arrays associated with a specified model component, as well as the x label, y label, title, units, and other (histogram) plotting preferences and settings. The information returned by get_source_component_plot() may be stored in variables, or printed to the screen, as shown in the examples section.

Attributes

Field name Description
xlo grid array, low bins (independent variable)
xhi grid array, high bins (independent variable)
y convolved model amplitudes (dependent variable)
xlabel The label for the X axis
ylabel The label for the Y axis
units units of grid (X axis)
title The plot title
histo_prefs dictionary of histogram plotting preferences

Note that the show_source command ("ahelp show_model") is recommended to simply print the current unconvolved model to the screen.


Examples

Example 1

sherpa> print get_source_component_plot(2, "p1")

Return the data arrays and preferences defining the plot of the unconvolved power law model component "p1" associated with data set 2.

sherpa> load_data(2, "source_pi.fits")
sherpa> set_source(2, xsphabs.abs1 * powlaw1d.p1)

sherpa> print get_model_component_plot(2, "p1")
xlo    = [ 0.1   0.15  0.2  ...,  9.85  9.9   9.95]
xhi    = [  0.15   0.2    0.25 ...,   9.9    9.95  10.  ]
y      = [  9.4476e-02   5.1996e-02   3.3467e-02 ...,   4.8187e-05   4.7768e-05
   4.7355e-05]
xlabel = Energy (keV)
ylabel = f(E)  Photons/sec/cm^2/keV 
units  = energy
title  = Source model component: powlaw1d.p1
histo_prefs = {'linethickness': 2, 'symbolcolor': None, 'symbolfill': None, 'xlog': False, 'ylog': False, 'symbolangle': None, 'errthickness': None, 'fillcolor': None, 'linecolor': 'orange', 'errstyle': None, 'linestyle': 1, 'symbolstyle': 0, 'errcolor': None, 'fillstyle': None, 'fillopacity': None, 'yerrorbars': False, 'symbolsize': None}

Example 2

sherpa> set_source(gauss1d.g1 + const1d.c1)
sherpa> gplot = get_source_component_plot("g1")
sherpa> gplot.histo_prefs["symbolstyle"] = 1
sherpa> gplot.histo_prefs["linestyle"] = 0

Store the plot information returned by the get_source_component_plot() command for the Guass 1D model component "g1" to the variable "gauss_plot". Use the "gauss_plot" variable to change the plot preferences such that symbols are used in place of a line to represent the data.


Bugs

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

See Also

confidence
get_conf, get_covar, get_int_proj, get_int_unc, get_proj, get_reg_proj, get_reg_unc
contrib
get_chart_spectrum, get_marx_spectrum
data
get_areascal, get_arf, get_arf_plot, get_axes, get_backscal, get_bkg, get_bkg_plot, get_bkg_scale, get_coord, get_counts, get_data, get_data_plot, get_dep, get_dims, get_error, get_exposure, get_grouping, get_indep, get_quality, get_rmf, get_specresp, get_staterror, get_syserror
filtering
get_filter
fitting
calc_stat_info, get_fit, get_stat_info
info
get_default_id, list_model_ids, list_stats, show_bkg_model, show_bkg_source
methods
get_draws, get_iter_method_name, get_iter_method_opt, get_method
modeling
add_model, add_user_pars, clean, create_model_component, delete_bkg_model, delete_model, delete_model_component, get_model, get_model_autoassign_func, get_model_component, get_model_component_image, get_model_component_plot, get_model_plot, get_num_par, get_order_plot, get_par, get_pileup_model, get_response, get_source, get_source_component_image, image_model, image_model_component, image_source, image_source_component, integrate, link, load_table_model, load_template_model, load_user_model, normal_sample, reset, save_model, save_source, set_bkg_model, set_full_model, set_model_autoassign_func, set_pileup_model, set_source, set_xsabund, set_xscosmo, set_xsxsect, set_xsxset, t_sample, uniform_sample
plotting
get_lrt_plot, get_lrt_results, get_pvalue_plot, get_pvalue_results, get_split_plot, plot_cdf, plot_model, plot_model_component, plot_pdf, plot_pvalue, plot_scatter, plot_source, plot_source_component, plot_trace
psfs
delete_psf, get_kernel, get_psf, load_conv
saving
save_delchi, save_resid
statistics
get_chisqr_plot, get_delchi_plot, get_prior, get_sampler, get_stat
utilities
calc_chisqr, calc_energy_flux, calc_model_sum, calc_photon_flux, calc_source_sum, calc_stat, eqwidth, get_analysis, get_rate
visualization
contour_model, contour_ratio, contour_resid, get_ratio, get_resid, image_getregion