% @(#)overplerro.hlq	17.1.1.1 (ESO-IPG) 01/25/02 17:43:47 
%++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
%.COPYRIGHT  (c)  1990 European Southern Observatory
%.IDENT      overplerro.hlq
%.AUTHOR     RHW, IPG/ESO
%.KEYWORDS   MIDAS, help files, OVERPLOT/ERROR
%.PURPOSE    On-line help file for the command: OVERPLOT/ERROR
%.VERSION    1.0  3-DEC-1986 : Creation, RHW
%----------------------------------------------------------------
\se
SECTION./ERRO
\es\co
OVERPLOT/ERROR                                                   3-DEC-1986  RHW
\oc\su
OVERPLOT/ERROR table [col1] [col2] col3 [direct] [bar]
	overplot table error column
\us\pu
Purpose:    
            Overplot a table error column
\up\sub
Subject:    
            Graphics, tables, errors
\bus\sy
Syntax:     
            OVERPLOT/ERROR table [col1] [col2] col3 [direct] [bar]
\ys\pa
            table  = name of table file
\ap\pa
            col1   = column in abscissa (x-axis); default is sequence 
                     number, however see the note below.
\ap\pa
            col2   = column in ordinate (y-axis); default is sequence
                     number, however see the note below.
\ap\pa
            col3   = error column for either the x or y values
\ap\pa
            direct = direction of the error bar to be plotted (default 6).
                     The error bars are drawn in the direction (K-1) * 90 deg.,
                     where K is the input parameter for "direct". In addition,
                     direct = 5 will plot error bars at both sides of the data
                     points in the x-directon; direct = 6 does the same in the
                     y-direction and which the default.
\ap\pa
            bar =    option to draw or to avoid the small cross bar at the end
                     of the error bar. Default is `Y': small ending bar will be
                     drawn.
\ap\no
Note:     
            Only one of the column input parameters can be defaulted to
            sequence number. So, `table \#1 ?' and `table ? \#2' are both
            valid input parameter strings, `table ? ?' is not.
\\
            When the user gives a `?' for one of the first two columns the 
            values the corresponding coordinate will be assumed to be the
            sequence number of the row.  At least one column should be given, 
            either as the first or the second parameter.
\\
            The functions LOG and LN, decimal and natural logs
            respectively, can be applied to the columns to be plotted.
\on\see
See also:   
            PLOT/TABLE, OVERPLOT/TABLE, SET/GRAPHICS, ASSIGN/GRAPHICS
\ees\exs
Examples:
\ex
            PLOT/TABLE MYTABLE :MAG LOG(:TEMP) :TEMPER1 1
            plot two columns of table MYTABLE
\xe\ex
            OVERPLOT/ERROR MYTABLE :MAG LOG(:TEMP) :TEMPER2 3
            overplot error bar left from data point
\xe\ex
            OVERPLOT/ERROR GALAXY :MHI_L ? :ERROR 6
            gives the same result as
\xe\ex
            OVERPLOT/ERROR GALAXY :MHI_L ? :ERROR
\xe \sxe