AHELP for CIAO 4.16 Sherpa

# calc_stat

Context: utilities

## Synopsis

Calculate the fit statistic for a data set.

## Syntax

```calc_stat(id=None, *otherids)

id - int or str, optional
*otherids - int or str, optional```

## Description

Evaluate the model for one or more data sets, compare it to the data using the current statistic, and return the value. No fitting is done, as the current model parameter, and any filters, are used.

## Examples

### Example 1

Calculate the statistic for the model and data in the default data set:

`>>> stat = calc_stat()`

### Example 2

Find the statistic for data set 3:

`>>> stat = calc_stat(3)`

### Example 3

When fitting to multiple data sets, you can get the contribution to the total fit statistic from only one data set, or from several by listing the datasets explicitly. The following finds the contribution from the data sets labelled "core" and "jet":

`>>> stat = calc_stat("core", "jet")`

### Example 4

Calculate the statistic value using two different statistics:

```>>> set_stat('cash')
>>> s1 = calc_stat()
>>> set_stat('cstat')
>>> s2 = calc_stat()```

### PARAMETERS

The parameters for this function are:

Parameter Definition
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.

### Return value

The return value from this function is:

stat -- The current statistic value.

## Bugs

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

data
get_bkg_chisqr_plot, get_bkg_delchi_plot, get_bkg_fit_plot, get_bkg_model_plot, get_bkg_plot, get_bkg_ratio_plot, get_bkg_resid_plot, get_bkg_source_plot
fitting
calc_stat_info, fit, simulfit
info
list_model_ids, show_bkg_model, show_bkg_source
methods
get_iter_method_name, get_iter_method_opt, list_iter_methods, set_iter_method, set_iter_method_opt
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_num_par_frozen, get_num_par_thawed, get_order_plot, get_par, get_pileup_model, get_source, get_source_component_image, get_source_component_plot, get_source_contour, get_source_image, get_source_plot, get_xsabund, get_xscosmo, get_xsxsect, get_xsxset, image_model, image_model_component, image_source, image_source_component, integrate, link, load_table_model, load_template_interpolator, load_template_model, load_user_model, normal_sample, reset, save_model, save_source, set_bkg_model, set_bkg_source, set_full_model, set_model, set_model_autoassign_func, set_pileup_model, set_source, set_xsabund, set_xscosmo, set_xsxsect, set_xsxset, t_sample, uniform_sample
plotting
get_cdf_plot, get_pdf_plot, get_pvalue_plot, get_pvalue_results, plot_cdf, plot_fit, plot_fit_delchi, plot_fit_resid, plot_model, plot_model_component, plot_pdf, plot_pvalue, plot_scatter, plot_source, plot_source_component, plot_trace
psfs
saving
save_delchi, save_resid
statistics
get_stat, get_stat_name, set_stat
tools::response
color_color, modelflux
tools::statistics
aprates
utilities
calc_chisqr, calc_energy_flux, calc_model_sum, calc_photon_flux, calc_source_sum, eqwidth, gamma, igam, igamc, incbet, lgam
visualization
contour_model, contour_ratio, contour_resid, image_fit