About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Last modified: December 2007

URL: http://cxc.harvard.edu/chips4.0/set_point.py.html
AHELP for ChIPS 4.0 set_point Context: py.chips

Synopsis

Modifies the attributes of an existing point.

Syntax

set_point([id,] values)

Description

  • id - an optional ChipsId structure containing values to modify the currency state for the command or a string id to modify a point within the current frame.
  • values - a list containing attribute value pairs or a ChipsPoint object.

The set_point command sets the specified attributes to the provided values. The modified point becomes current. Multiple points may be modified with a single command by setting the currency to "all".

Customizing the Point

There are several attributes that control the characteristics of points. The set_point command may be used to modify the attribute values of an existing point at any time during a ChIPS session. See "ahelp py.chips attributes" and "ahelp py.chips setget" for more general information.

If multiple attributes are being set simultaneously and one of them fails, the entire command will fail and the point will not be modified.

The attributes associated with points are:

Attribute Description Options Default
angle Angle at which the point is drawn -360.0:360.0 0.0
color Color of the point see the Color section of "ahelp py.chips chipsopt" default
depth Integer value indicating point depth see the Depth section of "ahelp py.chips chipsopt" 100
fill Controls whether the point is displayed as an outline or solid see the Boolean section of "ahelp py.chips chipsopt" true
size size of the point 1:100 12
style Symbol style of the point see the Symbol Style section of "ahelp py.chips chipsopt" chips_cross

These individual commands are also available for setting attribute values:

set_point_angle
set_point_color
set_point_depth
set_point_fill
set_point_size
set_point_style

Example 1

chips> set_point(['color','coral', 'style', 'downtriangle'])

Using attribute/value pairs, set the point color to coral and symbol style to downtriangles.

Example 2

chips> settings = ChipsPoint()
chips> settings.color = 'blue'
chips> settings.size = 16
chips> set_point('pnt1',settings)

Populate the "settings" structure with attribute values, then use it to set pnt1 to be blue with a size of 16.

Example 3

chips> class pntprop:
chips> def __init__(self):
chips> self.color='cyan'
chips> self.depth=50
chips> set_point(pntprop())

Create a user-defined structure with color and depth fields. Use the structure to modify the values of the current point.

Bugs

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

Last modified: December 2007



The Chandra X-Ray Center (CXC) is operated for NASA by the Smithsonian Astrophysical Observatory.
60 Garden Street, Cambridge, MA 02138 USA.    Email: cxcweb@head.cfa.harvard.edu
Smithsonian Institution, Copyright © 1998-2004. All rights reserved.