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  inter-
       face  there  are two sliders for each dimension, 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 corresponding 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  pro-
	      gram d.sites.qual is called with rules derived from
	      the current state of the interface and  the  speci-
	      fied  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 inconsistant 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 con-
	      sidering 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  speci-
	      fied).

OOPPTTIIOONNSS
       This  program  can  be  run  non-interactively or interac-
       tively. If the user gives the name of a	GRASS  site_lists
       map on the command line the program will be run non-inter-
       actively. Alternately, the user can type simply 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)
