Seasonality Decomposition Attribution applies classical signal decomposition—typically STL (Seasonal-Trend decomposition using LOESS) or additive/multiplicative models—to the input or output of a forecasting model. By separating the raw prediction into a long-term trend, a repeating seasonal cycle, and an irregular residual component, practitioners can quantify exactly how much of the forecasted value is driven by cyclical behavior versus a secular directional shift. This is critical for distinguishing a model's reliance on recurring patterns from its reaction to genuine anomalies.
Glossary
Seasonality Decomposition Attribution

What is Seasonality Decomposition Attribution?
Seasonality Decomposition Attribution is a model-agnostic interpretability technique that isolates a time-series forecast into its constituent trend, seasonal, and residual components to attribute the prediction's magnitude to these distinct underlying temporal patterns.
In enterprise finance and IoT analytics, this method provides auditable forecast transparency. For example, a demand forecast might be decomposed to show that 70% of the predicted spike is attributable to a known weekly seasonality, while 30% stems from a recent upward trend. This prevents operators from misinterpreting routine cyclicality as a structural change. The technique is often paired with temporal SHAP or forecast error contribution to further attribute the residual component to specific lagged features or exogenous shocks.
Key Characteristics
Seasonality decomposition attribution dissects a time-series prediction into its constituent structural components, enabling precise identification of whether a forecast is driven by long-term trends, cyclical patterns, or irregular noise.
Additive vs. Multiplicative Decomposition
The foundational distinction in decomposition logic. Additive models assume the seasonal amplitude is constant over time (y = Trend + Seasonality + Residual), while multiplicative models assume the amplitude scales with the trend level (y = Trend × Seasonality × Residual).
- Additive: Best for series with stable variance, like daily temperature anomalies
- Multiplicative: Best for series with exponential growth, like e-commerce revenue
- Pseudo-additive: A hybrid for series with zero values where multiplicative fails
The choice directly impacts how attribution scores are distributed across components.
STL Decomposition
Seasonal-Trend decomposition using LOESS is a robust, iterative algorithm that handles any seasonal periodicity and is resilient to outliers. Unlike classical methods, STL allows the seasonal component to evolve over time.
- Inner loop: Updates trend and seasonal components via LOESS smoothing
- Outer loop: Computes robustness weights to downweight outliers
- Attribution: Each time step's prediction is partitioned into trend, seasonal, and residual contributions
STL is the default choice for complex real-world series where seasonality is not strictly fixed.
Seasonal Component Attribution
The seasonal component captures periodic fluctuations of a fixed and known frequency—daily, weekly, monthly, or quarterly cycles. Attribution to this component answers: 'How much of this forecast is due to recurring calendar effects?'
- Fourier decomposition: Represents seasonality as a sum of sine/cosine waves
- Dummy variable regression: Encodes seasons as binary indicators
- Periodogram analysis: Identifies dominant frequencies in the spectrum
In forecasting models like Prophet or SARIMA, the seasonal attribution is explicitly parameterized and directly extractable.
Trend-Cycle Attribution
The trend-cycle component represents the long-term directional movement of the series after removing seasonal and irregular effects. It captures structural changes, economic expansions, or technology adoption curves.
- Henderson filters: Symmetric weighted moving averages that preserve local trends
- Hodrick-Prescott filter: Separates trend from cycle via a smoothing penalty
- Breakpoint detection: Identifies structural shifts where the trend changes slope
Attribution to the trend reveals whether a model's forecast is extrapolating a genuine long-run signal or overfitting to transient drift.
Residual and Irregular Attribution
The residual component captures stochastic noise—the unexplained variance after extracting trend and seasonality. High attribution to the residual signals either genuine randomness or model misspecification.
- White noise testing: Ljung-Box test checks if residuals are independently distributed
- Heteroskedasticity: Non-constant residual variance indicates unmodeled volatility
- Outlier attribution: Isolated spikes in residuals can be traced to specific events
A well-specified model should have residuals that are stationary with zero mean. Persistent structure in residuals indicates an omitted component.
Forecast Reconciliation via Decomposition
In hierarchical forecasting, decomposition attribution ensures coherence across aggregation levels. The sum of component attributions at a lower level must equal the attribution at the higher level.
- Bottom-up: Forecast components at the granular level and aggregate
- Top-down: Decompose the aggregate forecast and distribute to sub-series
- Optimal reconciliation: Minimizes a loss function to balance both approaches
This is critical for supply chain and retail forecasts where SKU-level, category-level, and regional predictions must be mutually consistent.
Frequently Asked Questions
Clear, technically precise answers to the most common questions about isolating and attributing model predictions to trend, seasonal, and residual components in time-series analysis.
Seasonality decomposition attribution is a model interpretability technique that isolates a time series into its constituent trend, seasonal, and residual components and then quantifies how much each component contributes to a forecasting model's specific prediction. The process typically involves two stages: first, a classical decomposition algorithm like STL (Seasonal-Trend decomposition using LOESS) or X-11-ARIMA separates the raw input signal into additive or multiplicative components. Second, an attribution method—such as Shapley values or integrated gradients—is applied to the model's output, with the decomposed components treated as distinct feature groups. This allows an engineer to state, for example, that 60% of a demand spike prediction is driven by the seasonal pattern, 30% by the upward trend, and 10% by an irregular residual anomaly. The technique is critical for auditing forecasts in finance and IoT, where distinguishing a genuine trend shift from a predictable cyclical pattern determines operational decisions.
Comparison with Related Attribution Methods
How seasonality decomposition attribution compares to other time-series interpretability methods across key operational dimensions
| Feature | Seasonality Decomposition Attribution | Temporal SHAP | Attention Flow | Time-Step Ablation |
|---|---|---|---|---|
Decomposition granularity | Trend, seasonal, residual components | Individual time-step Shapley values | Layer-wise attention weight propagation | Binary importance per time step |
Handles periodic patterns | ||||
Model-agnostic | ||||
Computational cost | Low (deterministic decomposition) | High (requires many perturbations) | Medium (single forward pass) | High (N forward passes for N steps) |
Provides counterfactual insight | ||||
Native support for multi-seasonality | ||||
Explanation faithfulness score | 0.87 (component-wise) | 0.92 (Shapley axioms) | 0.74 (attention entropy) | 0.81 (occlusion correlation) |
Output interpretable by non-experts |
Enabling Efficiency, Speed & Accuracy
Intelligent Analysis, Decision & Execution
We build AI systems for teams that need search across company data, workflow automation across tools, or AI features inside products and internal software.
Talk to Us
Search across company data
Give teams answers from docs, tickets, runbooks, and product data with sources and permissions.
Useful when people spend too long searching or get different answers from different systems.

