About Chandra Archive Proposer Instruments & Calibration Newsletters Data Analysis HelpDesk Calibration Database NASA Archives & Centers Chandra Science Links

Skip the navigation links
Search the ChIPS website
Last modified: December 2007

URL: http://cxc.harvard.edu/chips4.0/adjust_grid_gaps.sl.html

[ChIPS Logo]

Home page (ChIPS)
Help pages (AHELP)
List by alphabet
List by context
Jump to:
A B C D E G H I L M P R S T U
 
A
add_axis - py sl
add_contour - py sl
add_curve - py sl
add_frame - py sl
add_histogram - py sl
add_hline - py sl
add_label - py sl
add_line - py sl
add_plotarea - py sl
add_plot - py sl
add_point - py sl
add_region - py sl
add_vline - py sl
add_window - py sl
adjust_grid_gaps - py sl
adjust_grid_xrelsizes - py sl
adjust_grid_xrelsize - py sl
adjust_grid_yrelsizes - py sl
adjust_grid_yrelsize - py sl
attributes - py sl
 
B
bind_axes - py sl
 
C
check_server_exists - py sl
chipsid - py sl
chipsopt - py sl
chips
clear_errors - py sl
clear_plot - py sl
clear - py sl
collapse_depths - py sl
colors - py sl
connect - py sl
convert_coordinate - py sl
coordinates - py sl
create_server - py sl
currency - py sl
current_axis - py sl
current_contour - py sl
current_curve - py sl
current_frame - py sl
current_histogram - py sl
current_label - py sl
current_line - py sl
current_plot - py sl
current_point - py sl
current_region - py sl
current_window - py sl
 
D
deiconify_window - py sl
delete_axis - py sl
delete_contour - py sl
delete_curve - py sl
delete_frame - py sl
delete_histogram - py sl
delete_label - py sl
delete_line - py sl
delete_plot - py sl
delete_point - py sl
delete_region - py sl
delete_window - py sl
depthcontrol - py sl
disconnect - py sl
display_axis - py sl
display_contour - py sl
display_curve - py sl
display_depth - py sl
display_frame - py sl
display_histogram - py sl
display_label - py sl
display_line - py sl
display_plot - py sl
display_point - py sl
display_region - py sl
 
E
entitycreation - py sl
erase - py sl
 
G
get_attribute - py sl
get_axis - py sl
get_contour - py sl
get_curve - py sl
get_default_depth - py sl
get_errors - py sl
get_frame - py sl
get_histogram - py sl
get_label - py sl
get_line - py sl
get_pick - py sl
get_plot_range - py sl
get_plot - py sl
get_point - py sl
get_preferences - py sl
get_preference - py sl
get_region - py sl
get_server_id - py sl
get_window - py sl
get_xaxis - py sl
get_yaxis - py sl
grid_objects - py sl
 
H
hide_axis - py sl
hide_contour - py sl
hide_curve - py sl
hide_depth - py sl
hide_frame - py sl
hide_histogram - py sl
hide_label - py sl
hide_line - py sl
hide_major_ticks - py sl
hide_minor_ticks - py sl
hide_plot - py sl
hide_point - py sl
hide_region - py sl
 
I
iconify_window - py sl
info_bound_axes - py sl
info_coordinate - py sl
info_current - py sl
info_depth - py sl
info - py sl
 
L
limits - py sl
linear_scale - py sl
list_servers - py sl
load_font - py sl
load_preferences - py sl
load_state - py sl
lock - py sl
log_scale - py sl
 
M
make_figure - py sl
move_axis - py sl
move_frame - py sl
move_label - py sl
move_line - py sl
move_plot - py sl
move_point - py sl
move_region - py sl
move - py sl
 
P
pick - py sl
preferences - py sl
print_window - py sl
 
R
redo - py sl
reindex_depth - py sl
reposition_frame - py sl
reposition_plot - py sl
reverse_axes - py sl
 
