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 crite-
       ria 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 containing the sub-
       set
       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 com-
       mand
       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 interactively. 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-inter-
       actively;
       any parameter values left unspecified are set to their  default	values
       (see
       below). Alternately, the user can type simply  dd..ssiitteess..qquuaall on the com-
       mand
       line; in this case, the program will prompt the user for parameter val-
       ues
       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)
