## NAME

split.sh - Divides the graphics monitor into two frames and then displays two maps in these frames.
(GRASS Shell Script)

## SYNOPSIS

split.sh mapname mapname [cmd=GRASS_command] [cmd2=GRASS_command] [view=horiz]

## DESCRIPTION

split.sh is a Bourne shell (sh) script that clears the entire graphics screen and divides it into two display frames. Map layers are then displayed in each of the two frames. This command is very useful for visually comparing maps (raster, vector, and 3-d views) and can be used by other GRASS shell macros. It is also useful for creating demos. Program parameters are given below.

## OPTIONS

### Parameters:

view=horiz
  The graphics screen can be split either horizontally or vertically. The default view splits the screen into two frames, one on the left and one on the right (a vertical split). Some maps (3-d views) are better represented with more width then height (horizontal split). The first map name listed on the command line will be displayed in the top or left window (depending on whether the screen was split horizontally or vertically), and The second map will be displayed in the bottom or right window.
cmd=GRASS_command
  The GRASS command used to display the named mapnames. If no command is specified by the user, d.rast is used by default. However, any GRASS display command (e.g., d.3d, d.vect, etc...) can be entered.
cmd2=GRASS_command
  This command will be used to display map data in the second frame only.
  If the user fails to specify the values of both cmd and cmd2, split.sh will use the default command (d.rast) to display user-specified map layer names in both frames. If the user specifies only the value of cmd on the command line, then that command will be executed for both frames. If the user specifies the values of both cmd and cmd2 on the command line, the cmd command will be executed in frame 1 and the cmd2 command will be executed in frame 2.

## EXAMPLES

  split.sh soils vegcover

  split.sh soils cmd2=d.legend "soils color=red"

  split.sh elevation vegcover cmd= d.3d view=horiz

## NOTES

split.sh leaves the frame that the last map was drawn in as the active frame. The order in which the options (cmd, cmd2, view) are placed on the command line doesn't matter, but the order is important for the map names.

## FILES

This program is simply a shell script. Users are encouraged to make their own shell scripts using similar techniques. See `$GISBASE/scripts/split.sh`.

## SEE ALSO

d.3d
d.frame
d.rast
d.sites
d.vect

## AUTHOR

Michael Higgins, U.S.Army Construction Engineering Research Laboratory

Last changed: $Date: 2003/03/16 12:25:19 $