Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: December 2013

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


AHELP for CIAO 4.9 Sherpa v1

get_staterror

Context: data

Synopsis

Return the statistical errors on the counts of a data set

Syntax

get_staterror( [id, filter=False, bkg_id] )

Description

The get_staterror() function returns the statistical errors on the counts of a source or background data set, by data id or bkg_id. The statistical errors returned are either those calculated by the current statistics or set by the user with set_staterror(). If a data filter has been applied to the data set in question, e.g. ignore() or notice(), the statistical error array for either the filtered or unfiltered data set may be returned by setting the 'filter' argument to 'True' or 'False'. If set to 'True', the statistical error array returned by get_staterror() will be filtered, i.e. the array will be shorter in length than the unfiltered array (not padded with zeros).

  • id - the id of the data set to use; if not given, uses the default dataset id (id=1 by default, see "ahelp get_default_id")
  • filter - apply an established data filter to the data set before returning results; default=False
  • bkg_id - the id of the background to use, e.g. if more than one background is associated with the data; default is the first background data set loaded

Example 1

sherpa> get_staterror()

When called with no arguments, the get_staterror() function returns the statistical error array of the unfiltered default data set.

sherpa> get_staterror()

array([  1.8660254 ,   1.8660254 ,   1.8660254 ,   1.8660254 ,
         1.8660254 ,   1.8660254 ,   1.8660254 ,   1.8660254 ,
. . . ., 
       2.32287566,   2.6583124 ,   2.6583124 ,   2.32287566,
         1.8660254 ,   2.93649167,   2.32287566,  18.25543393])

Example 2

sherpa> get_staterror(1, bkg_id=1)

To return the statistical error array of a background associated with a data set, the background ID must be specified along with the data set ID. Here, the statistical error array for the first background loaded for data set 1 is returned by get_staterror().

sherpa> get_staterror(1, 1)        

array([  1.8660254 ,   1.8660254 ,   1.8660254 ,   1.8660254 ,
         1.8660254 ,   1.8660254 ,   1.8660254 ,   1.8660254 ,
. . . ., 
       2.32287566,   2.6583124 ,   2.6583124 ,   2.32287566,
         1.8660254 ,   2.93649167,   2.32287566,  18.25543393])

Example 3

sherpa> get_staterror(1, filter=True)

If a data set ID is supplied to get_staterror(), the unfiltered statistical error array of the specified data set is returned, unless the 'filter' argument is set to 'True'.

sherpa> notice()
sherpa> get_staterror().size
           1024
sherpa> ignore(10,12)
sherpa> get_staterror(filter=True).size
           886

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
data
copy_data, dataspace1d, dataspace2d, datastack, delete_data, fake, 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_syserror, group, load_ascii, load_data, load_grouping, load_quality, set_data, set_quality, ungroup, unpack_ascii, unpack_data
filtering
get_filter, load_filter, set_filter
fitting
calc_stat_info, get_fit, get_stat_info
info
get_default_id, list_data_ids, list_response_ids, list_stats
methods
get_draws, get_iter_method_name, get_iter_method_opt, get_method
modeling
clean, get_model, 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, get_source_component_plot, image_source
plotting
get_split_plot, plot_data, set_xlinear, set_xlog, set_ylinear, set_ylog
psfs
get_kernel, get_psf
saving
save_error, save_filter, save_grouping, save_quality, save_staterror, save_syserror
statistics
get_chisqr_plot, get_delchi_plot, get_prior, get_sampler, get_stat
utilities
calc_data_sum, calc_data_sum2d, calc_ftest, calc_kcorr, calc_mlr, calc_model_sum2d, calc_source_sum2d, get_analysis, get_rate
visualization
contour, contour_data, contour_ratio, get_ratio, get_resid, histogram1d, histogram2d, image_data, image_getregion, rebin

Last modified: December 2013
Smithsonian Institute Smithsonian Institute

The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory. 60 Garden Street, Cambridge, MA 02138 USA.   Email:   cxchelp@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2017. All rights reserved.