Last modified: December 2013

URL: https://cxc.cfa.harvard.edu/chips/ahelp/move_plot.html
Jump to: Description · Examples · Bugs · See Also


AHELP for CIAO 4.11 ChIPS v1

move_plot

Context: plots

Synopsis

Moves the plot to a new location.

Syntax

move_plot(xval, yval)
move_plot(xval, yval, mode)
move_plot(id, xval, yval)
move_plot(id, xval, yval, mode)

Description

The function arguments.

Argument Description
xval, yval The x and y coordinates to move. The mode parameter determines whether these are relative or absolute. Unless explicitly specified by the coord_sys field of the optional ChipsId argument, the coordinate system used to create the object is used.
mode The position is in absolute coordinates (mode=0) or relative (mode=1). The default is absolute.
id A ChipsId structure identifying the item.

The move_plot command moves the plot to a new position. The new location may be specified as an absolute position (default) or as relative offsets from the original location. When the "mode" parameter is set to absolute (0), (xval,yval) will be the new location of the lower left corner of the plot. If using relative offsets, the whole plot is shifted by the indicated amount. The move_plot command cannot specify (xval,yval) that moves the plot outside of the frame.

The following coordinate systems may be used to move a plot: PIXEL, WINDOW_NORM, or FRAME_NORM. The system is specified by setting the coord_sys field of the optional ChipsId structure which may be passed into the move_plot routine. If a ChipsId is not provided, frame normalized coordinates are used.

When a plot is moved, it remains in frame normalized coordinates regardless of what coordinate system was used for the move. The move command translates the specified values to the frame normalized coordinate system before moving the plot. This means that if a frame is repositioned, the plot will be adjusted accordingly.

This command is equivalent to calling the move command with 'chips_plot' specified as the object.


Examples

Example 1

chips> add_plot()
chips> move_plot(0.1, 0.1)

Move the plot to the location (0.1, 0.1) in the frame.

Example 2

chips> add_plot(0.5, 0.3, 0.9, 0.7)
chips> move_plot(-0.2, 0.1, 1)

Move the plot left 0.2 and up 0.1 in frame normalized units. The new location of the plot will be (0.3, 0.4, 0.7, 0.8).

Example 3

chips> add_window(360, 360, "pixels")
chips> add_plot(0.2, 0.2, 0.5, 0.9)
chips> id = ChipsId()
chips> id.coord_sys = PIXEL
chips> move_plot(id, 36, 36)

Move the plot to pixel location (36,36).

Example 4

chips> add_plot(0.05, 0.1, 0.5, 0.9, 'id="1st plot"')
chips> add_plot(0.5, 0.1, 0.95, 0.9, 'id="2nd plot"')
chips> move_plot('all', -0.05, 0, 1)
chips> move_plot('2nd plot', 0.1, 0, 1)

Create two plots. Move both plots 0.05 to the left, the shift the second plot back 0.1 to the right. This creates a gap between the two plots that could also have been achieved by using a split or grid_objects command.


Bugs

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

See Also

limits
get_plot_range
plots
add_plot, adjust_grid_gaps, adjust_grid_xrelsize, adjust_grid_xrelsizes, adjust_grid_yrelsize, adjust_grid_yrelsizes, clear_plot, current_plot, delete_plot, display_plot, get_plot, grid_objects, hide_plot, reposition_plot, set_data_aspect_ratio, set_plot, set_plot_aspect_ratio, split, strip_chart, swap_object_positions