2024-06-13 06:51:29 +00:00
|
|
|
---
|
|
|
|
slug: /en/sql-reference/aggregate-functions/reference/exponentialtimedecayedavg
|
|
|
|
sidebar_position: 108
|
|
|
|
sidebar_title: exponentialTimeDecayedAvg
|
|
|
|
---
|
|
|
|
|
|
|
|
## exponentialTimeDecayedAvg
|
|
|
|
|
2024-06-14 09:12:08 +00:00
|
|
|
Returns the exponentially smoothed weighted moving average of values of a time series at point `t` in time.
|
2024-06-13 06:51:29 +00:00
|
|
|
|
|
|
|
**Syntax**
|
|
|
|
|
|
|
|
```sql
|
2024-06-14 09:12:08 +00:00
|
|
|
exponentialTimeDecayedAvg(x)(v, t)
|
2024-06-13 06:51:29 +00:00
|
|
|
```
|
|
|
|
|
2024-06-13 16:11:12 +00:00
|
|
|
**Arguments**
|
|
|
|
|
2024-06-14 09:12:08 +00:00
|
|
|
- `v` — Value. [Integer](../../../sql-reference/data-types/int-uint.md), [Float](../../../sql-reference/data-types/float.md) or [Decimal](../../../sql-reference/data-types/decimal.md).
|
|
|
|
- `t` — Time. [Integer](../../../sql-reference/data-types/int-uint.md), [Float](../../../sql-reference/data-types/float.md) or [Decimal](../../../sql-reference/data-types/decimal.md), [DateTime](../../data-types/datetime.md), [DateTime64](../../data-types/datetime64.md).
|
2024-06-13 16:11:12 +00:00
|
|
|
|
|
|
|
**Parameters**
|
|
|
|
|
|
|
|
- `x` — Half-life period. [Integer](../../../sql-reference/data-types/int-uint.md), [Float](../../../sql-reference/data-types/float.md) or [Decimal](../../../sql-reference/data-types/decimal.md).
|
|
|
|
|
|
|
|
**Returned values**
|
|
|
|
|
2024-06-14 09:12:08 +00:00
|
|
|
- Returns an exponentially smoothed weighted moving average at index `t` in time. [Float64](../../data-types/float.md).
|
2024-06-13 16:11:12 +00:00
|
|
|
|
2024-06-13 06:51:29 +00:00
|
|
|
**Examples**
|
|
|
|
|
|
|
|
Query:
|
|
|
|
|
|
|
|
```sql
|
|
|
|
SELECT
|
|
|
|
value,
|
|
|
|
time,
|
|
|
|
round(exp_smooth, 3),
|
|
|
|
bar(exp_smooth, 0, 5, 50) AS bar
|
|
|
|
FROM
|
2024-06-14 09:12:08 +00:00
|
|
|
(
|
2024-06-13 06:51:29 +00:00
|
|
|
SELECT
|
2024-06-14 09:12:08 +00:00
|
|
|
(number = 0) OR (number >= 25) AS value,
|
|
|
|
number AS time,
|
|
|
|
exponentialTimeDecayedAvg(10)(value, time) OVER (ROWS BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW) AS exp_smooth
|
2024-06-13 06:51:29 +00:00
|
|
|
FROM numbers(50)
|
2024-06-14 09:12:08 +00:00
|
|
|
);
|
2024-06-13 06:51:29 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
Response:
|
|
|
|
|
|
|
|
```sql
|
|
|
|
┌─value─┬─time─┬─round(exp_smooth, 3)─┬─bar────────┐
|
2024-06-14 09:12:08 +00:00
|
|
|
1. │ 1 │ 0 │ 1 │ ██████████ │
|
|
|
|
2. │ 0 │ 1 │ 0.475 │ ████▊ │
|
|
|
|
3. │ 0 │ 2 │ 0.301 │ ███ │
|
|
|
|
4. │ 0 │ 3 │ 0.214 │ ██▏ │
|
|
|
|
5. │ 0 │ 4 │ 0.162 │ █▌ │
|
|
|
|
6. │ 0 │ 5 │ 0.128 │ █▎ │
|
|
|
|
7. │ 0 │ 6 │ 0.104 │ █ │
|
|
|
|
8. │ 0 │ 7 │ 0.086 │ ▊ │
|
|
|
|
9. │ 0 │ 8 │ 0.072 │ ▋ │
|
|
|
|
0. │ 0 │ 9 │ 0.061 │ ▌ │
|
|
|
|
1. │ 0 │ 10 │ 0.052 │ ▌ │
|
|
|
|
2. │ 0 │ 11 │ 0.045 │ ▍ │
|
|
|
|
3. │ 0 │ 12 │ 0.039 │ ▍ │
|
|
|
|
4. │ 0 │ 13 │ 0.034 │ ▎ │
|
|
|
|
5. │ 0 │ 14 │ 0.03 │ ▎ │
|
|
|
|
6. │ 0 │ 15 │ 0.027 │ ▎ │
|
|
|
|
7. │ 0 │ 16 │ 0.024 │ ▏ │
|
|
|
|
8. │ 0 │ 17 │ 0.021 │ ▏ │
|
|
|
|
9. │ 0 │ 18 │ 0.018 │ ▏ │
|
|
|
|
0. │ 0 │ 19 │ 0.016 │ ▏ │
|
|
|
|
1. │ 0 │ 20 │ 0.015 │ ▏ │
|
|
|
|
2. │ 0 │ 21 │ 0.013 │ ▏ │
|
|
|
|
3. │ 0 │ 22 │ 0.012 │ │
|
|
|
|
4. │ 0 │ 23 │ 0.01 │ │
|
|
|
|
5. │ 0 │ 24 │ 0.009 │ │
|
|
|
|
6. │ 1 │ 25 │ 0.111 │ █ │
|
|
|
|
7. │ 1 │ 26 │ 0.202 │ ██ │
|
|
|
|
8. │ 1 │ 27 │ 0.283 │ ██▊ │
|
|
|
|
9. │ 1 │ 28 │ 0.355 │ ███▌ │
|
|
|
|
0. │ 1 │ 29 │ 0.42 │ ████▏ │
|
|
|
|
1. │ 1 │ 30 │ 0.477 │ ████▊ │
|
|
|
|
2. │ 1 │ 31 │ 0.529 │ █████▎ │
|
|
|
|
3. │ 1 │ 32 │ 0.576 │ █████▊ │
|
|
|
|
4. │ 1 │ 33 │ 0.618 │ ██████▏ │
|
|
|
|
5. │ 1 │ 34 │ 0.655 │ ██████▌ │
|
|
|
|
6. │ 1 │ 35 │ 0.689 │ ██████▉ │
|
|
|
|
7. │ 1 │ 36 │ 0.719 │ ███████▏ │
|
|
|
|
8. │ 1 │ 37 │ 0.747 │ ███████▍ │
|
|
|
|
9. │ 1 │ 38 │ 0.771 │ ███████▋ │
|
|
|
|
0. │ 1 │ 39 │ 0.793 │ ███████▉ │
|
|
|
|
1. │ 1 │ 40 │ 0.813 │ ████████▏ │
|
|
|
|
2. │ 1 │ 41 │ 0.831 │ ████████▎ │
|
|
|
|
3. │ 1 │ 42 │ 0.848 │ ████████▍ │
|
|
|
|
4. │ 1 │ 43 │ 0.862 │ ████████▌ │
|
|
|
|
5. │ 1 │ 44 │ 0.876 │ ████████▊ │
|
|
|
|
6. │ 1 │ 45 │ 0.888 │ ████████▉ │
|
|
|
|
7. │ 1 │ 46 │ 0.898 │ ████████▉ │
|
|
|
|
8. │ 1 │ 47 │ 0.908 │ █████████ │
|
|
|
|
9. │ 1 │ 48 │ 0.917 │ █████████▏ │
|
|
|
|
0. │ 1 │ 49 │ 0.925 │ █████████▏ │
|
|
|
|
└───────┴──────┴──────────────────────┴────────────┘
|
2024-06-13 06:51:29 +00:00
|
|
|
```
|