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