UnobservedComponentsOptions<T, TInput, TOutput>
Options & Configuration · AiDotNet.Models.Options
Configuration options for Unobserved Components Models (UCM), which decompose time series into trend, seasonal, cycle, and irregular components.
Inheritance: ModelOptions → RegressionOptions<T> → TimeSeriesRegressionOptions<T> → UnobservedComponentsOptions<T, TInput, TOutput>
For Beginners
Unobserved Components Models help you break down time series data into meaningful parts.
When analyzing time series data:
- It’s often useful to separate the data into different components
- These components aren’t directly observable but can be estimated
UCM decomposes time series into:
- Trend: The long-term direction (upward, downward, or stable)
- Seasonal: Regular patterns that repeat at fixed intervals (daily, weekly, monthly, etc.)
- Cycle: Irregular fluctuations that don’t have a fixed period
- Irregular: Random noise or unexplained variation
This approach offers several benefits:
- Better understanding of what drives the time series
- Improved forecasting by modeling each component separately
- Ability to detect structural changes over time
- Flexibility to include or exclude components based on domain knowledge
This class lets you configure which components to include and how to estimate them.
How It Works
Unobserved Components Models (UCM), also known as Structural Time Series Models, provide a flexible framework for decomposing time series data into distinct components that are not directly observable. These components typically include trend (long-term movement), seasonal (regular patterns at fixed intervals), cycle (irregular fluctuations of varying length), and irregular (random noise) components. UCM is particularly useful for understanding the underlying structure of time series data, forecasting, and detecting structural changes. This approach is based on state space models and is often estimated using the Kalman filter. This class provides configuration options for controlling the components included in the model and the estimation process.
Constructors
| Constructor | Summary |
|---|---|
UnobservedComponentsOptions() |
Initializes a new instance with the UnobservedComponents defaults. |
UnobservedComponentsOptions(UnobservedComponentsOptions<T, TInput, TOutput> other) |
Initializes a new instance as a copy of other, with every setting copied. |
Properties
| Property | Summary |
|---|---|
IMatrixDecomposition<T> Decomposition { get; set; } |
Gets or sets the matrix decomposition method used in the estimation algorithm. |
IOptimizer<T, Matrix<T>, Vector<T>> Optimizer { get; set; } |
Gets or sets the optimizer used for parameter estimation. |
bool IncludeCycle { get; set; } |
Gets or sets a value indicating whether to include a cycle component in the model. |
bool OptimizeParameters { get; set; } |
Gets or sets a value indicating whether to optimize the model parameters. |
double CycleLambda { get; set; } |
Gets or sets the smoothing parameter for the cycle component. |
int CycleMaxPeriod { get; set; } |
Gets or sets the maximum period for the cycle component. |
int CycleMinPeriod { get; set; } |
Gets or sets the minimum period for the cycle component. |
int MaxIterations { get; set; } |
Gets or sets the maximum number of iterations for the estimation algorithm. |