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 2006

URL: http://cxc.harvard.edu/ciao3.4/chips_set_pane.html
Hardcopy (PDF): A4 | Letter
AHELP for CIAO 3.4 chips_set_pane Context: chips

Synopsis

Set the current pane/drawing area.

Syntax

Integer_Type chips_set_pane(which)
Integer_Type chips_set_drawing_area(which)

Description

This is a S-Lang version of the ChIPS D command. It sets the current pane/drawing area; the two commands are identical. The numbering scheme of the panes is described in "ahelp chips_split".

The function returns a 0 on success and -1 on failure.

Arguments for chips_set_pane

Name Type Comment
which Integer_Type number of the pane

If "which" exceeds the number of panes, the function returns a -1 and the current pane is unchanged.

Example 1

  chips> chips_split(2,3)
  6
  chips> chips_set_pane(2)
  0
	

Here we create 6 panes, arranged in a 2 by 3 grid, and set the current pane to be the second one. This example could also be done using the optional whichPane parameter of chips_split():

  chips> chips_split(2,3,2)
  0
	

Example 2

  () = chips_split(2,3);
  () = chips_set_pane(2);
	

As the first example, but done in a S-Lang script. Here the return values are ignored.

Bugs

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

Hardcopy (PDF): A4 | Letter
Last modified: December 2006



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.