derivative: 초당 변화율 계산

foundryts.functions.derivative()는 숫자형 시계열 하나에서 이전 관측에 대한 값의 변화율을 계산하는 함수를 반환합니다. 두 번째 관측부터 각 관측 시각에 결과를 만들며 시간 간격은 초 단위로 환산합니다.

변화율 = (현재 값 - 이전 값) / 경과 시간(초)

입력 관측의 저장 주기가 달라도 결과는 초당 변화율입니다. 입력과 출력은 FunctionNode이며 범주형 시계열에는 적용하지 않습니다.

가상 관측 예제

import foundryts.functions as F

series = F.points(
    (100, 100.0),
    (120, 200.0),
    (130, 230.0),
    (166, 266.0),
    (167, 366.0),
    name="series",
)
derivative_series = F.derivative()(series)
derivative_df = derivative_series.to_pandas()

정수 시각은 나노초입니다. 첫 구간의 변화율은 100을 20나노초로 나눈 값이므로 초당 5,000,000,000입니다.

출력 열은 pandas.Timestamp 형식의 timestamp와 float 형식의 value입니다. 시간에 걸친 누적 적분은 integral로 계산합니다.