sherpa.astro.ui.notice_id(ids, lo=None, hi=None, **kwargs)

Include data from the fit for a data set.

Select one or more ranges of data to include by filtering on the independent axis value. The filter is applied to the given data set, or data sets.

  • ids (int or str, or array of int or str) – The data set, or sets, to use.
  • lo (number or str, optional) – The lower bound of the filter (when a number) or a string expression listing ranges in the form a:b, with multiple ranges allowed, where the ranges are separated by a ,. The term :b means include everything up to, and including b, and a: means inlude everything that is higher than, or equal to, a.
  • hi (number, optional) – The upper bound of the filter when lo is not a string.
  • bkg_id (int or str, optional) – The filter will be applied to the associated background component of the data set if bkg_id is set. Only PHA data sets support this option; if not given, then the filter is applied to all background components as well as the source data.

See also

Exclude data from the fit for a data set.
Exclude a spatial region from an image.
Include data in the fit.
Show any filters applied to a data set.


The order of ignore and notice calls is important.

The units used depend on the analysis setting of the data set, if appropriate.

To filter a 2D data set by a shape use ignore2d.


Include all data points with an X value (the independent axis) between 12 and 18 for data set 1:

>>> notice_id(1, 12, 18)

Include the range 0.5 to 7, for data sets 1, 2, and 3:

>>> notice_id([1,2,3], 0.5, 7)

Apply the filter 0.5 to 2 and 2.2 to 7 to the data sets “core” and “jet”:

>>> notice_id(["core","jet"], "0.5:2, 2.2:7")