get_backscal¶

sherpa.astro.ui.get_backscal(id=None, bkg_id=None)¶

Return the area scaling of a PHA data set.

Return the BACKSCAL setting [1] for the source or background component of a PHA data set.

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. bkg_id (int or str, optional) – Set to identify which background component to use. The default value (`None`) means that the value is for the source component of the data set.
Returns:	backscal – The BACKSCAL value.
Return type:	number or array

See also

get_areascal(): Return the fractional area factor of a PHA data set.
get_bkg_scale(): Return the background scaling factor for a PHA data set.
set_backscal(): Change the area scaling of a PHA data set.

Notes

The BACKSCAL value can be defined as the ratio of the area of the source (or background) extraction region in image pixels to the total number of image pixels. The fact that there is no ironclad definition for this quantity does not matter so long as the value for a source dataset and its associated background dataset are defined in the similar manner, because only the ratio of source and background BACKSCAL values is used. It can be a scalar or be an array.

References

[1]	“The OGIP Spectral File Format”, Arnaud, K. & George, I. http://heasarc.gsfc.nasa.gov/docs/heasarc/ofwg/docs/spectra/ogip_92_007/ogip_92_007.html

Examples

>>> get_backscal()
7.8504301607718007e-06
>>> get_backscal(bkg_id=1)
0.00022745132446289