%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990-2006 European Southern Observatory
%.IDENT      plot_cont.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, PLOT/CONTOUR
%.PURPOSE    On-line help file for the command: PLOT/CONTOUR
%.VERSION    1.0  09-JUN-1987 : Creation, RHW
%----------------------------------------------------------------
\se
SECTION./CONT
\es\co
PLOT/CONTOUR                                              09-JUN-1987 RHW
\oc\su
PLOT/CONTOUR frame [coord_str] [x_sc,y_sc[,x_off,y_off]] [contours] [c_type]
             [sm_par]
	plot contour map of 2-dim. image with smoothing option
\us\pu
Purpose:     
             Plot contour map of 2-dim. image (with a smoothing option).
\up\sy
Syntax:      
             PLOT/CONTOUR frame [coord_str] [x_sc,y_sc[,x_off,y_off]] 
                          [contours] [c_type] [sm_par]
\ys\pa
             frame     = name of image file
\ap\pa
             coord_str = area to be plotted in standard MIDAS notation; see 
                         MIDAS Users Guide Chapter 3. Default is either the 
                         manual setting done by the SET/GRAPHICS command, or 
                         the whole area (see Note).
\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
             contours =  contour values; input can be given as cstart:cend:cincr
                         or cnt1,cnt2,cnt3 or any combination of these two 
                         possibilities separated by a comma.
\ap\pa
             c_type =    NEG, ODD, or LTYPE: determines the line type(s) used.
                         NEG will draw negative contours dashed and positive 
                         ones solid; ODD will draw odd contours dashed and even
                         ones solid; If LTYPE is specified contours will be 
                         drawn with the line type specified with SET/GRAPHICS.
                         Default is ODD
\ap\pa
             sm_par =    smoothing parameter i.e. the number of pixels "around"
                         the central pixel which define the neighbourhood of
                         that pixel. 
                         Total number of pixels is then: (2*sm_par + 1)**2 
                         Only integer numbers are allowed. Default is 0
\ap\no
Note:        
               The coordinates for the area are optional. If you specify a "?",
             and the manual frame setting(s) for the x- and y-axis are used
             these settings will be used; else the whole area will be taken. 
               If a "C" is given as param 2, the window is selected 
	     interactively on the display screen using the cursor facilities.
	     The cursor will be set on automatically, if it is not already.
             Use the mouse to move the cursor, the leftmost mouse button or the
             RETURN key is the ENTER button, the right mouse button serves as
             EXIT button.  The cursor cross/rectangle may not be visible at 
             first. Move the mouse to the lower left corner of the graphics 
             window to grab the cursor.
               The size of the plot area (area within the rectangular cursor) 
	     can be be changed by by using the arrow keys on the keyboard.
\on\see
See also:
             OVERPLOT/CONTOUR, SHOW/GRAPHICS, SET/GRAPHICS, PLOT/AXES, 
             PLOT/GRAY, OVERPLOT/GRAY, PLOT/VECTOR, OVERPLOT/VECTOR
\ees\exs
Examples:
\ex
             PLOT/CONTOUR spiral [@281,@281:@320,@320] ? 1:5:0.25,6,7,8 ? 1
               Plot a contour plot of the frame spiral.bdf with default scale;
               the contour are 1 to 5 in steps of .25 and the contours 
	       6, 7, and 8. A 3*3 box smooth is done on the data before the
	       plot is made. Use the default line type. 
\xe \sxe



