get_syserror

sherpa.ui.get_syserror(id=None, filter=False)

Return the systematic error on the dependent axis of a data set.

The function returns the systematic errors on the values (dependenent axis) of a data set. It is an error if called on a data set with no systematic errors (which are set with set_syserror).

Parameters:
  • id (int or str, optional) – The identifier for the data set to use. If not given then the default identifier is used, as returned by get_default_id.
  • filter (bool, optional) – Should the filter attached to the data set be applied to the return value or not. The default is False.
Returns:

syserrors – The systematic error for each data point. The size of this array depends on the filter argument.

Return type:

array

Raises:

See also

get_error()
Return the errors on the dependent axis of a data set.
get_indep()
Return the independent axis of a data set.
get_staterror()
Return the statistical errors on the dependent axis of a data set.
list_data_ids()
List the identifiers for the loaded data sets.
set_syserror()
Set the systematic errors on the dependent axis of a data set.

Notes

The default behavior is to not apply any filter defined on the independent axes to the results, so that the return value is for all points (or bins) in the data set. Set the filter argument to True to apply this filter.

Examples

Return the systematic error for the default data set:

>>> yerr = get_syserror()

Return an array that has been filtered to match the data:

>>> yerr = get_syserror(filter=True)

Return the filtered errors for data set “core”:

>>> yerr = get_syserror("core", filter=True)