d.siter(1)		      Grass User's Manual		    d.siter(1)



NNAAMMEE
       _d_._s_i_t_e_r	- Interactively displays subsets of a sites list based on site
       attributes (_G_R_A_S_S _D_i_s_p_l_a_y _P_r_o_g_r_a_m)

SSYYNNOOPPSSIISS
       dd..ssiitteerr

       dd..ssiitteerr hheellpp

       dd..ssiitteerr _n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _d_._s_i_t_e_r is a script which calls s.info to determine the	number,  types
       and ranges of site attributes, then calls a tcl script which presents a
       user interface. On the interface there are two sliders for each	dimen-
       sion,  category,  or  decimal  attribute in the sites file. If a header
       with labels is in the file, the sliders will  be  labeled.   The  value
       range  for  each  slider pair is determined by the range for the corre-
       sponding attribute found in the sites file for sites within the current
       region.	At startup one slider in each pair is set at the minimum value
       and the other slider is set at the  maximum  value.  The  user  adjusts
       sliders	as  needed to set ranges of desired values for each attribute,
       dimension, or category. The interface also has controls for setting the
       size,  color, and type of marker, and buttons for ddiissppllaayy, eerraassee, rreesseett
       ssccaalleess, and qquuiitt.



	      When  the  ddiissppllaayy  button  is   chosen,	 the   GRASS   program
	      d.sites.qual is called with rules derived from the current state
	      of the interface and the specified subset is drawn in the active
	      GRASS  monitor.  By adjusting the size, color and type of marker
	      and drawing multiple subsets, the user may more easily visualize
	      spatial  relationships of various subsets or determine inconsis-
	      tant attribute values.

	      Subsets may be saved by entering a filename in  the  text  entry
	      box of the interface and choosing ssaavvee aass::.

	      Due  to  the  limited  resolution of sliders and considering the
	      wide range and distribution often found in site attribute  data,
	      a  rreessccaallee  button  is provided. Choosing rreessccaallee results in the
	      currently defined ranges becoming the new min and  max  and  the
	      sliders  being  reset to their left and right extremes, allowing
	      further refinement of the range.

	      To undo the rreessccaallee operation, the user may select rreesseett	ssccaalleess
	      which  resets  all  scales  to their startup values (loosing any
	      ranges already specified).

OOPPTTIIOONNSS
       This program can be run non-interactively or interactively. If the user
       gives  the  name of a GRASS site_lists map on the command line the pro-
       gram will be run non-interactively. Alternately, the user can type sim-
       ply  d.siter on the command line; in this case, the program will prompt
       the user for a site_lists map.

BBUUGGSS
       Due to pixel rounding, startup ranges for sliders may be  slightly  off
       for  floating  point  attributes. The slider min value will be slightly
       lower than the min value found in the file and  the  slider  max  value
       will be slightly higher.

SSEEEE AALLSSOO
       d.sites.qual, s.info

AAUUTTHHOORR
_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_3 _$



GRASS 5.0							    d.siter(1)
