X-Git-Url: https://git.octo.it/?a=blobdiff_plain;f=doc%2Frrdgraph_rpn.pod;h=16f7610f3d58abf1de276034437463cdc1b441c9;hb=765772ba1d71e8581f9e65c8c3579997bba5890e;hp=21661ba6f7138646909bb1f5e6a9ade92c7bd4c7;hpb=f9e62abf5664d61987e111e4f1f9388e506a10ff;p=rrdtool.git diff --git a/doc/rrdgraph_rpn.pod b/doc/rrdgraph_rpn.pod index 21661ba..16f7610 100644 --- a/doc/rrdgraph_rpn.pod +++ b/doc/rrdgraph_rpn.pod @@ -9,7 +9,8 @@ I:=I|I|I[,I] =head1 DESCRIPTION If you have ever used a traditional HP calculator you already know -B. The idea behind B is that you have a stack and push +B (Reverse Polish Notation). +The idea behind B is that you have a stack and push your data onto this stack. Whenever you execute an operation, it takes as many elements from the stack as needed. Pushing is done implicitly, so whenever you specify a number or a variable, it gets @@ -252,7 +253,7 @@ rrdtool graph image.png --imgformat=PNG \ TICK:exceeds#aa000080:1 Note: Experience has shown that a factor between 3 and 5 to scale sigma is a good -discriminator to detect abnormal behaviour. This obviously depends also on the type +discriminator to detect abnormal behavior. This obviously depends also on the type of data and how "noisy" the data series is. This prediction can only be used for short term extrapolations - say a few days into the future- @@ -351,18 +352,19 @@ Example: C =item TOTAL Returns the rate from each defined time slot multiplied with the -step size. This can, for instance, return total bytes transfered +step size. This can, for instance, return total bytes transferred when you have logged bytes per second. The time component returns the number of seconds. Example: C -=item PERCENT +=item PERCENT, PERCENTNAN This should follow a B or B I. The I is popped, another number is popped which is a certain percentage (0..100). The data set is then sorted and the value returned is chosen such that I percent of the values is lower or equal than the result. +For PERCENTNAN I values are ignored, but for PERCENT I values are considered lower than any finite number for this purpose so if this operator returns an I you have quite a lot of them in your data. Binite numbers are lesser, or more, than the @@ -370,6 +372,7 @@ finite numbers and are always more than the I numbers. (NaN E -INF E finite values E INF) Example: C + C =item LSLSLOPE, LSLINT, LSLCORREL @@ -398,4 +401,5 @@ Make sure to read L for tipsEtricks. Program by Tobias Oetiker Etobi@oetiker.chE -This manual page by Alex van den Bogaerdt Ealex@ergens.op.het.netE +This manual page by Alex van den Bogaerdt Ealex@vandenbogaerdt.nlE +with corrections and/or additions by several people