mean: 같은 시각에 존재하는 값의 평균

foundryts.functions.mean()는 여러 숫자형 시계열에서 같은 시각에 존재하는 관측값의 평균을 구하는 함수를 반환합니다. 결과 시각은 모든 입력 시각의 합집합입니다. 그 시각에 관측이 없는 입력을 보간하거나 0으로 채우지 않습니다.

여러 시계열의 NodeCollection 또는 노드 목록을 입력으로 받고 FunctionNode를 반환합니다. 결과 DataFrame은 pandas.Timestamp 형식의 timestamp와 float 형식의 value를 가집니다.

같은 입력을 두 번 포함한 예

다음 가상 관측의 시각은 나노초입니다. series_2를 두 번 전달하므로 해당 값은 두 입력으로 집계됩니다.

import foundryts.functions as F

series_1 = F.points(
    (0, 0.0),
    (100, 100.0),
    (140, 140.0),
    (200, 200.0),
    name="series-1",
)
series_2 = F.points(
    (100, 200.0),
    (120, 220.0),
    (130, 330.0),
    (150, 350.0),
    (160, 460.0),
    name="series-2",
)
mean_series = F.mean()([series_1, series_2, series_2])
mean_df = mean_series.to_pandas()

시각 100의 평균은 (100 + 200 + 200) / 3입니다. 시각 140에는 series_1의 관측만 있으므로 140을 그대로 사용합니다.

범주형 시계열에는 적용하지 않습니다. 같은 시각의 값을 더할 때는 sum을 사용합니다.