@BeginModule
@NewPage
@Name      = Maggraph
@Title     = Line graph plot
@Section   = Magics
@Arguments = ifiles ofile
@Operators = graph

@BeginDescription
This operator generates line graph plots.
The data for the plot is read from @file{ifiles}. The result is written to @file{ofile}.
The default output file format is postscript, this can be changed with the device parameter.

Here is a list of all graph plot parameters:

@BeginTable
 @bold{Keyname}    & @bold{Type}    & @bold{Description}      
 device     & STRING  & Output device (ps, eps, pdf, png, gif, gif_animation, jpeg, svg, kml)
 ymin       & FLOAT   & Minimum value of the y-axis data 
 ymax       & FLOAT   & Maximum value of the y-axis data 
 stat       & STRING  & "TRUE" or "FALSE", to switch on the mean computation. Default is "FALSE".
            &         & Will be overridden to "FALSE", if input files have unequal number of time
            &         & steps or different start/end times. 
 sigma      & FLOAT   & Standard deviation value for generating shaded back ground around the mean value.
            &         & To be used in conjunction with 'stat="TRUE"' 
 obsv       & STRING  & To indicate if the input files have an observation data, by setting to "TRUE".
            &         & Default value is "FALSE". The observation data should be the first file in the
            &         & input file list. The observation data is always plotted in black colour. 
@EndTable
@EndDescription
@EndModule


@BeginOperator_graph
@Title     = Line graph plot
@Parameter = params
@EndOperator


@BeginParameter
@Item = params
STRING   Comma separated list of plot parameters
@EndParameter


@BeginExample
Graph plot of an atlantic MOC time series from 1965 to 1976:
@BeginVerbatim
  cdo graph amoc plot
@EndVerbatim
@IfDoc
\vspace{1mm}

\includegraphics[width=\textwidth]{maggraph.pdf}

\vspace{1mm}
@EndifDoc
@EndExample
