FoundryObject: 객체의 시계열 속성 참조
foundryts.objects.FoundryObject(object_type_id, object_primary_key)는 온톨로지의 객체 하나를 나타냅니다. 두 인수는 각각 String 형식의 객체 유형 ID와 기본 키입니다. 객체 참조를 만들 때는 Object.id를 사용하여 온톨로지 접근에 필요한 보호 장치를 적용합니다.
from foundryts.objects import Object
aircraft = Object("aircraft").id("aircraft-1")
예제의 aircraft와 aircraft-1은 가상 유형 ID와 기본 키입니다. 기본 키는 객체의 기반 데이터셋 또는 Object Explorer에서 찾을 수 있습니다.
property
FoundryObject.property(property_id, dataframe_identifier=None)
| 인수 | 형식 | 의미 |
|---|---|---|
| property_id | str | 객체에 구성된 TSP의 속성 ID |
| dataframe_identifier | str, 선택 | 여러 시계열을 NodeCollection에서 평가할 때 DataFrame에 표시할 시계열 식별자. 기본값은 플랫폼의 series ID |
속성 ID는 Ontology Manager의 속성 편집 화면에서 확인합니다. 속성 ID, 속성 RID와 API Name은 서로 다른 식별자이므로 property_id에 속성 ID를 사용합니다.
파생 시계열 템플릿처럼 복합 TSP를 참조하는 경우에는 dataframe_identifier가 필요합니다. 일반 TSP에서도 결과에 사용할 이름을 지정할 수 있습니다.
반환값은 해당 TSP의 시계열을 참조하는 FunctionNode이며 FoundryTS 변환과 분석을 적용할 수 있습니다.
고도 시계열 예제
실행 환경에 객체 유형과 시계열 입력을 준비한 뒤 속성을 선택합니다.
from foundryts.objects import Object
altimeter = (
Object("aircraft")
.id("aircraft-1")
.property("altimeter_series_id")
)
altimeter_df = altimeter.to_pandas()
가상 숫자형 TSP의 결과는 timestamp와 value 열을 가진 DataFrame입니다. 다음은 관측 일부를 나타낸 예입니다.
| timestamp | value |
|---|---|
| 2024-09-06 07:00:00.000 | -1.185493 |
| 2024-09-06 07:01:30.983 | 0.830117 |
| 2024-09-06 07:03:01.966 | 0.115240 |
| 2024-09-06 07:04:32.949 | 0.059973 |
| 2024-09-06 07:06:03.932 | -0.290032 |
| 2024-09-06 13:11:30.835 | 2.346732 |
| 2024-09-06 13:13:01.818 | 0.891372 |
| 2024-09-06 13:14:32.801 | 0.318806 |
| 2024-09-06 13:16:03.784 | -0.339124 |
| 2024-09-06 13:17:34.767 | -0.879413 |
여러 객체의 시계열을 함께 평가하려면 NodeCollection으로 묶습니다. 이 경우 series 열로 각 시계열의 결과를 구분합니다.