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



NNAAMMEE
       sspplliitt..sshh   - Divides the graphics monitor into two frames and then dis-
       plays 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 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.

OOPPTTIIOONNSS
   PPaarraammeetteerrss::
       vviieeww==hhoorriizz
	      The graphics screen can be split either horizontally  or	verti-
	      cally.   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.

       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 display 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  exe-
	      cuted in frame 2.


EEXXAAMMPPLLEESS
       sspplliitt..sshh  soils	vegcover

       sspplliitt..sshh  soils	ccmmdd22==dd..lleeggeenndd "soils color=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  encouraged  to  make
       their   own   shell   scripts  using  similar  techniques.   See  $GIS-
       BASE/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_3_/_0_3_/_1_6 _1_2_:_2_5_:_1_9 _$



GRASS 5.0							   split.sh(1)
