get_conf

sherpa.astro.ui.get_conf()

Return the confidence-interval estimation object.

Returns:conf
Return type:object

See also

conf()
Estimate confidence intervals using the confidence method.
get_conf_opt()
Return one or all of the options for the confidence interval method.
set_conf_opt()
Set an option of the conf estimation object.

Notes

The attributes of the confidence-interval object include:

eps
The precision of the calculated limits. The default is 0.01.
fast
If True then the fit optimization used may be changed from the current setting (only for the error analysis) to use a faster optimization method. The default is False.
max_rstat
If the reduced chi square is larger than this value, do not use (only used with chi-square statistics). The default is 3.
maxfits
The maximum number of re-fits allowed (that is, when the remin filter is met). The default is 5.
maxiters
The maximum number of iterations allowed when bracketing limits, before stopping for that parameter. The default is 200.
numcores
The number of computer cores to use when evaluating results in parallel. This is only used if parallel is True. The default is to use all cores.
openinterval
How the conf method should cope with intervals that do not converge (that is, when the maxiters limit has been reached). The default is False.
parallel
If there is more than one free parameter then the results can be evaluated in parallel, to reduce the time required. The default is True.
remin
The minimum difference in statistic value for a new fit location to be considered better than the current best fit (which starts out as the starting location of the fit at the time conf is called). The default is 0.01.
sigma
What is the error limit being calculated. The default is 1.
soft_limits
Should the search be restricted to the soft limits of the parameters (True), or can parameter values go out all the way to the hard limits if necessary (False). The default is False
tol
The tolerance for the fit. The default is 0.2.
verbose
Should extra information be displayed during fitting? The default is False.

Examples

>>> print(get_conf())
name         = confidence
numcores     = 8
verbose      = False
openinterval = False
max_rstat    = 3
maxiters     = 200
soft_limits  = False
eps          = 0.01
fast         = False
maxfits      = 5
remin        = 0.01
tol          = 0.2
sigma        = 1
parallel     = True

Change the remin field to 0.05.

>>> cf = get_conf()
>>> cf.remin = 0.05