Workshop의 시계열 속성과 계산
시계열 속성은 시각과 함께 기록한 값의 이력입니다. 일반 속성이 Argentina 같은 문자열이나 81231 같은 숫자 하나를 담는 것과 달리 시간에 따른 관측값을 저장합니다.
플랫폼 인스턴스에 시계열 서비스가 설치되어 있어야 합니다. 제공 여부는 Palantir 담당자에게 확인하며, 데이터 준비는 시계열 속성 설정을 따릅니다.
Workshop은 Chart XY, Map, Metric Card와 Object Table에서 시계열을 사용할 수 있습니다. Time series set 변수를 만들거나 객체의 속성을 직접 사용하며, 다른 변환이 만든 시계열도 입력으로 연결할 수 있습니다.
변환의 입력과 출력
변환은 시계열을 받아 새 시계열을 만듭니다. 그 출력을 다른 변환에 연결하여 계산을 이어 갈 수 있습니다.
Country 객체가 Name과 일별 관측값을 가진 covid19 New Cases 속성을 갖는 예제입니다. Object Table에서는 시계열의 최근 값을 왼쪽에, 이력을 나타내는 sparkline을 오른쪽에 표시합니다.
Aggregate
Aggregate는 입력값을 시간 구간별로 집계합니다. 집계 방식은 뒤의 요약 연산 목록에서 선택합니다.
Cumulative
각 입력 시점에서 그 시점까지의 모든 앞선 점을 포함하여 집계합니다. 예를 들어 Sum을 선택하면 지금까지 관측한 값의 누적합이 됩니다. 고급 설정에서 유한하지 않은 입력값을 건너뛸지 정할 수 있습니다.
Periodic
동일한 간격의 겹치지 않는 구간으로 나누어 각 구간의 입력점을 집계합니다. Window size가 길이를, Alignment timestamp가 구간 정렬의 기준을 정합니다. 기준 시각에 window size의 정수배를 더하거나 빼서 구간을 만듭니다.
- Start는 구간 시작에 출력점을 두고 그 뒤의 해당 구간 값을 집계합니다.
- End는 구간 끝에 출력점을 두고 그 앞의 해당 구간 값을 집계합니다.
다음 예는 정렬 기준 시각에 맞춘 연속된 2주 구간의 평균을 만듭니다. 유한하지 않은 값을 건너뛰는 설정도 사용할 수 있습니다.
Rolling
각 입력 시점과 그 앞의 고정 크기 시간 창 안에 있는 점을 집계합니다. 현재 점도 포함합니다. 예는 직전 3일 구간의 표준편차이며 유한하지 않은 값을 건너뛸지 선택할 수 있습니다.
Derivative
Derivative는 입력값의 시간에 따른 변화율을 만듭니다. 시간 단위를 지정하여 해석할 수 있습니다. 예를 들어 누적 주행 거리 km의 변화율을 시간 기준으로 계산하면 km/hour, 초 기준이면 km/second입니다.
일별 사례 수의 변화율은 cases/day로 해석할 수 있습니다. 시간 단위를 weeks로 정하면 일 단위 변화율을 7배 하여 cases/week로 표현합니다.
Formula
Add input으로 시계열 속성이나 앞선 변환의 출력을 추가한 뒤 그 입력을 참조하는 DSL 수식을 구성합니다. 아래 예는 입력을 두 배로 하고 5를 더합니다.
Integral
Integral은 곡선 아래의 누적 면적을 시계열로 계산합니다. 시간 단위를 조정할 수 있으며, 전력 kW 시계열의 면적을 시간 단위로 계산하면 에너지 kWh, 분 단위로 계산하면 kW-minute로 해석합니다.
| 적분 방식 | 두 점 사이에 사용하는 값 |
|---|---|
| linear | 양쪽 값의 평균을 사용합니다. |
| left hand sum | 앞 시점의 값을 사용합니다. |
| right hand sum | 뒤 시점의 값을 사용합니다. |
Time range와 Time shift
Time range 변환은 지정한 시간 범위로 입력 시계열을 필터링합니다.
Time shift는 값의 형태를 유지하면서 지정한 방향과 기간만큼 시점을 옮깁니다.
시계열 요약
Summarizer는 시계열에서 표시할 요약값을 계산합니다. Object Table과 Metric Card 등 시계열 지원 위젯에 사용합니다. 집계 종류와 시간 범위를 함께 정합니다.
Single Value는 한 번의 집계를 수행합니다. 예제에서는 지난주의 평균 사례 수를 표시합니다.
Value Change는 두 요약값을 구한 뒤 차이를 계산합니다. 예제는 최근 두 주의 주간 총 사례 수 차이를 구합니다.
집계 종류
| 종류 | 계산 |
|---|---|
| Average | 입력점 값의 평균 |
| Count | 구간 안의 입력점 개수 |
| Difference | 마지막 점의 값에서 첫 점의 값을 뺀 차이 |
| First | 구간 첫 점의 값 |
| Integral | 구간의 곡선 아래 면적 |
| Last | 구간 마지막 점의 값 |
| Min | 구간 최솟값 |
| Max | 구간 최댓값 |
| Product | 구간의 입력값을 모두 곱한 값 |
| Relative difference | 마지막 값과 첫 값의 차이를 첫 값으로 나눈 값. 100배하면 백분율 변화량입니다. |
| Standard deviation | 구간 입력값의 표준편차 |
| Sum | 구간 입력값의 합 |
| Time-weighted average | 각 값이 유지된 시간으로 가중한 평균. 관측 간격이 불규칙한 경우에 적합합니다. |
시간 범위
시간 범위는 시작과 끝으로 정한 구간입니다. 변환의 필터, 요약의 대상 범위와 sparkline 및 baseline 구성에 사용합니다. 공통 선택기에서 기본 범위 또는 Custom range를 고릅니다.
Exact는 날짜와 시각 선택기로 절대 시작과 끝을 지정합니다. 지정한 구간은 고정됩니다.
Relative는 현재 시각을 기준으로 시작과 끝의 차이를 정합니다. 기준 현재 시각은 처음 필요할 때 계산하고 웹페이지를 다시 로드할 때까지 고정하여 여러 위젯이 같은 기준을 사용하게 합니다.
첫 계산의 기준이 12월 15일이면 2 weeks ago는 12월 1일, 1 week from now는 12월 22일입니다. 다시 로드하여 기준이 12월 16일이 되면 각각 12월 2일과 12월 23일이 됩니다. 같은 페이지에서 시간이 흐를 때마다 창을 계속 이동시키는 동작과 구분합니다.
단위는 밀리초, 초, 분, 시간, 일과 주를 사용할 수 있습니다.
Baseline
Baseline은 sparkline과 구분되는 추가 선으로 비교 기준을 제공합니다. Object Table과 Metric Card에서 구성할 수 있습니다.
Static은 모든 시계열에 같은 고정값을 사용합니다. 아래 Weekly Cases 예의 기준값은 1000입니다.
Numeric property는 각 객체의 숫자 속성을 그 행의 기준값으로 사용합니다. Hospital Admissions 열에서 Country의 Hospital Capacity를 기준으로 삼는 예입니다.
Time series property는 시계열 summarizer로 각 시계열의 기준값을 계산합니다. 아래 예는 Weekly Cases의 최근 관측값을 사용합니다. 전체 두 번째 시계열을 그대로 겹치는 것과 달리 요약한 기준값을 표시합니다.
수치와 색의 표현은 서식을 적용합니다.