@BeginModule
@NewPage
@Name      = Daystat
@Title     = Daily statistical values
@Section   = Statistical values
@Class     = Statistic
@Arguments = infile outfile
@Operators = daymin daymax dayrange daysum daymean dayavg daystd daystd1 dayvar dayvar1

@BeginDescription
This module computes statistical values over timesteps of the same day.
Depending on the chosen operator the minimum, maximum, range, sum, average, variance
or standard deviation of timesteps of the same day is written to @file{outfile}.
The time of @file{outfile} is determined by the time in the middle of all contributing timesteps of @file{infile}.
@EndDescription
@EndModule


@BeginOperator_daymin
@Title     = Daily minimum

@BeginDescription
@IfMan
For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = min{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{min}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_daymax
@Title     = Daily maximum

@BeginDescription
@IfMan
For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = max{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{max}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_dayrange
@Title     = Daily range

@BeginDescription
@IfMan
For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = range{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{range}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_daysum
@Title     = Daily sum

@BeginDescription
@IfMan
For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = sum{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{sum}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_daymean
@Title     = Daily mean

@BeginDescription
@IfMan
For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = mean{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{mean}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_dayavg
@Title     = Daily average

@BeginDescription
@IfMan
For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = avg{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{avg}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_dayvar
@Title     = Daily variance

@BeginDescription
@IfMan
Normalize by n. For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = var{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
Normalize by n. For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{var}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_dayvar1
@Title     = Daily variance (n-1)

@BeginDescription
@IfMan
Normalize by (n-1). For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = var1{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
Normalize by (n-1). For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{var1}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_daystd
@Title     = Daily standard deviation

@BeginDescription
@IfMan
Normalize by n. For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = std{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
Normalize by n. For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{std}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginOperator_daystd1
@Title     = Daily standard deviation (n-1)

@BeginDescription
@IfMan
Normalize by (n-1). For every adjacent sequence t_1, ...,t_n of timesteps of the same day it is:

o(t,x) = std1{i(t',x), t_1<t'<=t_n}
@EndifMan
@IfDoc
Normalize by (n-1). For every adjacent sequence \begin{math}t_1, ...,t_n\end{math} of timesteps of the same day it is: \\
@BeginMath
o(t,x) = \mbox{\textbf{std1}}\{i(t',x), t_1 < t' \leq t_n\}
@EndMath
@EndifDoc
@EndDescription
@EndOperator


@BeginExample
To compute the daily mean of a time series use:
@BeginVerbatim
   cdo daymean infile outfile
@EndVerbatim
@EndExample