foundryts.functions.value_shift

foundryts.functions.value_shift(delta)

単一の時系列のすべての値を、指定された delta だけシフトする関数を返します。

点 (timestamp, value) を持つソース時系列を delta だけシフトすると、 シフト後の時系列は点 (timestamp, value + delta) を持ちます。

• パラメーター： delta (int) – 各点の値をシフトする量です。
• 戻り値： 単一の時系列を入力として受け取り、値をシフトした時系列を返す関数です。
• 戻り値の型： (FunctionNode) -> FunctionNode

データフレームのスキーマ

例

Copied!
1
2
3
4
5
6
7
8
9
10
11
12
13
>>> series = F.points(
...     (100, 0.0),
...     (200, float("inf")),
...     (300, 3.14159),
...     (2147483647, 1.0),
...     name="series"
... )
>>> series.to_pandas()
                      timestamp    value
0 1970-01-01 00:00:00.000000100  0.00000
1 1970-01-01 00:00:00.000000200      inf
2 1970-01-01 00:00:00.000000300  3.14159
3 1970-01-01 00:00:02.147483647  1.00000

Copied!
1
2
3
4
5
6
7
>>> value_shifted = F.value_shift(3.0)(series)
>>> value_shifted.to_pandas()
                      timestamp    value
0 1970-01-01 00:00:00.000000100  3.00000
1 1970-01-01 00:00:00.000000200      inf
2 1970-01-01 00:00:00.000000300  6.14159
3 1970-01-01 00:00:02.147483647  4.00000

Copied!
1
2
3
4
5
6
7
>>> negative_value_shifted = F.value_shift(-3.0)(series)
>>> negative_value_shifted.to_pandas()
                      timestamp    value
0 1970-01-01 00:00:00.000000100 -3.00000
1 1970-01-01 00:00:00.000000200      inf
2 1970-01-01 00:00:00.000000300  0.14159
3 1970-01-01 00:00:02.147483647 -2.00000