points: 관측값으로 시계열 정의

foundryts.functions.points(*list_of_points, name='point-set')

시각과 값을 직접 지정한 점 집합을 FunctionNode로 반환합니다. 이 점들은 동기화에 저장하지 않으며, 보간이나 DSL 수식에 사용할 기준 시계열을 만들거나 계산 방식을 익힐 때 사용할 수 있습니다.

각 위치 인수는 (TimestampType, float) 또는 (TimestampType, str) 쌍입니다. name은 후속 계산에서 시계열 ID로 사용하는 String 이름이며 기본값은 point-set입니다. 한 점 집합의 값은 모두 같은 유형이어야 합니다.

숫자형 관측

가상 숫자형 시계열을 다음과 같이 정의합니다. 정수 시각은 Unix epoch 이후 나노초입니다.

import foundryts.functions as F

numeric_series = F.points(
    (0, 0.0),
    (100, 100.0),
    (140, 140.0),
    (200, 200.0),
    name="numeric",
)
numeric_df = numeric_series.to_pandas()

범주형 관측

import foundryts.functions as F

enum_series = F.points(
    (100, "ON"),
    (120, "ON"),
    (130, "OFF"),
    (150, "ON"),
    (160, "OFF"),
    name="enum",
)
enum_df = enum_series.to_pandas()

출력과 평가

반환한 노드의 DataFrame은 timestamp와 value 열을 가집니다. timestamp는 pandas.Timestamp이며 value는 해당 점 집합의 float 또는 str 값입니다.

점 정의를 저장하는 동기화는 필요하지 않지만, FoundryTS 질의 평가에는 라이브러리 실행 환경을 사용합니다. 이미 저장된 관측을 series ID로 참조할 때는 series를 사용합니다.