Synopsis
Specify the height of all rows of plots created by split or grid_objects.
Syntax
adjust_grid_yrelsizes(heights) adjust_grid_yrelsizes(id, heights)
Description
The function arguments.
Argument | Description |
---|---|
heights | An array containing the relative heights of each row, starting at the top. |
id | A ChipsId structure identifying the item. |
The adjust_grid_yrelsizes command changes the size of all rows of plots in a frame created by split or grid_objects, using the values supplied in the heights parameter. The relational heights of all rows must be specified. For each row i, the height is calculated as
heights[i] * unit_height
where
available_area = 1 - (top_margin + bottom_margin + (num_rows-1)*ygapsize)
arraysum = heights[0] + heights[1] + .. + heights[n]
unit_height = available_area / arraysum
Since the rows are adjusted based on ratios of the heights, the scale of the values is not important. The arrays "[3,6,12]", "[.1,.2,.4]", and "[500,100,200]" all produce the same row height: the rows double in size as they move from top to bottom.
To change the spacing between the plots, use the adjust_grid_gaps command.
Examples
Example 1
chips> split(3,3) chips> adjust_grid_yrelsizes([1,2,2])
A split command is issued to create a grid of 9 plots. The adjust_grid_yrelsizes command sets the height of the second and third rows of plots to be double the height of the first row.
Example 2
chips> adjust_grid_yrelsizes([1,1])
Set the heights of two rows of plots to be equal.
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, 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