Chandra X-Ray Observatory
	(CXC)
Skip to the navigation links
Last modified: December 2013

URL: http://cxc.harvard.edu/chips/ahelp/set_current.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.9 ChIPS v1

set_current

Context: utilities

Synopsis

Set the specified object as current.

Syntax

set_current(object_type, object_name)
set_current(object_type, object_id)

Description

The function arguments.

Argument Description
object_type What type of object to modify, such as chips_window or chips_curve; see the Object Type section of "ahelp chipsopt".
object_name The name of the object to be made current.
object_id A ChipsId structure indicating which object should be made current.

The set_current command sets the object indicated by the argument as the current window; see "ahelp currency" for general information on currency.

There is also a "set_current" command for each ChIPS object:

  • set_current_axis
  • set_current_colorbar
  • set_current_contour
  • set_current_curve
  • set_current_frame
  • set_current_histogram
  • set_current_image
  • set_current_label
  • set_current_line
  • set_current_plot
  • set_current_point
  • set_current_region
  • set_current_window

Use the info_current command to retrieve a list of all the current items in the ChIPS session, as shown in Example 1.

Example 1

chips> add_plot()
chips> add_plot(.2, .2, .7, .7)
chips> set_current(chips_plot, "plot1")

Create two plots; the second one is current by default. Set plot1 to be current, so that we now have:

chips> print(info_current())
Window [win1]
  Frame [frm1]
    Plot [plot1]
    Coord Sys [Plot Normalized]

Example 2

chips> set_current(chips_window, "Fig3")

Set the window with the id "Fig3" to be current.

Bugs

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

See Also

concepts
chipsid, currency, setget

Last modified: December 2013
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:   cxchelp@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2017. All rights reserved.