d.sites.qual(1)        Grass User's Manual	  d.sites.qual(1)



NNAAMMEE
       _d_._s_i_t_e_s_._q_u_a_l  - Displays a subset 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..ssiitteess..qquuaall

       dd..ssiitteess..qquuaall hheellpp

       dd..ssiitteess..qquuaall [[--nn]] ssiitteeffiillee=_n_a_m_e [ccoolloorr=_n_a_m_e]  [ssiizzee=_v_a_l_u_e]
       [ttyyppee=_n_a_m_e] [rruulleess=_n_a_m_e[,_n_a_m_e,...]]  [oouuttppuutt=_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _d_._s_i_t_e_s_._q_u_a_l displays sites from a sites file only if they
       match criteria established by rruulleess.

       Syntax of rule string is:

       where D, C, or A specify Dimension, Category, or Attribute
       and RANGE is
       one of:

       examples:

		DD33..110000--220000	_d_i_m_e_n_s_i_o_n _3 _i_n _r_a_n_g_e _1_0_0 _t_o _2_0_0
		CC..eeqq77..22 	 _c_a_t_e_g_o_r_y _e_q_u_a_l _7_._2 _(_n_o_t_e _n_o _n_u_m_-
	      _b_e_r _a_f_t_e_r _C_)
		AA22..ggee55000000	_2_n_d _d_o_u_b_l_e _a_t_t_r_i_b_u_t_e _>_= _5_0_0_0
		AA11..--22..00----11..00	_1_s_t  _d_o_u_b_l_e  _a_t_t_r_i_b_u_t_e	_i_n  _r_a_n_g_e
	      _-_2_._0 _t_o _-_1_._0
       If  an  output filename is provided, a new sites file con-
       taining the subset
       defined by the command  will  be  written  in  the  user's
       mapset. Header information
       will  be  copied  from  the  original  sites  file and the
       d.sites.qual command
       and current window will be written as comments to the  new
       file. Note that
       only  those qualifying sites within the current window are
       written to the
       new file. The --nn flag is useful when calling  d.sites.qual
       from a
       script, as the number of qualifying sites may be needed to
       further process
       the file or report to the user  in  an  interface,  as  in
       d.siter.


OOPPTTIIOONNSS
       This  program  can  be  run  non-interactively or interac-
       tively. If the user
       gives the name of a GRASS site_lists map and  (optionally)
       specifies other
       parameter  values  on the command line the program will be
       run non-interactively;
       any parameter values left unspecified  are  set	to  their
       default values (see
       below).	  Alternately,	 the   user   can   type   simply
       dd..ssiitteess..qquuaall on the command
       line; in this case, the program will prompt the	user  for
       parameter values
       using the standard GRASS parser interface described in the
       manual entry
       for parser.


       FFllaaggss


       --nn

       Output number of sites displayed



       PPaarraammeetteerrss


       ssiitteeffiillee

       Name of a site file

       ccoolloorr

       Sets the current color to that stated:

       options: red, orange, yellow, green, blue, indigo,  white,
       black, brown,
       magenta, aqua, gray, grey

       default: gray



       ssiizzee

       Size, in pixels, in which the icon is to be drawn

       options: 0-1000

       default: 5


       ttyyppee

       Specify the type of the icon

       options: x, diamond, box, +

       default: x



       rruulleess

       qualifying rules for display: [D|C|A]#.RANGE

       where RANGE is one of #-#, ge#, le#, eq#



       oouuttppuutt

       Name of a site file to output drawn sites


SSEEEE AALLSSOO
       d.siter


AAUUTTHHOORR
       Bill Brown, UI GMS 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_3 _$



GRASS 5.0					  d.sites.qual(1)
