% @(#)plot_cont.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:49 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 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.
\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 one specifies 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, 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. 
\\
             For the DEANZA to pick up the coordinates, switch the cursors ON 
             and press ENTER. To exit, switch the cursors OFF and press ENTER.
\\
             For XWindows use the mouse to move the cursor, the leftmost
             mouse button or the RETURN key is the ENTER button, the
             second left mouse button serves as EXIT button.  The cursor cross
             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 fixing one of the two cursor corners (DEANZA) or
             by using the arrow keys on the keyboard (XWindows).
\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