Chandra X-Ray Observatory
Skip to the navigation links
Last modified: December 2014

Jump to: Description · Examples · Bugs · See Also

AHELP for CIAO 4.9 ChIPS v1


Context: preference


Sets the specified preferences.




The function arguments.

Argument Description
list or dictionary A list of key/value pairs or a dictionary, for example: ["curve.symbol.color", "red", "export.clobber", True] or {"curve.symbol.color": "red", "export.clobber": True}. Unlike set_preference, the values need not be strings.
string A string containing a single preference/value entry, such as "point.fill=false". The preference name can include '*' when it makes sense, such as 'curve.*.color'.
object An attribute object - such as ChipsHistogram or ChipsPReferences - containing the fields to be changed. Any field with a value of None is ignored.

When do the changes take affect?

The set_preferences command sets the specified set of preferences to the supplied value. The new settings do not affect the attributes of existing objects and data, only new ones created after the call to set_preferences, except for the foreground.display and background.display settings. For these two preferences only, all existing windows will also be updated.

What objects can be used?

The following attribute objects are supported:

  • ChipsWindow
  • ChipsFrame
  • ChipsPlot
  • ChipsAxis
  • ChipsCurve
  • ChipsHistogram
  • ChipsImage
  • ChipsContour
  • ChipsLabel
  • ChipsLine
  • ChipsPoint
  • ChipsRegion
  • ChipsColorBar
  • ChipsExport
  • ChipsInfo
  • ChipsPreferences

The ChipsPreferences object contains fields for all the objects and for the ancillary preferences such as "export" and "info".

The meanings of the various fields of these objects are given in "ahelp preferences" and "ahelp set_<object>" (e.g. "ahelp set_image"). The ChIPS Dictionary ("ahelp chipsopt") lists the allowed values for colors, fonts, line styles, etc.

Saving and restoring preferences

The save_preferences and load_preferences commands may be used to save and reload ChIPS preferences, respectively.

Example 1

chips> set_preferences(["point.color", "red", "point.size", 3])

Set the default point color to red and the size to 3.

Example 2

chips> prefs = ['foreground.display', 'black', 'background.display',
chips> set_preferences(prefs)

Change the colors used to display the 'default' color values for the display (i.e. on screen) to match that used when creating the hardcopy (e.g. PNG, PDF) versions of the visualization (i.e. the foreground.file and background.file settings).

Unlike other preferences, these two are applied to all existing windows as well as any new ones created after the set_preferences call.

Example 3

chips> prefs = {'foreground.display': 'black', 'background.display':
chips> set_preferences(prefs)

This is a repeat of the previous example, using a dictionary rather than a list to define the preferences to change.

Example 4

chips> set_preferences("point.fill=false")

By default, points will not be filled.

Example 5

chips> set_preferences("axis.*.thickness=2")

Change all the thickness elements of the axis to use a thickness of 2 by default.

Example 6

chips> axp = ChipsAxis()
chips> axp.label.color = "red"
chips> axp.offset.perpendicular = 10
chips> set_preferences(axp)

Using the axp object, set the default axis label color to red and the perpendicular offset to 10.


See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.

See Also

preferences, setget
get_preference, get_preferences, load_preferences, save_preferences, set_preference, set_preference_autoload

Last modified: December 2014
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: Smithsonian Institution, Copyright © 1998-2017. All rights reserved.