summaryrefslogtreecommitdiffstats
path: root/libnetdata/statistical
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-07-24 09:54:23 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-07-24 09:54:44 +0000
commit836b47cb7e99a977c5a23b059ca1d0b5065d310e (patch)
tree1604da8f482d02effa033c94a84be42bc0c848c3 /libnetdata/statistical
parentReleasing debian version 1.44.3-2. (diff)
downloadnetdata-836b47cb7e99a977c5a23b059ca1d0b5065d310e.tar.xz
netdata-836b47cb7e99a977c5a23b059ca1d0b5065d310e.zip
Merging upstream version 1.46.3.
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'libnetdata/statistical')
-rw-r--r--libnetdata/statistical/Makefile.am8
-rw-r--r--libnetdata/statistical/README.md12
-rw-r--r--libnetdata/statistical/statistical.c460
-rw-r--r--libnetdata/statistical/statistical.h34
4 files changed, 0 insertions, 514 deletions
diff --git a/libnetdata/statistical/Makefile.am b/libnetdata/statistical/Makefile.am
deleted file mode 100644
index 161784b8f..000000000
--- a/libnetdata/statistical/Makefile.am
+++ /dev/null
@@ -1,8 +0,0 @@
-# SPDX-License-Identifier: GPL-3.0-or-later
-
-AUTOMAKE_OPTIONS = subdir-objects
-MAINTAINERCLEANFILES = $(srcdir)/Makefile.in
-
-dist_noinst_DATA = \
- README.md \
- $(NULL)
diff --git a/libnetdata/statistical/README.md b/libnetdata/statistical/README.md
deleted file mode 100644
index 937c26ac6..000000000
--- a/libnetdata/statistical/README.md
+++ /dev/null
@@ -1,12 +0,0 @@
-<!--
-title: "Statistical functions"
-custom_edit_url: https://github.com/netdata/netdata/edit/master/libnetdata/statistical/README.md
-sidebar_label: "Statistical functions"
-learn_status: "Published"
-learn_topic_type: "Tasks"
-learn_rel_path: "Developers/libnetdata"
--->
-
-# Statistical functions
-
-A library for easy and fast calculations of statistical measurements like average, median etc.
diff --git a/libnetdata/statistical/statistical.c b/libnetdata/statistical/statistical.c
deleted file mode 100644
index ef9fe4e56..000000000
--- a/libnetdata/statistical/statistical.c
+++ /dev/null
@@ -1,460 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-#include "../libnetdata.h"
-
-NETDATA_DOUBLE default_single_exponential_smoothing_alpha = 0.1;
-
-void log_series_to_stderr(NETDATA_DOUBLE *series, size_t entries, NETDATA_DOUBLE result, const char *msg) {
- const NETDATA_DOUBLE *value, *end = &series[entries];
-
- fprintf(stderr, "%s of %zu entries [ ", msg, entries);
- for(value = series; value < end ;value++) {
- if(value != series) fprintf(stderr, ", ");
- fprintf(stderr, "%" NETDATA_DOUBLE_MODIFIER, *value);
- }
- fprintf(stderr, " ] results in " NETDATA_DOUBLE_FORMAT "\n", result);
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-inline NETDATA_DOUBLE sum_and_count(const NETDATA_DOUBLE *series, size_t entries, size_t *count) {
- const NETDATA_DOUBLE *value, *end = &series[entries];
- NETDATA_DOUBLE sum = 0;
- size_t c = 0;
-
- for(value = series; value < end ; value++) {
- if(netdata_double_isnumber(*value)) {
- sum += *value;
- c++;
- }
- }
-
- if(unlikely(!c)) sum = NAN;
- if(likely(count)) *count = c;
-
- return sum;
-}
-
-inline NETDATA_DOUBLE sum(const NETDATA_DOUBLE *series, size_t entries) {
- return sum_and_count(series, entries, NULL);
-}
-
-inline NETDATA_DOUBLE average(const NETDATA_DOUBLE *series, size_t entries) {
- size_t count = 0;
- NETDATA_DOUBLE sum = sum_and_count(series, entries, &count);
-
- if(unlikely(!count)) return NAN;
- return sum / (NETDATA_DOUBLE)count;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-NETDATA_DOUBLE moving_average(const NETDATA_DOUBLE *series, size_t entries, size_t period) {
- if(unlikely(period <= 0))
- return 0.0;
-
- size_t i, count;
- NETDATA_DOUBLE sum = 0, avg = 0;
- NETDATA_DOUBLE p[period];
-
- for(count = 0; count < period ; count++)
- p[count] = 0.0;
-
- for(i = 0, count = 0; i < entries; i++) {
- NETDATA_DOUBLE value = series[i];
- if(unlikely(!netdata_double_isnumber(value))) continue;
-
- if(unlikely(count < period)) {
- sum += value;
- avg = (count == period - 1) ? sum / (NETDATA_DOUBLE)period : 0;
- }
- else {
- sum = sum - p[count % period] + value;
- avg = sum / (NETDATA_DOUBLE)period;
- }
-
- p[count % period] = value;
- count++;
- }
-
- return avg;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-static int qsort_compare(const void *a, const void *b) {
- NETDATA_DOUBLE *p1 = (NETDATA_DOUBLE *)a, *p2 = (NETDATA_DOUBLE *)b;
- NETDATA_DOUBLE n1 = *p1, n2 = *p2;
-
- if(unlikely(isnan(n1) || isnan(n2))) {
- if(isnan(n1) && !isnan(n2)) return -1;
- if(!isnan(n1) && isnan(n2)) return 1;
- return 0;
- }
- if(unlikely(isinf(n1) || isinf(n2))) {
- if(!isinf(n1) && isinf(n2)) return -1;
- if(isinf(n1) && !isinf(n2)) return 1;
- return 0;
- }
-
- if(unlikely(n1 < n2)) return -1;
- if(unlikely(n1 > n2)) return 1;
- return 0;
-}
-
-inline void sort_series(NETDATA_DOUBLE *series, size_t entries) {
- qsort(series, entries, sizeof(NETDATA_DOUBLE), qsort_compare);
-}
-
-inline NETDATA_DOUBLE *copy_series(const NETDATA_DOUBLE *series, size_t entries) {
- NETDATA_DOUBLE *copy = mallocz(sizeof(NETDATA_DOUBLE) * entries);
- memcpy(copy, series, sizeof(NETDATA_DOUBLE) * entries);
- return copy;
-}
-
-NETDATA_DOUBLE median_on_sorted_series(const NETDATA_DOUBLE *series, size_t entries) {
- if(unlikely(entries == 0)) return NAN;
- if(unlikely(entries == 1)) return series[0];
- if(unlikely(entries == 2)) return (series[0] + series[1]) / 2;
-
- NETDATA_DOUBLE average;
- if(entries % 2 == 0) {
- size_t m = entries / 2;
- average = (series[m] + series[m + 1]) / 2;
- }
- else {
- average = series[entries / 2];
- }
-
- return average;
-}
-
-NETDATA_DOUBLE median(const NETDATA_DOUBLE *series, size_t entries) {
- if(unlikely(entries == 0)) return NAN;
- if(unlikely(entries == 1)) return series[0];
-
- if(unlikely(entries == 2))
- return (series[0] + series[1]) / 2;
-
- NETDATA_DOUBLE *copy = copy_series(series, entries);
- sort_series(copy, entries);
-
- NETDATA_DOUBLE avg = median_on_sorted_series(copy, entries);
-
- freez(copy);
- return avg;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-NETDATA_DOUBLE moving_median(const NETDATA_DOUBLE *series, size_t entries, size_t period) {
- if(entries <= period)
- return median(series, entries);
-
- NETDATA_DOUBLE *data = copy_series(series, entries);
-
- size_t i;
- for(i = period; i < entries; i++) {
- data[i - period] = median(&series[i - period], period);
- }
-
- NETDATA_DOUBLE avg = median(data, entries - period);
- freez(data);
- return avg;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-// http://stackoverflow.com/a/15150143/4525767
-NETDATA_DOUBLE running_median_estimate(const NETDATA_DOUBLE *series, size_t entries) {
- NETDATA_DOUBLE median = 0.0f;
- NETDATA_DOUBLE average = 0.0f;
- size_t i;
-
- for(i = 0; i < entries ; i++) {
- NETDATA_DOUBLE value = series[i];
- if(unlikely(!netdata_double_isnumber(value))) continue;
-
- average += ( value - average ) * 0.1f; // rough running average.
- median += copysignndd( average * 0.01, value - median );
- }
-
- return median;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-NETDATA_DOUBLE standard_deviation(const NETDATA_DOUBLE *series, size_t entries) {
- if(unlikely(entries == 0)) return NAN;
- if(unlikely(entries == 1)) return series[0];
-
- const NETDATA_DOUBLE *value, *end = &series[entries];
- size_t count;
- NETDATA_DOUBLE sum;
-
- for(count = 0, sum = 0, value = series ; value < end ;value++) {
- if(likely(netdata_double_isnumber(*value))) {
- count++;
- sum += *value;
- }
- }
-
- if(unlikely(count == 0)) return NAN;
- if(unlikely(count == 1)) return sum;
-
- NETDATA_DOUBLE average = sum / (NETDATA_DOUBLE)count;
-
- for(count = 0, sum = 0, value = series ; value < end ;value++) {
- if(netdata_double_isnumber(*value)) {
- count++;
- sum += powndd(*value - average, 2);
- }
- }
-
- if(unlikely(count == 0)) return NAN;
- if(unlikely(count == 1)) return average;
-
- NETDATA_DOUBLE variance = sum / (NETDATA_DOUBLE)(count); // remove -1 from count to have a population stddev
- NETDATA_DOUBLE stddev = sqrtndd(variance);
- return stddev;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-NETDATA_DOUBLE single_exponential_smoothing(const NETDATA_DOUBLE *series, size_t entries, NETDATA_DOUBLE alpha) {
- if(unlikely(entries == 0))
- return NAN;
-
- if(unlikely(isnan(alpha)))
- alpha = default_single_exponential_smoothing_alpha;
-
- const NETDATA_DOUBLE *value = series, *end = &series[entries];
- NETDATA_DOUBLE level = (1.0 - alpha) * (*value);
-
- for(value++ ; value < end; value++) {
- if(likely(netdata_double_isnumber(*value)))
- level = alpha * (*value) + (1.0 - alpha) * level;
- }
-
- return level;
-}
-
-NETDATA_DOUBLE single_exponential_smoothing_reverse(const NETDATA_DOUBLE *series, size_t entries, NETDATA_DOUBLE alpha) {
- if(unlikely(entries == 0))
- return NAN;
-
- if(unlikely(isnan(alpha)))
- alpha = default_single_exponential_smoothing_alpha;
-
- const NETDATA_DOUBLE *value = &series[entries -1];
- NETDATA_DOUBLE level = (1.0 - alpha) * (*value);
-
- for(value++ ; value >= series; value--) {
- if(likely(netdata_double_isnumber(*value)))
- level = alpha * (*value) + (1.0 - alpha) * level;
- }
-
- return level;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-// http://grisha.org/blog/2016/02/16/triple-exponential-smoothing-forecasting-part-ii/
-NETDATA_DOUBLE double_exponential_smoothing(const NETDATA_DOUBLE *series, size_t entries,
- NETDATA_DOUBLE alpha,
- NETDATA_DOUBLE beta,
- NETDATA_DOUBLE *forecast) {
- if(unlikely(entries == 0))
- return NAN;
-
- NETDATA_DOUBLE level, trend;
-
- if(unlikely(isnan(alpha)))
- alpha = 0.3;
-
- if(unlikely(isnan(beta)))
- beta = 0.05;
-
- level = series[0];
-
- if(likely(entries > 1))
- trend = series[1] - series[0];
- else
- trend = 0;
-
- const NETDATA_DOUBLE *value = series;
- for(value++ ; value >= series; value--) {
- if(likely(netdata_double_isnumber(*value))) {
- NETDATA_DOUBLE last_level = level;
- level = alpha * *value + (1.0 - alpha) * (level + trend);
- trend = beta * (level - last_level) + (1.0 - beta) * trend;
-
- }
- }
-
- if(forecast)
- *forecast = level + trend;
-
- return level;
-}
-
-// --------------------------------------------------------------------------------------------------------------------
-
-/*
- * Based on th R implementation
- *
- * a: level component
- * b: trend component
- * s: seasonal component
- *
- * Additive:
- *
- * Yhat[t+h] = a[t] + h * b[t] + s[t + 1 + (h - 1) mod p],
- * a[t] = α (Y[t] - s[t-p]) + (1-α) (a[t-1] + b[t-1])
- * b[t] = β (a[t] - a[t-1]) + (1-β) b[t-1]
- * s[t] = γ (Y[t] - a[t]) + (1-γ) s[t-p]
- *
- * Multiplicative:
- *
- * Yhat[t+h] = (a[t] + h * b[t]) * s[t + 1 + (h - 1) mod p],
- * a[t] = α (Y[t] / s[t-p]) + (1-α) (a[t-1] + b[t-1])
- * b[t] = β (a[t] - a[t-1]) + (1-β) b[t-1]
- * s[t] = γ (Y[t] / a[t]) + (1-γ) s[t-p]
- */
-static int __HoltWinters(
- const NETDATA_DOUBLE *series,
- int entries, // start_time + h
-
- NETDATA_DOUBLE alpha, // alpha parameter of Holt-Winters Filter.
- NETDATA_DOUBLE
- beta, // beta parameter of Holt-Winters Filter. If set to 0, the function will do exponential smoothing.
- NETDATA_DOUBLE
- gamma, // gamma parameter used for the seasonal component. If set to 0, an non-seasonal model is fitted.
-
- const int *seasonal,
- const int *period,
- const NETDATA_DOUBLE *a, // Start value for level (a[0]).
- const NETDATA_DOUBLE *b, // Start value for trend (b[0]).
- NETDATA_DOUBLE *s, // Vector of start values for the seasonal component (s_1[0] ... s_p[0])
-
- /* return values */
- NETDATA_DOUBLE *SSE, // The final sum of squared errors achieved in optimizing
- NETDATA_DOUBLE *level, // Estimated values for the level component (size entries - t + 2)
- NETDATA_DOUBLE *trend, // Estimated values for the trend component (size entries - t + 2)
- NETDATA_DOUBLE *season // Estimated values for the seasonal component (size entries - t + 2)
-)
-{
- if(unlikely(entries < 4))
- return 0;
-
- int start_time = 2;
-
- NETDATA_DOUBLE res = 0, xhat = 0, stmp = 0;
- int i, i0, s0;
-
- /* copy start values to the beginning of the vectors */
- level[0] = *a;
- if(beta > 0) trend[0] = *b;
- if(gamma > 0) memcpy(season, s, *period * sizeof(NETDATA_DOUBLE));
-
- for(i = start_time - 1; i < entries; i++) {
- /* indices for period i */
- i0 = i - start_time + 2;
- s0 = i0 + *period - 1;
-
- /* forecast *for* period i */
- xhat = level[i0 - 1] + (beta > 0 ? trend[i0 - 1] : 0);
- stmp = gamma > 0 ? season[s0 - *period] : (*seasonal != 1);
- if (*seasonal == 1)
- xhat += stmp;
- else
- xhat *= stmp;
-
- /* Sum of Squared Errors */
- res = series[i] - xhat;
- *SSE += res * res;
-
- /* estimate of level *in* period i */
- if (*seasonal == 1)
- level[i0] = alpha * (series[i] - stmp)
- + (1 - alpha) * (level[i0 - 1] + trend[i0 - 1]);
- else
- level[i0] = alpha * (series[i] / stmp)
- + (1 - alpha) * (level[i0 - 1] + trend[i0 - 1]);
-
- /* estimate of trend *in* period i */
- if (beta > 0)
- trend[i0] = beta * (level[i0] - level[i0 - 1])
- + (1 - beta) * trend[i0 - 1];
-
- /* estimate of seasonal component *in* period i */
- if (gamma > 0) {
- if (*seasonal == 1)
- season[s0] = gamma * (series[i] - level[i0])
- + (1 - gamma) * stmp;
- else
- season[s0] = gamma * (series[i] / level[i0])
- + (1 - gamma) * stmp;
- }
- }
-
- return 1;
-}
-
-NETDATA_DOUBLE holtwinters(const NETDATA_DOUBLE *series, size_t entries,
- NETDATA_DOUBLE alpha,
- NETDATA_DOUBLE beta,
- NETDATA_DOUBLE gamma,
- NETDATA_DOUBLE *forecast) {
- if(unlikely(isnan(alpha)))
- alpha = 0.3;
-
- if(unlikely(isnan(beta)))
- beta = 0.05;
-
- if(unlikely(isnan(gamma)))
- gamma = 0;
-
- int seasonal = 0;
- int period = 0;
- NETDATA_DOUBLE a0 = series[0];
- NETDATA_DOUBLE b0 = 0;
- NETDATA_DOUBLE s[] = {};
-
- NETDATA_DOUBLE errors = 0.0;
- size_t nb_computations = entries;
- NETDATA_DOUBLE *estimated_level = callocz(nb_computations, sizeof(NETDATA_DOUBLE));
- NETDATA_DOUBLE *estimated_trend = callocz(nb_computations, sizeof(NETDATA_DOUBLE));
- NETDATA_DOUBLE *estimated_season = callocz(nb_computations, sizeof(NETDATA_DOUBLE));
-
- int ret = __HoltWinters(
- series,
- (int)entries,
- alpha,
- beta,
- gamma,
- &seasonal,
- &period,
- &a0,
- &b0,
- s,
- &errors,
- estimated_level,
- estimated_trend,
- estimated_season
- );
-
- NETDATA_DOUBLE value = estimated_level[nb_computations - 1];
-
- if(forecast)
- *forecast = 0.0;
-
- freez(estimated_level);
- freez(estimated_trend);
- freez(estimated_season);
-
- if(!ret)
- return 0.0;
-
- return value;
-}
diff --git a/libnetdata/statistical/statistical.h b/libnetdata/statistical/statistical.h
deleted file mode 100644
index f3ecfadb4..000000000
--- a/libnetdata/statistical/statistical.h
+++ /dev/null
@@ -1,34 +0,0 @@
-// SPDX-License-Identifier: GPL-3.0-or-later
-
-#ifndef NETDATA_STATISTICAL_H
-#define NETDATA_STATISTICAL_H 1
-
-#include "../libnetdata.h"
-
-void log_series_to_stderr(NETDATA_DOUBLE *series, size_t entries, NETDATA_DOUBLE result, const char *msg);
-
-NETDATA_DOUBLE average(const NETDATA_DOUBLE *series, size_t entries);
-NETDATA_DOUBLE moving_average(const NETDATA_DOUBLE *series, size_t entries, size_t period);
-NETDATA_DOUBLE median(const NETDATA_DOUBLE *series, size_t entries);
-NETDATA_DOUBLE moving_median(const NETDATA_DOUBLE *series, size_t entries, size_t period);
-NETDATA_DOUBLE running_median_estimate(const NETDATA_DOUBLE *series, size_t entries);
-NETDATA_DOUBLE standard_deviation(const NETDATA_DOUBLE *series, size_t entries);
-NETDATA_DOUBLE single_exponential_smoothing(const NETDATA_DOUBLE *series, size_t entries, NETDATA_DOUBLE alpha);
-extern NETDATA_DOUBLE
-single_exponential_smoothing_reverse(const NETDATA_DOUBLE *series, size_t entries, NETDATA_DOUBLE alpha);
-NETDATA_DOUBLE double_exponential_smoothing(const NETDATA_DOUBLE *series, size_t entries,
- NETDATA_DOUBLE alpha,
- NETDATA_DOUBLE beta,
- NETDATA_DOUBLE *forecast);
-NETDATA_DOUBLE holtwinters(const NETDATA_DOUBLE *series, size_t entries,
- NETDATA_DOUBLE alpha,
- NETDATA_DOUBLE beta,
- NETDATA_DOUBLE gamma,
- NETDATA_DOUBLE *forecast);
-NETDATA_DOUBLE sum_and_count(const NETDATA_DOUBLE *series, size_t entries, size_t *count);
-NETDATA_DOUBLE sum(const NETDATA_DOUBLE *series, size_t entries);
-NETDATA_DOUBLE median_on_sorted_series(const NETDATA_DOUBLE *series, size_t entries);
-NETDATA_DOUBLE *copy_series(const NETDATA_DOUBLE *series, size_t entries);
-void sort_series(NETDATA_DOUBLE *series, size_t entries);
-
-#endif //NETDATA_STATISTICAL_H