value_shift: 관측값에 일정량 더하기
foundryts.functions.value_shift(delta)는 숫자형 시계열 하나의 각 값에 delta를 더하는 함수를 반환합니다. delta는 이동량을 나타내는 int 인수이며 입력과 출력은 FunctionNode입니다.
(timestamp, value)는 (timestamp, value + delta)가 됩니다. 시각은 바뀌지 않습니다.
양수와 음수 이동량
다음은 나노초 시각을 사용하는 가상 관측입니다.
import foundryts.functions as F
series = F.points(
(100, 0.0),
(200, float("inf")),
(300, 3.14159),
(2147483647, 1.0),
name="series",
)
value_shifted = F.value_shift(3)(series)
negative_value_shifted = F.value_shift(-3)(series)
shifted_df = value_shifted.to_pandas()
두 변환의 값을 비교하면 다음과 같습니다. 음수 이동의 결과가 필요하면 negative_value_shifted를 평가합니다.
| timestamp | 입력 값 | delta=3 | delta=-3 |
|---|---|---|---|
| 1970-01-01 00:00:00.000000100 | 0.0 | 3.0 | -3.0 |
| 1970-01-01 00:00:00.000000200 | inf | inf | inf |
| 1970-01-01 00:00:00.000000300 | 3.14159 | 6.14159 | 0.14159 |
| 1970-01-01 00:00:02.147483647 | 1.0 | 4.0 | -2.0 |
각 출력 DataFrame에는 pandas.Timestamp인 timestamp와 float인 value가 있습니다. 범주형 시계열에는 적용하지 않습니다.
시각을 옮기는 연산은 time_shift입니다. timestamp_scale은 현재 입력을 변경하지 않는 이전 API입니다.