GAMLSSRegression<T>
Models & Types · AiDotNet.Regression
GAMLSS (Generalized Additive Models for Location, Scale, and Shape) regression.
Inheritance: AsyncDecisionTreeRegressionBase<T> → GAMLSSRegression<T>
For Beginners
Traditional regression models predict a single value (the mean). GAMLSS predicts an entire probability distribution by modeling multiple parameters:
- Location (μ): Controls where the distribution is centered (like the mean)
- Scale (σ): Controls how spread out the distribution is (like standard deviation)
- Shape (ν, τ): Controls the shape (skewness, tail behavior)
This is powerful because:
- You get uncertainty estimates that vary with your inputs
- You can model phenomena where variance depends on the predictors
- You get proper prediction intervals instead of assuming constant variance
Example use cases:
- Financial forecasting where volatility depends on market conditions
- Medical studies where patient variability depends on treatment
- Any scenario where “it depends” applies to uncertainty, not just the average
How It Works
GAMLSS extends generalized linear models by allowing any or all distribution parameters to be modeled as functions of the explanatory variables. This enables heteroskedastic modeling and full distributional regression.
Reference: Rigby, R.A., Stasinopoulos, D.M. (2005). “Generalized additive models for location, scale and shape”. Applied Statistics, 54, 507-554.
Example
using AiDotNet;
using AiDotNet.Data.Loaders;
using AiDotNet.Regression;
using AiDotNet.Tensors.LinearAlgebra;
double[][] features =
{
new[] { 1.0, 2.0 }, new[] { 2.0, 3.0 }, new[] { 3.0, 4.0 },
new[] { 4.0, 5.0 }, new[] { 5.0, 6.0 }, new[] { 6.0, 7.0 }
};
double[] targets = { 3.0, 5.0, 7.0, 9.0, 11.0, 13.0 };
var result = await new AiModelBuilder<double, Matrix<double>, Vector<double>>()
.ConfigureModel(new GAMLSSRegression<double>())
.ConfigureDataLoader(DataLoaders.FromArrays(features, targets))
.BuildAsync();
Console.WriteLine("Trained GAMLSSRegression.");
Constructors
| Constructor | Summary |
|---|---|
GAMLSSRegression(GAMLSSOptions options, IRegularization<T, Matrix<T>, Vector<T>> regularization) |
Initializes a new instance of GAMLSSRegression. |
Properties
| Property | Summary |
|---|---|
Vector<T> LocationCoefficients { get; } |
Gets the location (mean) model coefficients. |
Vector<T> ScaleCoefficients { get; } |
Gets the scale model coefficients. |
int NumberOfTrees { get; } |
Methods
| Method | Summary |
|---|---|
ModelMetadata<T> GetModelMetadata() |
|
Task TrainAsync(Matrix<T> x, Vector<T> y) |
|
Task<IParametricDistribution<T>[]> PredictDistributionsAsync(Matrix<T> input) |
Predicts full probability distributions for each input sample. |
Task<ValueTuple<Vector<T>, Vector<T>>> PredictIntervalAsync(Matrix<T> input, double confidenceLevel) |
Gets prediction intervals for each input sample. |
Task<Vector<T>> PredictAsync(Matrix<T> input) |