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

URL: http://cxc.harvard.edu/chips/ahelp/shuffle_histogram.html
AHELP for CIAO 4.6 ChIPS v1

shuffle_histogram

Context: histograms

Synopsis

Shuffles the rendering order of the histogram within the depth.

Syntax

shuffle_histogram()
shuffle_histogram(direction)
shuffle_histogram(id)
shuffle_histogram(id, direction)

Description

The function arguments.

Argument Description
direction What direction should the object be shuffled? The options are: chips_forward, chips_backward, chips_front, and chips_back. The default value is chips_forward.
id A ChipsId structure identifying the item, or a string containing the name of the object.

The shuffle_histogram command modifies the location of the specified histogram within the stack of items at the same depth. It may be used to position a histogram in front of or behind other objects which are at the same depth.

Example 1

chips> set_preference("histogram.fill.style", "1")
chips> set_preference("histogram.fill.opacity","0.8")
chips> add_histogram([1,3,5,8,2,1,0,0,1], "fill.color=sienna")
chips> add_histogram([2,0,3,4,5,7,1], "fill.color=coral")
chips> add_histogram([5,3,4,2,0,0,1], "fill.color=plum")
chips> shuffle_histogram("hist2", chips_forward)

Create three overlapping histograms, then move "hist2" - the second histogram - forward one step.

Example 2

chips> shuffle_histogram(chips_back)

Move the current histogram to the back of the display.

Shuffling objects

By default, objects within a depth are ordered chonologically based on when they were added to that depth. The objects are stacked with the oldest item at the back of the list and the newest item at the front of the list. This order dictates how the objects overlap when drawn.

The shuffle command changes the object's position within the stack. Any given object may be shuffled forward or backward one place in the stack or sent directly to the front or back of the stack.

The direction options:

Value Description
chips_back Send to the back of the stack.
chips_front Send to the front of the stack.
chips_forward Move one step closer to the front of the stack.
chips_backward Move one step further back along the stack.

The shuffle routines can only operate on a single object. An error is returned if currency is set to "all".

Bugs

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

See Also

axes
shuffle_axis
concepts
depthcontrol
contours
shuffle_contour
curves
shuffle_curve
depth
collapse_depths, display_depth, get_default_depth, hide_depth, reindex_depth, set_default_depth
histograms
add_histogram, current_histogram, delete_histogram, display_histogram, get_histogram, hide_histogram, set_histogram
images
shuffle_colorbar, shuffle_image
labels
shuffle_label
lines
shuffle_line
points
shuffle_point
regions
shuffle_region
shuffle
shuffle, shuffle_back, shuffle_backward, shuffle_forward, shuffle_front
utilities
load_fill

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:   cxcweb@head.cfa.harvard.edu Smithsonian Institution, Copyright © 1998-2014. All rights reserved.