S
save_preferences - py sl
save_state - py sl
setget - py sl
set_attribute - py sl
set_axis - py sl
set_cascading_property - py sl
set_contour - py sl
set_current - py sl
set_curve - py sl
set_default_depth - py sl
set_error_verbosity - py sl
set_frame - py sl
set_histogram - py sl
set_label - py sl
set_line - py sl
set_plot - py sl
set_point - py sl
set_preferences - py sl
set_preference_autoload - py sl
set_preference - py sl
set_region - py sl
set_window - py sl
set_xaxis - py sl
set_yaxis - py sl
show_major_ticks - py sl
show_minor_ticks - py sl
shuffle_axis - py sl
shuffle_backward - py sl
shuffle_back - py sl
shuffle_contour - py sl
shuffle_curve - py sl
shuffle_forward - py sl
shuffle_front - py sl
shuffle_histogram - py sl
shuffle_label - py sl
shuffle_line - py sl
shuffle_point - py sl
shuffle_region - py sl
shuffle - py sl
split - py sl
strip_chart - py sl
swap_object_positions - py sl
 
T
tile - py sl
 
U
unbind_axes - py sl
undo - py sl
unlock - py sl
 
Jump to:
A B C D E G H I L M P R S T U
Home page (ChIPS)
Help pages (AHELP)
List by alphabet
List by context
Jump to: Description Examples Bugs See Also

AHELP for ChIPS 4.0 adjust_grid_gaps Context: sl.chips

Synopsis

Modifies the spacing between plots created by split or grid_objects.

Syntax

adjust_grid_gaps([id,] xgap, ygap);

Description

  • id - an optional ChipsId structure containing values to modify the currency state for the command
  • xgap - spacing between the columns of plots as percentage of the frame width
  • ygap - spacing between the rows of plots as percentage of the frame width

The adjust_grid_gaps command adjusts the space between the plot areas in a gridded plot created by the split ("ahelp sl.chips split") or grid_objects ("ahelp sl.chips grid_objects") command.

There are also individual commands for modifying just the xgap or the ygap: 

adjust_grid_xgap([id,] xgap);
adjust_grid_ygap([id,] ygap);

The values of xgap and ygap must be greater than or equal to 0, but less than 1. The number of rows or columns in the grid/split and the size of the plot margins impact the maximum value of either parameter. The plot sizes are adjusted to accommodate the new spacing. The size of the plots in the grid are calculated as follows: 

plot_width  = (1 - (left_margin+right_margin + (ncols-1)*xgap))/ncols 
plot_height = (1 - (bottom_margin+top_margin + (nrows-1)*ygap))/nrows

The margins, gaps, and plot widths in each direction (horizontal and vertical) must sum to 1.

To change the relative sizes of the plots, refer to the help file for each of the following commands: adjust_grid_xrelsize, adjust_grid_xrelsizes, adjust_grid_yrelsize, or adjust_grid_yrelsizes.

Example 1

chips> split(2,2);
chips> adjust_grid_gaps(.15,.1);

A split command is issued to create a grid of four plots with no gap between them. The adjust_grid_gaps command changes the vertical spacing between the rows to 10 percent and the horizontal spacing between the columns to 15 percent.

Example 2

chips> grid_objects(3,2,0.05,0.05,1);
chips> adjust_grid_gaps(0.04,.1);

A grid_objects command is called to create a grid of 6 plot areas; the spacing between rows and columns is five percent of the frame width (0.05). The adjust_grid_gaps command changes the column spacing to 4 percent and the row spacing to 10 percent.

Example 3

chips> grid_objects(3,3,0,0,1);
chips> adjust_grid_ygap(0.05);

A grid_objects command is called to create a grid of 9 plot areas with no gap. The adjust_grid_ygap command sets the vertical spacing to five percent (0.05).

Example 4

chips> split(2,2);
chips> adjust_grid_xgap(.1);

A split command creates a grid of four plots with no gap. The adjust_grid_xgap command changes the horizontal spacing between the columns to 10 percent.

Bugs

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

See Also

sl.chips
add_plot, add_plotarea, 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, move_plot, reposition_plot, set_plot, split, strip_chart, swap_object_positions
Last modified: December 2007


Chandra Science | Chandra Home | Astronomy links | iCXC (CXC only) | Search


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-2004. All rights reserved.