AHELP for CIAO 4.15 Sherpa

# get_int_unc

Context: confidence

## Synopsis

Return the interval-uncertainty object.

## Syntax

```get_int_unc(par=None, id=None, otherids=None, recalc=False, min=None,
max=None, nloop=20, delv=None, fac=1, log=False, numcores=None)

id - str or int, optional
otherids - list of str or int, optional
recalc - bool, optional
min - number, optional
max - number, optional
nloop - int, optional
delv - number, optional
fac - number, optional
log - bool, optional
numcores - optional```

## Description

This returns (and optionally calculates) the data used to display the `int_unc` plot. Note that if the the `recalc` parameter is `False` (the default value) then all other parameters are ignored and the results of the last `int_unc` call are returned.

## Examples

### Example 1

Return the results of the `int_unc` run:

```>>> int_unc(src.xpos)
>>> iunc = get_int_unc()
>>> min(iunc.y)
119.55942437129544```

### Example 2

Since the `recalc` parameter has not been changed to `True` , the following will return the results for the last call to `int_unc` , which may not have been for the src.ypos parameter:

`>>> iunc = get_int_unc(src.ypos)`

### Example 3

Create the data without creating a plot:

`>>> iunc = get_int_unc(pl.gamma, recalc=True)`

### Example 4

Specify the range and step size for the parameter, in this case varying linearly between 12 and 14 with 51 values:

```>>> iunc = get_int_unc(src.r0, id="src", min=12, max=14,
...                    nloop=51, recalc=True)```

### PARAMETERS

The parameters for this function are:

Parameter Definition
par The parameter to plot. This argument is only used if `recalc` is set to `True` .
id The data set that provides the data. If not given then all data sets with an associated model are used simultaneously.
otherids Other data sets to use in the calculation.
recalc The default value ( False ) means that the results from the last call to `int_proj` (or `get_int_proj` ) are returned, ignoring all other parameter values. Otherwise, the statistic curve is re-calculated, but not plotted.
min The minimum parameter value for the calculation. The default value of none means that the limit is calculated from the covariance, using the `fac` value.
max The maximum parameter value for the calculation. The default value of none means that the limit is calculated from the covariance, using the `fac` value.
nloop The number of steps to use. This is used when `delv` is set to none .
delv The step size for the parameter. Setting this over-rides the `nloop` parameter. The default is none .
fac When `min` or `max` is not given, multiply the covariance of the parameter by this value to calculate the limit (which is then added or subtracted to the parameter value, as required).
log Should the step size be logarithmically spaced? The default ( False ) is to use a linear grid.
numcores The number of CPU cores to use. The default is to use all the cores on the machine.

### Return value

The return value from this function is:

iunc -- The fields of this object can be used to re-create the plot created by `int_unc` .

## Bugs

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

confidence
conf, confidence, covar, covariance, get_conf, get_conf_results, get_covar, get_covar_opt, get_covar_results, get_covariance_results, get_int_proj, get_proj, get_proj_opt, get_proj_results, get_projection_results, get_reg_proj, get_reg_unc, int_proj, int_unc, proj, projection, reg_proj, reg_unc, set_conf_opt, set_covar_opt, set_proj_opt
contrib
get_chart_spectrum, get_marx_spectrum
data
get_areascal, get_arf, 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
filtering
get_filter
fitting
calc_stat_info, get_stat_info
info
get_default_id, 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
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