% @(#)overplaxes.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:46
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      overplaxes.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, OVERPLOT/AXES
%.PURPOSE    On-line help file for the command: OVERPLOT/AXES
%.VERSION    1.0  21-SEP-1990 : Creation, RHW
%----------------------------------------------------------------
\se
SECTION./AXES
\es\co
OVERPLOT/AXES                                                  21-SEP-1990  RHW
\oc\su
OVERPLOT/AXES [x_axis_spec] [y_axis_spec] [x_sc,y_sci[,x_off,y_off]] 
              [x_lab] [y_lab]
	overplot a coordinate box with tickmarks and labels
OVERPLOT/AXES [coord_str] [x_lab] [y_lab]
	overplot a coordinate box around a displayed frame 
\us\pu
Purpose:  
          Overplot a coordinate box with tickmarks and labels
\up\sy
Syntax:   
          OVERPLOT/AXES [x_axis_spec] [y_axis_spec] [x_sc,y_sc[,x_off,y_off]] 
                        [x_lab] [y_lab]
          OVERPLOT/AXES [coord_str] [x_lab] [y_lab]
\ys\pa
          x_axis_spec = x-axis specification: start value, end value, distance
                        between the big tickmarks, distance between the small
                        tickmarks. Default: use the manual setting (by the
                        SET/GRAPHICS command); if not present, use a linear 
                        axis from 0.0 to 1.0. The start value can be smaller 
                        than the end value.If distance between small tickmarks 
                        is less than 0, a logarithmic axis will be plotted,
                        running from 10**start_value to 10**end_value. At
                        least the start and end values should be given. If
                        large tickmark distance fails a (hopefully) sensible
                        default will be used. If small tickmark distance fails
                        no small tickmarks will be plotted.
\ap\pa
          y_axis_spec = specfication for the y-axis; see above.
\ap\pa
          coord_str =   area in the displayed frame in the standard MIDAS
                        notation. This option only works on workstations,
                        if the display window has been assigned as the plot
                        device and a frame has been loaded!
                        The default is a frame box around the whole frame.
\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
          x_lab =       label for the x-axis; default is no label
\ap\pa
          y_lab =       label for the y-axis; default is no label
\ap\no
Note:     
          The command can draw axes on all graphic output devices, including
          the display window in workstations. Depending on the assigned graphic
          device (with ASSIGN/GRAPHICS) the command decides in which mode it 
          will run.
\\
          In case the output graphics device is the graphics window, terminal
          or a hardcopy device the command will always run in the first mode.
\\
          If the assigned output graphics device is the display window AND if
          the first input parameter is given as a MIDAS coordinate string
          (i.e. starting with `[') the command will run in the second mode
          (see below) and will be drawn around the LOADED frame. However,
          with the display window assigned, if the first parameter is not
          a MIDAS coordinate string the command will run in the first mode.
          In the second mode, if (part of) the frame comes close to display
          window boundary part of the coordinate frame will fall outside the
          window. In that case one can either center the frame, or give a
          somewhat smaller area to draw the coordiates around.
\\
          After finishing, the coordinates of the axes are stored in the MIDAS
          keyword area, all previous axes settings are overwritten, and the
          user can use the `manual' plot mode. This command gives the same
          result as first setting the x- and y-axis manually (using 
          SET/GRAPHICS),
          followed by a PLOT/AXES command without specifying the x and y axes.
\on\see
See also: 
          ASSIGN/GRAPHICS, SET/GRAPHICS, SHOW/GRAPHICS, PLOT/AXES
\ees\exs
Examples:
\ex
          OVER/AXES 0,100,25,5 1,3,0,-1 -100,-100,50,25 "V_Hel" "Flux"
          Overplot a box with a linear scale in the x and a logarithmic one in
          the y direction; the size of the frame will be 100 times 100 mm.
          The box will be put 50 mm from the left border of the graphics and
          25 mm from the bottom.
\xe\ex
          LOAD/IMAGE spiral
          Load a frame
\xe\ex
          ASSIGN/GRAPHICS display
          Assign the display window to the graphics device
\xe\ex
          OVER/AXES [@10,@10:@210,@305] "Right Ascension" "Declination"
          Plot a coordinate frame around the displayed frame.
\xe \sxe