unit8co/darts시계열 데이터에 대한 사용자 친화적인 예측 및 이상 탐지를 위한 Python 라이브러리입니다.
Darts는 시계열에 대한 사용자 친화적인 예측 및 이상 탐지를 위한 Python 라이브러리입니다. ARIMA와 같은 고전적인 모델부터 심층 신경망까지 다양한 모델이 포함되어 있습니다. 예측 모델은 모두 scikit-learn과 유사하게 fit() 및 predict() 함수를 사용하여 동일한 방식으로 사용할 수 있습니다. 이 라이브러리는 모델 백테스트, 여러 모델의 예측 결합, 외부 데이터 반영을 쉽게 해줍니다. Darts는 단변량 및 다변량 시계열과 모델을 모두 지원합니다. ML 기반 모델은 여러 시계열이 포함된 대규모 데이터셋에서 학습할 수 있으며, 일부 모델은 확률적 예측을 풍부하게 지원합니다.
Darts는 또한 광범위한 이상 탐지 기능을 제공합니다. 예를 들어, PyOD 모델을 시계열에 적용하여 이상 점수를 얻는 것은 매우 간단하며, Darts의 예측 모델이나 필터링 모델을 래핑하여 완전한 기능을 갖춘 이상 탐지 모델을 만들 수도 있습니다.
먼저 선호하는 도구(conda, venv, virtualenv 또는 virtualenvwrapper 사용 여부는 선택)를 사용하여 Python 3.10+ 기반의 깨끗한 Python 환경을 프로젝트에 설정하는 것을 권장합니다.
환경이 준비되면 pip를 사용하여 darts를 설치할 수 있습니다:
pip install darts
자세한 내용은 설치 안내를 참조하세요.
Pandas DataFrame에서 TimeSeries 객체를 생성하고 훈련/검증 시리즈로 분할합니다:```python
import pandas as pd
from darts import TimeSeries
df = pd.read_csv("AirPassengers.csv", delimiter=",")
series = TimeSeries.from_dataframe(df, "Month", "#Passengers")
train, val = series[:-36], series[-36:]
지수 평활 모델을 피팅하고, 검증 시리즈 기간에 대한 (확률적) 예측을 수행합니다:```python
from darts.models import ExponentialSmoothing
model = ExponentialSmoothing()
model.fit(train)
prediction = model.predict(len(val), num_samples=1000)
중앙값, 5번째 및 95번째 백분위수를 플로팅합니다:```python import matplotlib.pyplot as plt
series.plot() prediction.plot(label="forecast", low_quantile=0.05, high_quantile=0.95) plt.legend()
<div style="text-align:center;">
<img src="https://raw.githubusercontent.com/unit8co/darts/master/static/images/example.png" alt="darts 예측 예시" />
</div>
### 이상 탐지
다변량 계열을 로드하고, 정리하고, 2개 구성 요소를 유지한 다음, 학습 세트와 검증 세트로 분할합니다:```python
from darts.datasets import ETTh2Dataset
series = ETTh2Dataset().load()[:10000][["MUFL", "LULL"]]
train, val = series.split_before(0.6)
k-means 이상 탐지 스코어러를 구축하고 훈련 세트에서 학습시킨 다음
검증 세트에 적용하여 이상 점수를 얻습니다:```python
from darts.ad import KMeansScorer
scorer = KMeansScorer(k=2, window=5) scorer.fit(train) anom_score = scorer.score(val)
이진 이상 탐지기를 구축하고 학습 점수로 학습시킨 다음, 검증 점수에 적용하여 이진 이상 분류를 얻습니다:```python
from darts.ad import QuantileDetector
detector = QuantileDetector(high_quantile=0.99)
detector.fit(scorer.score(train))
binary_anom = detector.detect(anom_score)
플롯(일부 시리즈를 이동 및 크기 조절하여 모두 같은 그림에 표시되도록 함):```python import matplotlib.pyplot as plt
series.plot() (anom_score / 2. - 100).plot(label="computed anomaly score", c="orangered", lw=3) (binary_anom * 45 - 150).plot(label="detected binary anomaly", lw=4)
<div style="text-align:center;">
<img src="https://raw.githubusercontent.com/unit8co/darts/master/static/images/example_ad.png" alt="darts anomaly detection example" />
</div>
## 기능
* **예측 모델:** 회귀 및 분류 작업을 위한 대규모 예측 모델 모음입니다. 통계 모델(예:
ARIMA)부터 딥러닝 모델(예: N-BEATS)까지 포함합니다. 아래의 [예측 모델](#forecasting-models)을 참조하세요.
* **이상 탐지:** `darts.ad` 모듈에는 이상 스코어러(scorers) 모음이 포함되어 있으며,
탐지기(detectors)와 집계기(aggregators)를 결합하여 시계열에서 이상을 탐지할 수 있습니다.
Darts의 예측 또는 필터링 모델을 래핑하여 예측과 실제 값을 비교하는
완전한 이상 탐지 모델을 쉽게 구축할 수 있습니다.
`PyODScorer`를 사용하면 시계열에 PyOD 탐지기를 간단히 적용할 수 있습니다.
* **다변량 지원:** `TimeSeries`는 다변량일 수 있습니다. 즉, 단일 스칼라 값 대신 여러 개의 시간에 따라 변하는
차원/열을 포함할 수 있습니다. 많은 모델이 다변량 시리즈를 소비하고 생성할 수 있습니다.
* **다중 시리즈 훈련(글로벌 모델):** 모든 머신러닝 기반 모델(모든 신경망 포함)은
여러 개의(잠재적으로 다변량) 시리즈로 훈련할 수 있습니다. 이는 대규모 데이터셋으로도 확장할 수 있습니다.
* **확률적 지원:** `TimeSeries` 객체는 (선택적으로) 확률적
시계열을 나타낼 수 있습니다. 예를 들어 신뢰 구간을 얻는 데 사용할 수 있으며, 많은 모델이 다양한
확률적 예측 방식을 지원합니다(예: 모수적 분포 또는 분위수 추정).
일부 이상 탐지 스코어러도 이러한 예측 분포를 활용할 수 있습니다.
* **Conformal Prediction 지원:** 당사의 Conformal Prediction 모델은 사전 훈련된 모든 글로벌 예측 모델에 대해
보정된 분위수 구간을 갖는 확률적 예측을 생성할 수 있습니다.
* **과거 및 미래 공변량 지원:** Darts의 많은 모델은 과거 관측 및/또는 미래 알려진
공변량(외부 데이터) 시계열을 입력으로 사용하여 예측을 생성할 수 있습니다.
* **정적 공변량 지원:** 시간 종속 데이터 외에도 `TimeSeries`는 각 차원에 대한
정적 데이터를 포함할 수 있으며, 일부 모델에서 이를 활용할 수 있습니다.
* **계층적 조정:** Darts는 조정을 수행하는 트랜스포머를 제공합니다.
이들은 예측이 기본 계층 구조를 존중하는 방식으로 합산되도록 할 수 있습니다.
* **회귀 모델:** scikit-learn 호환 모델을 플러그인하여
대상 시리즈와 공변량의 시차(lagged) 값의 함수로 예측을 얻을 수 있습니다.
* **샘플 가중치 훈련:** 모든 글로벌 모델은 샘플 가중치로 훈련할 수 있습니다. 이 가중치는
각 관측치, 예측 시간 단계 및 대상 열에 적용할 수 있습니다.
* **예측 시작 이동:** 모든 글로벌 모델은 이동된 출력 창에서 훈련 및 예측을 지원합니다.
이는 예를 들어 Day-Ahead Market 예측이나 공변량(또는 대상 시리즈)이 지연 보고되는 경우에
유용합니다.
* **설명 가능성:** Darts는 SHAP 값을 사용하여 일부 예측 모델을 *설명*할 수 있습니다.
* **데이터 처리:** 시계열 데이터에 일반적인 변환(스케일링, 결측값 채우기, 차분, boxcox 등)을
쉽게 적용(및 되돌리기)할 수 있는 도구입니다.
* **메트릭:** 시계열의 적합도를 평가하기 위한 다양한 메트릭을 제공합니다.
R2 점수부터 평균 절대 스케일 오차(Mean Absolute Scaled Error)까지.
* **백테스팅:** 이동 시간 창을 사용하여 과거 예측을 시뮬레이션하는 유틸리티입니다.
* **PyTorch Lightning 지원:** 모든 딥러닝 모델은 PyTorch Lightning을 사용하여 구현되며,
사용자 정의 콜백, GPU/TPU 훈련, 사용자 정의 트레이너 등을 지원합니다.
* **필터링 모델:** Darts는 세 가지 필터링 모델을 제공합니다: `KalmanFilter`, `GaussianProcessFilter`,
그리고 `MovingAverageFilter`. 이들은 시계열을 필터링할 수 있으며, 경우에 따라 기저 상태/값의 확률적
추론을 얻을 수 있습니다.
* **데이터셋:** `darts.datasets` 하위 모듈에는 빠르고
재현 가능한 실험을 위한 인기 있는 시계열 데이터셋이 포함되어 있습니다.
* **다중 백엔드 호환성:** `TimeSeries` 객체는 pandas, polars, numpy, pyarrow, xarray 등 다양한 백엔드에서 생성하거나 내보낼 수 있으며, 여러 데이터 처리 라이브러리와의 원활한 통합을 지원합니다.
## 예측 모델
다음은 Darts에 현재 구현된 예측 모델에 대한 설명입니다. 저희 제품군에는 각각 특정 예측 작업에 맞춰진 회귀 및 분류 모델이 모두 포함되어 있습니다. 저희는 예측 기능을 향상시키기 위해 새로운 모델과 기능을 지속적으로 추가할 예정입니다.
**회귀 모델:** 회귀 모델은 연속적인 숫자 값을 예측하도록 설계되어, 시계열 데이터의 미래 추세와 패턴을 예측하는 데 이상적입니다. 이러한 모델을 활용하여 과거 데이터를 기반으로 잠재적인 미래 결과에 대한 통찰력을 얻을 수 있습니다.| 모델 | 출처 | 대상 시계열 지원:<br/><br/>단변량/<br/>다변량 | 공변량 지원:<br/><br/>과거 관측/<br/>미래 알려짐/<br/>정적 | 확률적 예측:<br/><br/>샘플링/<br/>분포 파라미터 | 다중 시계열 학습 및 예측 |
|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------|--------------------------------------------------------------------------|--------------------------------------------------------------------------|-------------------------------------------|
| **기준 모델**<br/>([LocalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#local-forecasting-models-lfms)) | | | | | |
| [NaiveMean](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.baselines.html#darts.models.forecasting.baselines.NaiveMean) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | 🔴 |
| [NaiveSeasonal](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.baselines.html#darts.models.forecasting.baselines.NaiveSeasonal) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | 🔴 |
| [NaiveDrift](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.baselines.html#darts.models.forecasting.baselines.NaiveDrift) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | 🔴 |
| [NaiveMovingAverage](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.baselines.html#darts.models.forecasting.baselines.NaiveMovingAverage) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | 🔴 |
| **통계 / 고전 모델**<br/>([LocalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#local-forecasting-models-lfms)) | | | | | |
| [ARIMA](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.arima.html#darts.models.forecasting.arima.ARIMA) | | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ 🔴 | 🔴 |
| [VARIMA](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.varima.html#darts.models.forecasting.varima.VARIMA) | | 🔴 ✅ | 🔴 ✅ 🔴 | ✅ 🔴 | 🔴 |
| [ExponentialSmoothing](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.exponential_smoothing.html#darts.models.forecasting.exponential_smoothing.ExponentialSmoothing) | | ✅ 🔴 | 🔴 🔴 🔴 | ✅ 🔴 | 🔴 |
| [Theta](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.theta.html#darts.models.forecasting.theta.Theta) and [FourTheta](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.theta.html#darts.models.forecasting.theta.FourTheta) | [Theta 논문](https://robjhyndman.com/papers/Theta.pdf) & [4 Theta 소스](https://github.com/Mcompetitions/M4-methods/blob/master/4Theta%20method.R) | ✅ 🔴 | 🔴 🔴 🔴 | 🔴 🔴 | 🔴 |
| [Prophet](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.prophet_model.html#darts.models.forecasting.prophet_model.Prophet) | [Prophet 저장소](https://github.com/facebook/prophet) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ 🔴 | 🔴 |
| [FFT](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.fft.html#darts.models.forecasting.fft.FFT) (고속 푸리에 변환) | | ✅ 🔴 | 🔴 🔴 🔴 | 🔴 🔴 | 🔴 |
| [KalmanForecaster](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.kalman_forecaster.html#darts.models.forecasting.kalman_forecaster.KalmanForecaster) 칼만 필터와 N4SID를 사용한 시스템 식별 | [N4SID 논문](https://people.duke.edu/~hpgavin/SystemID/References/VanOverschee-Automatica-1994.pdf) | ✅ ✅ | 🔴 ✅ 🔴 | ✅ 🔴 | 🔴 |
| [TBATS](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_tbats.html#darts.models.forecasting.sf_tbats.TBATS) | [TBATS 논문](https://robjhyndman.com/papers/ComplexSeasonality.pdf) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [Croston](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_croston.html#darts.models.forecasting.sf_croston.Croston) 방법 | | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [StatsForecastModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_model.html#darts.models.forecasting.sf_model.StatsForecastModel) 임의의 [StatsForecast](https://nixtlaverse.nixtla.io/statsforecast/index.html#models) 모델을 감싸는 래퍼 | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [AutoARIMA](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_auto_arima.html#darts.models.forecasting.sf_auto_arima.AutoARIMA) | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [AutoETS](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_auto_ets.html#darts.models.forecasting.sf_auto_ets.AutoETS) | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [AutoCES](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_auto_ces.html#darts.models.forecasting.sf_auto_ces.AutoCES) | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [AutoMFLES](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_auto_mfles.html#darts.models.forecasting.sf_auto_mfles.AutoMFLES) | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [AutoTBATS](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_auto_tbats.html#darts.models.forecasting.sf_auto_tbats.AutoTBATS) | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [AutoTheta](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sf_auto_theta.html#darts.models.forecasting.sf_auto_theta.AutoTheta) | [Nixtla의 statsforecast](https://github.com/Nixtla/statsforecast) | ✅ 🔴 | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| [MultivariateModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.multivariate_model.html#darts.models.forecasting.multivariate_model.MultivariateModel) | | ✅ ✅ | 🔴 ✅ 🔴 | ✅ ✅ | 🔴 |
| **글로벌 기준 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)) | | | | | |
| [GlobalNaiveAggregate](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.global_baseline_models.html#darts.models.forecasting.global_baseline_models.GlobalNaiveAggregate) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | ✅ |
| [GlobalNaiveDrift](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.global_baseline_models.html#darts.models.forecasting.global_baseline_models.GlobalNaiveDrift) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | ✅ |
| [GlobalNaiveSeasonal](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.global_baseline_models.html#darts.models.forecasting.global_baseline_models.GlobalNaiveSeasonal) | | ✅ ✅ | 🔴 🔴 🔴 | 🔴 🔴 | ✅ |
| **회귀 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)) | | | | | |
| [SKLearnModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sklearn_model.html#darts.models.forecasting.sklearn_model.SKLearnModel): scikit-learn 계열 회귀 모델을 감싸는 래퍼 | | ✅ ✅ | ✅ ✅ ✅ | 🔴 🔴 | ✅ |
| [LinearRegressionModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.linear_regression_model.html#darts.models.forecasting.linear_regression_model.LinearRegressionModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [RandomForestModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.random_forest.html#darts.models.forecasting.random_forest.RandomForestModel) | | ✅ ✅ | ✅ ✅ ✅ | 🔴 🔴 | ✅ |
| [CatBoostModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.catboost_model.html#darts.models.forecasting.catboost_model.CatBoostModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [LightGBMModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.lgbm.html#darts.models.forecasting.lgbm.LightGBMModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [XGBModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.xgboost.html#darts.models.forecasting.xgboost.XGBModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| **PyTorch (Lightning) 기반 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)) | | | | | |
| [RNNModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.rnn_model.html#darts.models.forecasting.rnn_model.RNNModel) (LSTM 및 GRU 포함); 확률적 버전에서 DeepAR에 해당 | [DeepAR 논문](https://arxiv.org/abs/1704.04110) | ✅ ✅ | 🔴 ✅ 🔴 | ✅ ✅ | ✅ |
| [BlockRNNModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.block_rnn_model.html#darts.models.forecasting.block_rnn_model.BlockRNNModel) (LSTM 및 GRU 포함) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [NBEATSModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.nbeats.html#darts.models.forecasting.nbeats.NBEATSModel) | [N-BEATS 논문](https://arxiv.org/abs/1905.10437) | ✅ ✅ | ✅ 🔴 🔴 | ✅ ✅ | ✅ |
| [NHiTSModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.nhits.html#darts.models.forecasting.nhits.NHiTSModel) | [N-HiTS 논문](https://arxiv.org/abs/2201.12886) | ✅ ✅ | ✅ 🔴 🔴 | ✅ ✅ | ✅ |
| [TCNModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.tcn_model.html#darts.models.forecasting.tcn_model.TCNModel) | [TCN 논문](https://arxiv.org/abs/1803.01271), [DeepTCN 논문](https://arxiv.org/abs/1906.04397), [블로그 게시물](https://medium.com/unit8-machine-learning-publication/temporal-convolutional-networks-and-forecasting-5ce1b6e97ce4) | ✅ ✅ | ✅ 🔴 🔴 | ✅ ✅ | ✅ |
| [TransformerModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.transformer_model.html#darts.models.forecasting.transformer_model.TransformerModel) | | ✅ ✅ | ✅ 🔴 🔴 | ✅ ✅ | ✅ |
| [TFTModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.tft_model.html#darts.models.forecasting.tft_model.TFTModel) (Temporal Fusion Transformer) | [TFT 논문](https://arxiv.org/pdf/1912.09363.pdf), [PyTorch Forecasting](https://pytorch-forecasting.readthedocs.io/en/latest/models.html) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [DLinearModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.dlinear.html#darts.models.forecasting.dlinear.DLinearModel) | [DLinear 논문](https://arxiv.org/pdf/2205.13504.pdf) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [NLinearModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.nlinear.html#darts.models.forecasting.nlinear.NLinearModel) | [NLinear 논문](https://arxiv.org/pdf/2205.13504.pdf) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [TiDEModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.tide_model.html#darts.models.forecasting.tide_model.TiDEModel) | [TiDE 논문](https://arxiv.org/pdf/2304.08424.pdf) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [TSMixerModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.tsmixer_model.html#darts.models.forecasting.tsmixer_model.TSMixerModel) | [TSMixer 논문](https://arxiv.org/pdf/2303.06053.pdf), [PyTorch 구현](https://github.com/ditschuk/pytorch-tsmixer) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [NeuralForecastModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.nf_model.html#darts.models.forecasting.nf_model.NeuralForecastModel): 임의의 [NeuralForecast](https://nixtlaverse.nixtla.io/neuralforecast/docs/capabilities/overview.html) 기본 모델을 감싸는 래퍼 | [NeuralForecast 문서](https://nixtlaverse.nixtla.io/neuralforecast/docs/) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| **파운데이션 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)): 학습 불필요 | | | | | |
| [Chronos2Model](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.chronos2_model.html#darts.models.forecasting.chronos2_model.Chronos2Model) | [Chronos-2 리포트](https://arxiv.org/abs/2510.15821), [Amazon 블로그 게시물](https://www.amazon.science/blog/introducing-chronos-2-from-univariate-to-universal-forecasting) | ✅ ✅ | ✅ ✅ 🔴 | ✅ ✅ | ✅ |
| [TimesFM2p5Model](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.timesfm2p5_model.html#darts.models.forecasting.timesfm2p5_model.TimesFM2p5Model) | [TimesFM 1.0 논문](https://arxiv.org/abs/2310.10688), [Google 블로그 게시물](https://research.google/blog/a-decoder-only-foundation-model-for-time-series-forecasting) | ✅ ✅ | 🔴 🔴 🔴 | ✅ ✅ | ✅ |
| [TiRexModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.tirex_model.html#darts.models.forecasting.tirex_model.TiRexModel) | [TiRex 논문](https://arxiv.org/abs/2505.23719), [TiRex GitHub](https://github.com/NX-AI/tirex) | ✅ ✅ | 🔴 🔴 🔴 | ✅ ✅ | ✅ |
| [PatchTSTFMModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.patchtst_fm_model.html#darts.models.forecasting.patchtst_fm_model.PatchTSTFMModel) | [PatchTST-FM 논문](https://arxiv.org/abs/2602.06909), [PatchTST-FM GitHub](https://github.com/ibm-granite/granite-tsfm) | ✅ ✅ | 🔴 🔴 🔴 | ✅ ✅ | ✅ |
| **앙상블 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)): 모델 지원은 앙상블된 예측 모델과 앙상블 모델 자체에 따라 달라집니다. | | | | | |
| [NaiveEnsembleModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.naive_ensemble_model.html#darts.models.forecasting.naive_ensemble_model.NaiveEnsembleModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [RegressionEnsembleModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.regression_ensemble_model.html#darts.models.forecasting.regression_ensemble_model.RegressionEnsembleModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| **컨포멀 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)): 모델 지원은 사용된 예측 모델에 따라 달라집니다. | | | | | |
| [ConformalNaiveModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.conformal_models.html#darts.models.forecasting.conformal_models.ConformalNaiveModel) | [Conformalized Prediction](https://arxiv.org/pdf/1905.03222) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [ConformalQRModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.conformal_models.html#darts.models.forecasting.conformal_models.ConformalQRModel) | [Conformalized Quantile Regression](https://arxiv.org/pdf/1905.03222) | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |**분류 모델:** Darts의 분류 모델은 범주형 클래스 레이블을 예측하도록 설계되어, 효과적인 시계열 레이블링과 미래 클래스 예측을 가능하게 합니다. 이러한 모델은 시간이 지남에 따라 서로 다른 범주나 상태를 식별하는 것이 중요한 시나리오에 완벽합니다.
| 모델 | 출처 | 대상 시계열 지원:<br/><br/>단변량/<br/>다변량 | 공변량 지원:<br/><br/>과거 관측/<br/>미래 알려짐/<br/>정적 | 확률적 예측:<br/><br/>샘플링/<br/>분포 매개변수 | 다중 시계열 훈련 및 예측 |
|---------|---------|--------------------------------------------------------------|--------------------------------------------------------------------------|--------------------------------------------------------------------------|-------------------------------------------|
| **회귀 모델**<br/>([GlobalForecastingModel](https://unit8co.github.io/darts/userguide/covariates.html#global-forecasting-models-gfms)) | | | | | |
| [SKLearnClassifierModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.sklearn_model.html#darts.models.forecasting.sklearn_model.SKLearnClassifierModel): scikit-learn 계열 분류 모델의 래퍼 | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [CatBoostClassifierModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.catboost_model.html#darts.models.forecasting.catboost_model.CatBoostClassifierModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [LightGBMClassifierModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.lgbm.html#darts.models.forecasting.lgbm.LightGBMClassifierModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
| [XGBClassifierModel](https://unit8co.github.io/darts/generated_api/darts.models.forecasting.xgboost.html#darts.models.forecasting.xgboost.XGBClassifierModel) | | ✅ ✅ | ✅ ✅ ✅ | ✅ ✅ | ✅ |
## 커뮤니티 및 연락처
누구나 [Gitter 룸](https://gitter.im/u8darts/darts)에 참여하여 질문하고, 제안하며,
사용 사례를 논의하는 등 다양한 활동을 할 수 있습니다. 버그를 발견하거나 제안 사항이 있다면 GitHub 이슈도 환영합니다.
전하고 싶은 내용이 Gitter나 GitHub에 적합하지 않다면,
darts 관련 사항은 <a href="mailto:[email protected]">[email protected]</a>로,
기타 문의 사항은 <a href="mailto:[email protected]">[email protected]</a>로 이메일을 보내주시기 바랍니다.
## 기여
개발은 지속적으로 진행 중이며, GitHub에서 제안, 풀 리퀘스트, 이슈를 환영합니다.
모든 기여자는
[변경 로그 페이지](https://github.com/unit8co/darts/blob/master/CHANGELOG.md)에 기재됩니다.
기여(새 기능 또는 수정)를 시작하기 전에
[기여 지침을 확인](https://github.com/unit8co/darts/blob/master/CONTRIBUTING.md)하세요.
## 인용
과학적 연구에 Darts를 사용하신다면 다음 JMLR 논문을 인용해 주시면 감사하겠습니다.
[Darts: User-Friendly Modern Machine Learning for Time Series](https://www.jmlr.org/papers/v23/21-1177.html)
Bibtex 항목(GitHub의 저장소 인용 기능을 통해 직접 복사할 수도 있습니다):```
@article{Herzen_Darts_User-Friendly_Modern_2022,
author = {Herzen, Julien and Lässig, Francesco and Piazzetta, Samuele Giuliano and Neuer, Thomas and Tafti, Léo and Raille, Guillaume and Van Pottelbergh, Tomas and Pasieka, Marek and Skrodzki, Andrzej and Huguenin, Nicolas and Dumonal, Maxime and Kościsz, Jan and Bader, Dennis and Gusset, Frédérick and Benheddi, Mounir and Williamson, Camila and Kosinski, Michal and Petrik, Matej and Grosch, Gaël},
journal = {Journal of Machine Learning Research},
number = {124},
pages = {1--6},
title = {{Darts: User-Friendly Modern Machine Learning for Time Series}},
url = {https://jmlr.org/papers/v23/21-1177.html},
volume = {23},
year = {2022}
}