split.sh(1)	       Grass User's Manual	      split.sh(1)



NNAAMMEE
       sspplliitt..sshh   -  Divides the graphics monitor into two frames
       and then displays two maps in these frames.
       _(_G_R_A_S_S _S_h_e_l_l _S_c_r_i_p_t_)

SSYYNNOOPPSSIISS
       sspplliitt..sshh     mmaappnnaammee	 mmaappnnaammee      [ccmmdd==_G_R_A_S_S___c_o_m_m_a_n_d]
       [ccmmdd22==_G_R_A_S_S___c_o_m_m_a_n_d] [vviieeww==hhoorriizz]

DDEESSCCRRIIPPTTIIOONN
       _s_p_l_i_t_._s_h  is  a	Bourne	shell (_s_h) 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  compar-
       ing  maps  (raster, vector, and 3-d views) and can be used
       by other GRASS shell macros.  It is also useful for creat-
       ing demos.  Program parameters are given below.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       vviieeww==hhoorriizz
	      The  graphics  screen  can be split either horizon-
	      tally 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 sec-
	      ond map will be displayed in the	bottom	or  right
	      window.

       ccmmdd==_G_R_A_S_S___c_o_m_m_a_n_d
	      The  GRASS  command  used to display the named _m_a_p_-
	      _n_a_m_es.  If no command is	specified  by  the  user,
	      _d_._r_a_s_t is used by default.  However, any GRASS dis-
	      play command (e.g., _d_._3_d_, _d_._v_e_c_t, etc...)   can  be
	      entered.

       ccmmdd22==_G_R_A_S_S___c_o_m_m_a_n_d
	      This  command  will  be used to display map data in
	      the second frame only.
	      If the user fails to specify the values of both _c_m_d
	      and  _c_m_d_2,  _s_p_l_i_t_._s_h  will  use the default command
	      (_d_._r_a_s_t) to display user-specified map layer  names
	      in  both	frames.   If  the user specifies only the
	      value of _c_m_d on the command line, then that command
	      will  be	executed  for  both  frames.  If the user
	      specifies the values of both _c_m_d and  _c_m_d_2  on  the
	      command  line,  the _c_m_d command will be executed in
	      frame 1 and the _c_m_d_2 command will  be  executed  in
	      frame 2.


EEXXAAMMPPLLEESS
       sspplliitt..sshh  soils	vegcover

       sspplliitt..sshh  soils	ccmmdd22==dd..lleeggeenndd "soils red"

       sspplliitt..sshh elevation vegcover ccmmdd==d.3d vviieeww==horiz


NNOOTTEESS
       _s_p_l_i_t_._s_h  leaves  the frame that the last map was drawn in
       as the active frame.  The order in which the options (_c_m_d,
       _c_m_d_2, _v_i_e_w) are placed on the command line doesn't matter,
       but the order is important for the map names.

FFIILLEESS
       This program is simply a shell script.  Users are  encour-
       aged  to  make their own shell scripts using similar tech-
       niques.	See $GISBASE/scripts/split.sh.

SSEEEE AALLSSOO
       _d_._3_d

       _d_._f_r_a_m_e

       _d_._r_a_s_t

       _d_._s_i_t_e_s

       _d_._v_e_c_t

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

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_5 _$



GRASS 5.0					      split.sh(1)
