timestamp_scale: 변경하지 않는 이전 API

foundryts.functions.timestamp_scale(factor)는 사용 중단이 진행 중이며 현재 입력 시계열을 그대로 반환합니다. 인수 factor는 int이지만 현재 동작에서는 시각에 배율을 적용하지 않습니다. 향후 릴리스에서 제거될 예정인 API입니다.

이전 연산의 의도는 (timestamp, value)를 (timestamp * factor, value)로 바꾸는 것이었습니다. 백엔드가 서로 다른 시간 단위를 자동으로 통일하므로 시간 단위를 맞추기 위해 이 함수를 호출할 필요는 없습니다.

기존 호출의 동작

입력과 출력은 FunctionNode입니다. 다음 가상 시계열에 factor=99를 지정해도 시각과 값이 바뀌지 않습니다.

import foundryts.functions as F

series = F.points(
    (1, 1.0),
    (101, 2.0),
    (200, 4.0),
    (201, 8.0),
    name="series",
)
unchanged = F.timestamp_scale(99)(series)
unchanged_df = unchanged.to_pandas()

숫자형 예제의 결과 스키마는 timestamp가 pandas.Timestamp, value가 float입니다.

실제 관측 시각에 일정한 간격을 더하려면 time_shift를 사용합니다. scale은 관측값에 배율을 적용하고 value_shift는 관측값에 일정량을 더합니다.