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/collapse_depths.sl.html
AHELP for ChIPS 4.0 collapse_depths Context: sl.chips

Synopsis

Merges an array of depths into a single new depth.

Syntax

collapse_depths( [id,] depth_list, new_depth );

Description

  • id - an optional ChipsId structure containing values to modify the currency state for the command or a string id to specify the frame. For this command, only the currency of windows and frames matters.
  • depth_list - a list of one or more depth values.
  • new_depth - the new value to assign to all objects indicated by the depth_list.

The collapse_depths command merges an array of depths into a single new depth. The order in which the depths are specified dictates the order in which the objects are merged into the new depth.

Use the info_depth command ("ahelp sl.chips info_depth") to see which depths are being used. For general information on depth, refer to "ahelp sl.chips depthcontrol" .

Example

chips> add_curve([0:9], [0:9], "line.color=blue symbol.color=blue
depth=50");
chips> add_curve([0:9], [9:0:-1], "depth=200");
chips> add_hline(5, "depth=70 color=red");
chips> collapse_depths({50,70,100}, 200);

Create two curves and a horizontal line at different depths. All objects at depths 50, 70, and 100 are collapsed to a depth of 200.

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.