%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1993-2010 European Southern Observatory
%.IDENT      plot_sele.hlq
%.AUTHOR     K. Banse, ESO - Garching
%.KEYWORDS   MIDAS, help files, PLOT/SELECTED
%.PURPOSE    On-line help file for the command: PLOT/SELECTED
%.VERSION    1.0  070807	creation
%----------------------------------------------------------------
\se
SECTION./SELE
\es\co
PLOT/SELECTED						17-AUG-2010  KB
\oc\su
PLOT/SELECTED table [column1] [column2] [x_sc,y_sc[,x_off,y_off]] 
        [symbol_type] [line_type] [select_color]
	plot table columns using different color for selected elements
\us\pu
Purpose:    
            Plot table columns using different color for selected elements.
\up\sy
Syntax:     
            PLOT/SELECTED table column1 column2 [x_sc,y_sc[,x_off,y_off]]
                             [symbol_type] [line_type] [colors]
\ys\pa
            table = name of table file
\ap\pa
            column1 = vector in abscissa (x-axis)
\ap\pa
            column2 = vector in ordinate (y-axis)
\ap\pa
            x_sc,y_sc,x_off,y_off = scale or size in the x- and y-direction,
                  offset in the x- and y-direction. 
		  For the scaling x_sc and y_sc, positive numbers are 
		  interpreted as scale parameters (world units/mm), 
		  negative numbers as size parameters 
		  (axis will be made *_sc mm. long).
                  A combination of a positive and negative number is
                  allowed. By default the plot fills the device area.
                  x_off and y_off determine the distance of the lower
                  left corner of the plot to the lower left corner of the
                  graphic device, measured in mm. 
		  By default, the plot is put at the top left of the graphic
		  device, allowing space for the various labels.
\ap\pa
            symbol_type = symbol type to be used in the plot;
		  default is the symbol type set by SET/GRAPHICS
\ap\pa
            line_type = line type to be used in the plot;
		  default is the line type set by SET/GRAPHICS
\ap\pa
            colors = select_color[,not_select_color] to be used for selected 
		  and not selected elements, as string:
		  background, black, red, green, blue, yellow, magenta, 
		  cyan, or white;
		  if not_select color not given, the current default color 
		  will be taken for that; select_color is defaulted to red
\ap\no
Note:
               The PLOT/SELECTED command plots ALL elements of a given column
	    using the color specified by a previous SET/GRAPH command, and
	    uses "select_color" for all selected elements of the column.
               The functions LOG and LN, decimal and natural logs
            respectively, can be applied to the data to be plotted.
               Be aware that in case you plan to connect the data points with 
            a line (see SET/GRAPHICS) the data points will be connected in the
            same order as they appear in the table. In order to sort the data
            first (either in decreasing or increasing order) use the sorting
            command SORT/TABLE.
\on\see
See also:   
            PLOT/TABLE, SET/GRAPHICS, SHOW/GRAPHICS, LOAD/TABLE
\ees\exs
Examples:
\ex
            PLOT/SELE fea seq #7
              Plot column 7 in table `fea.tbl' against sequence number.
	      Use red color for all selected elements in column 7.
\xe\ex
            PLOT/SELE mugre :MAGNITUDE LOG(:TEMPERATURE) p7=BLUE
              Plot column :MAGNITUDE versus the logarithmic value of column 
              :TEMPERATURE (base 10) of table `mugre.tbl'; 
	      all selected elements of column :TEMPERATURE are plotted
	      in blue.
\xe\ex
            PLOT/SELE mugre :MAGNITUDE LOG(:TEMPERATURE) p7=BLUE,red
	      As above but all non-selected elements will be drawn in red.
\xe \sxe
