Last modified: December 2023

URL: https://cxc.cfa.harvard.edu/sherpa/ahelp/get_arf.html
Jump to: · Examples · PARAMETERS · Bugs · See Also


AHELP for CIAO 4.16 Sherpa

get_arf

Context: data

Synopsis

Return the ARF associated with a PHA data set.

Syntax

get_arf(id=None, resp_id=None, bkg_id=None)

id - int or str, optional
resp_id - int or str, optional
bkg_id - int or str, optional

Examples

Example 1

Return the exposure field of the ARF from the default data set:

>>> get_arf().exposure

Example 2

Copy the ARF from the default data set to data set 2:

>>> arf1 = get_arf()
>>> set_arf(2, arf1)

Example 3

Retrieve the ARF associated to the second background component of the 'core' data set:

>>> bgarf = get_arf('core', 'bkg.arf', bkg_id=2)

Example 4

Retrieve the ARF and RMF for the default data set and use them to create a model expression which includes a power-law component (pbgnd) that is not convolved by the response:

>>> arf = get_arf()
>>> rmf = get_rmf()
>>> src_expr = xsphabs.abs1 * powlaw1d.psrc
>>> set_full_model(rmf(arf(src_expr)) + powlaw1d.pbgnd)
>>> print(get_model())

PARAMETERS

The parameters for this function are:

Parameter Definition
id The data set to use. If not given then the default identifier is used, as returned by `get_default_id` .
resp_id The identifier for the ARF within this data set, if there are multiple responses.
bkg_id Set this to return the given background component.

Return value

The return value from this function is:

arf -- This is a reference to the ARF, rather than a copy, so that changing the fields of the object will change the values in the data set.


Bugs

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

See Also

confidence
get_conf, get_conf_results, get_covar, get_covar_opt, get_covar_results, get_covariance_results, get_int_proj, get_int_unc, get_proj, get_proj_opt, get_proj_results, get_projection_results, get_reg_proj, get_reg_unc
contrib
get_chart_spectrum, get_marx_spectrum
data
fake_pha, get_areascal, get_arf_plot, get_axes, get_backscal, get_bkg, get_bkg_arf, get_bkg_chisqr_plot, get_bkg_delchi_plot, get_bkg_fit_plot, get_bkg_model, get_bkg_model_plot, get_bkg_plot, get_bkg_ratio_plot, get_bkg_resid_plot, get_bkg_rmf, get_bkg_scale, get_bkg_source, get_bkg_source_plot, get_coord, get_counts, get_data, get_data_contour, get_data_contour_prefs, get_data_image, get_data_plot, get_data_plot_prefs, get_dep, get_dims, get_error, get_exposure, get_grouping, get_indep, get_quality, get_rmf, get_specresp, get_staterror, get_syserror, load_arf, load_bkg_arf, load_multi_arfs, set_arf, unpack_arf
filtering
get_filter
fitting
calc_stat_info, get_stat_info
info
get_default_id, list_response_ids, list_stats
methods
get_draws, get_iter_method_name, get_iter_method_opt, get_method, get_method_name, get_method_opt
modeling
get_model, get_model_component, get_model_component_image, get_model_component_plot, get_model_plot, get_num_par, get_num_par_frozen, get_num_par_thawed, get_order_plot, get_par, get_pileup_model, get_response, get_source, get_source_component_image, get_source_component_plot, get_source_contour, get_source_image, get_source_plot, image_source
plotting
get_split_plot, plot_arf
psfs
get_psf, get_psf_contour, get_psf_image, get_psf_plot
statistics
get_chisqr_plot, get_delchi_plot, get_prior, get_sampler, get_stat, get_stat_name
utilities
get_analysis, get_rate
visualization
image_getregion