split

Synopsis

Creates a grid of plot areas

split([id,] [rows,] [cols,] [ygap,] [xgap])

Description

• id - an optional ChipsId structure containing values to modify the currency state for the command or a string id to modify the specified window.
• rows - number of rows (default is 2)
• cols - number of columns (default is 1)
• ygap - spacing between the rows
• xgap - spacing between the columns

The split command creates a grid of "rows" x "cols" plot areas. The plot areas are numbered sequentially from the upper left corner, left to right and top to bottom.

If no argument is given, a 2 x 1 grid is created. If only the number of rows is specified, an N x 1 grid is created.

The xgap and ygap values are given as a percentage of the plot area, as defined by the plot margins in the preferences file.

Currency and the split command

The currency rules still apply when using the split command. This may be confusing when issuing multiple split commands or deleting a plot area after a split command. For instance:

chips> split(3,2)

chips> info_current()
Window [win1]
  Frame [frm1]
    Plot [plot1]
    Coord Sys [Plot Normalized]

chips> delete_plot("plot3")
chips> info_current()
Window [win1]
  Frame [frm1]
    Plot [plot6]
    Coord Sys [Plot Normalized]

The first plot area (plot1) is current after the split command. After deleting one of the plot areas, plot6 is current. This follows the currency rule that when an object is deleted, the last object of that type that was created becomes current (not the one that was most recently current).

Use the info_current command ("ahelp info_current") to find out which plot area is current at any point in the session.

Customizing the Grid

To modify the gap spacing after the grid has been created, use the adjust_grid_gaps, adjust_grid_xgap, and adjust_grid_xgap commands ("ahelp adjust_grid_gaps") . The row widths and column heights can be changed with the following commands, each of which has a help file: adjust_grid_xrelsize, adjust_grid_xrelsizes, adjust_grid_xrelsize, and adjust_grid_xrelsizes.

The strip_chart command has functionality similar to split; see "ahelp strip_chart" for information on how to create a strip chart containing multiple plots.

Example 1

chips> split()

Create a grid with two plots, one above the other.

Example 2

chips> split(3, 2, 0, 0.05)

Create a grid with three rows and 2 columns. There is a horizontal gap between the two columns but no gap between the rows.

Example 3

chips> split("win1", 4, 1, 0.01)

Create 4 plots arranged vertically in the window with id "win1". Set the vertical gap between each plot to 0.05.

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, move_plot, reposition_plot, set_data_aspect_ratio, set_plot, set_plot_aspect_ratio, strip_chart, swap_object_positions