Object: 온톨로지 객체 유형 참조

foundryts.objects.Object(object_type_id)는 온톨로지의 객체 유형을 나타내며 객체의 시계열 속성에 접근하는 출발점입니다. object_type_id는 String이며 객체 유형의 ID를 사용합니다. 객체 유형의 API Name이나 RID와 혼동하지 않습니다.

다음 식별자는 가상 항공기 유형과 객체를 가리킵니다. 실제 사용 시 해당 유형과 객체에 맞게 바꿉니다.

from foundryts.objects import Object

aircraft_object_type = Object("aircraft")
aircraft = aircraft_object_type.id("aircraft-1")

id

Object.id(object_primary_key_value)

object_primary_key_value는 String 형식의 객체 기본 키입니다. 객체의 기반 데이터셋이나 Object Explorer에서 확인합니다. id는 FoundryObject를 반환하며 그 객체의 property 메서드로 TSP를 참조할 수 있습니다.

객체 참조는 이 id 메서드로 생성합니다. 내부 객체 참조 클래스를 직접 생성하는 대신 온톨로지 접근에 필요한 보호 장치를 적용합니다.

객체의 시계열 범위 조회

다음 함수는 설정된 Code Workbook 환경에서 객체 유형 ID, 기본 키와 TSP의 속성 ID를 받아, Unix epoch부터 2025년 9월 23일 직전까지의 관측을 문자열로 반환합니다. 실행 환경과 입력 리소스를 준비해야 합니다.

from datetime import datetime, timezone

import foundryts.functions as F
from foundryts.objects import Object


def get_sensor_range(object_type_id, primary_key, property_id) -> str:
    sensor = Object(object_type_id).id(primary_key)
    series = sensor.property(property_id)
    end_dt = datetime(2025, 9, 23, tzinfo=timezone.utc)
    selected = F.time_range(start=0, end=end_dt)(series)
    return str(selected.to_pandas())


sensor_range_text = get_sensor_range(
    "aircraft", "aircraft-1", "altimeter_series_id"
)

property_id에는 TSP의 속성 ID를 전달합니다. Functions에서는 지원되는 TSP 접근 방식을 사용합니다.