Automate internal workflows
Use AI to route work, draft outputs, trigger actions, and keep approvals and logs in place.
Useful when repetitive work moves across multiple tools and teams.

Add AI to products and internal tools
Build assistants, guided actions, or decision support into the software your team or customers already use.
Useful when AI needs to be part of the product, not a separate tool.
Related Terms
Core concepts and complementary techniques for isolating and attributing model predictions to the distinct trend, seasonal, and residual components of a time series.
Classical Decomposition
The foundational statistical process that separates a time series into trend, seasonal, and residual components using moving averages or LOESS smoothing.
- Additive Model: Assumes components sum together (Y = T + S + R), used when seasonal magnitude is constant.
- Multiplicative Model: Assumes components multiply (Y = T × S × R), used when seasonal magnitude scales with trend.
- Forms the preprocessing backbone for many attribution techniques by providing structured input features to the model.
STL Decomposition
Seasonal-Trend decomposition using LOESS is a robust, iterative filtering method that handles any seasonal periodicity and is resilient to outliers.
- Uses locally weighted regression to extract smooth trend and seasonal curves.
- Unlike classical methods, STL can model time-varying seasonality where the seasonal pattern evolves.
- Often paired with forecasting models like Prophet or ETS; attribution then maps prediction variance back to the decomposed STL components.
Prophet Component Attribution
Meta's Prophet library natively decomposes forecasts into trend, weekly/yearly seasonality, and holiday effects using a generalized additive model.
- Each component is a separate, interpretable function with its own parameters.
- Attribution is direct: the model's prediction is the sum of component outputs, so the contribution of a holiday or seasonal cycle is explicitly quantified.
- Enables business users to ask 'How much of this spike is due to Black Friday versus the underlying growth trend?'
Residual Analysis
The systematic examination of the irregular component remaining after trend and seasonality are removed, used to validate model fit and diagnose unexplained variance.
- White Noise Check: Residuals should have zero mean, constant variance, and no autocorrelation if the decomposition is complete.
- Attribution Signal: Large residuals at specific time steps indicate events the decomposition missed—external shocks, outliers, or structural breaks—that the model cannot explain.
- Drives feature engineering by identifying missing exogenous variables.
Fourier Series Seasonality
A mathematical approach that models seasonal patterns as a sum of sine and cosine waves with different frequencies, rather than discrete dummy variables.
- Captures smooth, continuous cyclical behavior with far fewer parameters than one-hot encoded periods.
- Harmonic Order: Controls the complexity of the seasonal curve; higher orders fit more intricate patterns.
- Attribution involves decomposing the model's prediction into the amplitude and phase contribution of each Fourier harmonic, revealing which frequencies dominate the forecast.
Hodrick-Prescott Filter
A mathematical tool that extracts the long-term trend component by solving an optimization problem that balances fit to the data against smoothness of the trend.
- Controlled by a smoothing parameter (λ) that penalizes acceleration in the trend; higher λ produces a more linear trend.
- Commonly used in macroeconomics to separate cyclical fluctuations from the structural growth path.
- In attribution workflows, the HP trend serves as a baseline counterfactual: 'What would the model predict if only the smooth trend existed?'

About the author
Prasad Kumkar
CEO & MD, Inference Systems
Prasad Kumkar is the CEO & MD of Inference Systems and writes about AI systems architecture, LLM infrastructure, model serving, evaluation, and production deployment. Over 5+ years, he has worked across computer vision models, L5 autonomous vehicle systems, and LLM research, with a focus on taking complex AI ideas into real-world engineering systems.
His work and writing cover AI systems, large language models, AI agents, multimodal systems, autonomous systems, inference optimization, RAG, evaluation, and production AI engineering.
Partnered with leading AI, data, and software stack.
How We Work
Custom AI workflows for your Business
One-fit-all AI don't work for modern businesses. At Inferensys, we aim to understand your business & custom requirements; which we use to define most efficient agentic workflows, the data, and the tools for your business.
01
Review the use case
We understand the task, the users, and where AI can actually help.
Read more02
Pick the right approach
We define what needs search, automation, or product integration.
Read more03
Build the first useful version
We implement the part that proves the value first.
Read more04
Improve from there
We add the checks and visibility needed to keep it useful.
Read moreThe first call is a practical review of your use case and the right next step.
Talk to Us