ARMAModel<T>
Models & Types · AiDotNet.TimeSeries
Implements an ARMA (AutoRegressive Moving Average) model for time series forecasting.
Inheritance: TimeSeriesModelBase<T> → ARMAModel<T>
Implements: IGeneratedParameterRegistrar<T>
How It Works
ARMA models combine two components to forecast time series data:
- AR (AutoRegressive): Uses the relationship between an observation and a number of lagged observations
- MA (Moving Average): Uses the relationship between an observation and residual errors from moving average model
For Beginners: The ARMA model is a popular method for analyzing and forecasting time series data (data collected over time, like daily temperatures, stock prices, or monthly sales).
Think of ARMA as combining two different approaches:
- AutoRegressive (AR): This component predicts future values based on past values.
For example, tomorrow’s temperature might be related to today’s temperature. If it’s hot today, it’s likely to be hot tomorrow as well.
- Moving Average (MA): This component predicts future values based on past prediction errors.
For example, if we consistently underestimate temperature, the MA component helps adjust our future predictions upward.
The model has two key parameters:
- p: The AR order - how many past values to consider
- q: The MA order - how many past prediction errors to consider
Unlike ARIMA, ARMA doesn’t include the differencing (I) component, so it works best with time series data that is already stationary (doesn’t have strong trends).
Example
using AiDotNet;
using AiDotNet.Data.Loaders;
using AiDotNet.TimeSeries;
using AiDotNet.Tensors.LinearAlgebra;
double[] series =
{
120, 135, 148, 160, 155, 170, 180, 195, 210, 198, 220, 235,
140, 155, 165, 178, 172, 190, 200, 215, 230, 218, 245, 260
};
var x = new Matrix<double>(series.Length, 1);
for (int i = 0; i < series.Length; i++) x[i, 0] = i;
var result = await new AiModelBuilder<double, Matrix<double>, Vector<double>>()
.ConfigureModel(new ARMAModel<double>())
.ConfigureDataLoader(DataLoaders.FromMatrixVector(x, new Vector<double>(series)))
.BuildAsync();
var forecast = result.Predict(new Matrix<double>(6, 1));
Console.WriteLine($"ARMAModel: forecast {forecast.Length} steps.");
Constructors
| Constructor | Summary |
|---|---|
ARMAModel() |
Initializes a new instance with default settings. |
ARMAModel(ARMAOptions<T> options) |
Creates a new ARMA model with the specified options. |
Methods
| Method | Summary |
|---|---|
Dictionary<string, T> EvaluateModel(Matrix<T> xTest, Vector<T> yTest) |
Evaluates the model’s performance on test data. |
ModelMetadata<T> GetModelMetadata() |
Gets metadata about the trained model, including its type, coefficients, and configuration. |
T PredictSingle(Vector<T> input) |
Predicts a single value based on a single input vector. |
Vector<T> Forecast(Vector<T> history, int horizon) |
Predicts future values based on a history of time series data. |
Vector<T> Predict(Matrix<T> input) |
Makes predictions using the trained ARMA model. |
string ToString() |
Returns a string representation of the ARMA model. |