sherpa.astro.ui.get_contour_prefs(contourtype, id=None)

Return the preferences for the given contour type.

New in version 4.16.0.

  • contourtype (str) – The contour type, such as “data”, “model”, or “resid”. The “fit” argument is not supported.

  • id (int or str, optional) – The data set that provides the data. If not given then the default identifier is used, as returned by get_default_id.


prefs – Changing the values of this dictionary will change any new contour plots. This dictionary will be empty if no plot backend is available.

Return type:



The meaning of the fields depend on the chosen plot backend. A value of None means to use the default value for that attribute, or not to use that setting.

The “fit” argument can not be used, even though there is a get_fit_contour call. Either use the “data” or “model” arguments to access the desired plot type, or use get_fit_contour() and access the datacontour and modelcontour attributes directly.


Change the contours of the model to be drawn partly opaque (with the matplotlib backend):

>>> prefs = get_contour_prefs("data")
>>> prefs['alpha'] = 0.7
>>> contour_data()
>>> contour_model(overcontour=True)