X-Git-Url: https://git.verplant.org/?a=blobdiff_plain;f=doc%2Frrdcreate.pod;h=37eacbeffb43840670ca6b3ee1250055590825f7;hb=bbe14939aca831605f56753b1b0023ff46cad7b7;hp=3689e2937aa09a158bebe6c20de60c4ca5cbfc4e;hpb=51fcea2cbf9721f012f2f0d43c604a3aaf684ee8;p=rrdtool.git diff --git a/doc/rrdcreate.pod b/doc/rrdcreate.pod index 3689e29..37eacbe 100644 --- a/doc/rrdcreate.pod +++ b/doc/rrdcreate.pod @@ -173,7 +173,35 @@ data point>. The data is also processed with the consolidation function (I) of the archive. There are several consolidation functions that consolidate primary data points via an aggregate function: B, -B, B, B. The format of B line for these +B, B, B. + +=over + +=item AVERAGE + +the average of the data points is stored. + +=item MIN + +the smallest of the data points is stored. + +=item MAX + +the largest of the data points is stored. + +=item LAST + +the last data points is used. + +=back + +Note that data aggregation inevitably leads to loss of precision and +information. The trick is to pick the aggregate function such that the +I properties of your data is kept across the aggregation +process. + + +The format of B line for these consolidation functions is: BIB<:>IB<:>IB<:>I @@ -210,11 +238,11 @@ BIB<:>IB<:>IB<:>IB<:>I[B<: =item * -BIB<:>IB<:>IB<:>I +BIB<:>IB<:>IB<:>I[B<:smoothing-window=>I] =item * -BIB<:>IB<:>IB<:>I +BIB<:>IB<:>IB<:>I[B<:smoothing-window=>I] =item * @@ -314,6 +342,13 @@ If SEASONAL and DEVSEASONAL B are created explicitly, I need not be the same for both. Note that I can also be changed via the B I command. +I specifies the fraction of a season that should be +averaged around each point. By default, the value of I is +0.05, which means each value in SEASONAL and DEVSEASONAL will be occasionally +replaced by averaging it with its (I*0.05) nearest neighbors. +Setting I to zero will disable the running-average smoother +altogether. + I provides the links between related B. If HWPREDICT is specified alone and the other B are created implicitly, then there is no need to worry about this argument. If B are created