Last modified: December 2015

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


AHELP for CIAO 4.11 ChIPS v1

adjust_grid_xrelsize

Context: plots

Synopsis

Modifies the widths of one column of plots created by split or grid_objects.

Syntax

adjust_grid_xrelsize(column, size)
adjust_grid_xrelsize(id, column, size)

Description

The function arguments.

Argument Description
column The column number to change, where the columns are numbered from left to right, starting at 1.
size The new width of the column given as a ratio to the other columns, so size=1 means the same size, size=2 is twice as wide.
id A ChipsId structure identifying the item.

The adjust_grid_xrelsize command the size of a column of plots relative to the other columns in the frame created by split or grid_objects.

The width of the specified column is set to "size * unit_width". All other columns are set to unit_width.

The following is used to determine the widths of the columns:

available_area = 1 - (left_margin + right_margin + (num_cols -1)*xgapsize)

unit_width = available_area / ((num_cols-1) + size)

To change the spacing between the plots, use the adjust_grid_gaps command.


Examples

Example 1

chips> split(3,3)
chips> adjust_grid_xrelsize(2,2)

A split command is issued to create a grid of 9 plots. The adjust_grid_xrelsize command sets the center column to be twice as wide as the other columns.

Example 2

chips> grid_objects(2,2,.05,.05,1)
chips> adjust_grid_xrelsize(1,.5)

A grid_objects command is called to create a grid of 4 plot areas. The adjust_grid_xrelsize command makes the first column half as wide as the second column.


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_xrelsizes, adjust_grid_yrelsize, adjust_grid_yrelsizes, clear_plot, current_plot, delete_plot, display_plot, get_plot, grid_objects, hide_plot, move_plot, reposition_plot, set_data_aspect_ratio, set_plot, set_plot_aspect_ratio, split, strip_chart, swap_object_positions