OrdinalRegressionOptions<T>

Options & Configuration · AiDotNet.Models.Options

Configuration options for Ordinal Regression (Proportional Odds Model), a classification method for predicting ordered categorical outcomes.

Inheritance: ModelOptions → ClassifierOptions<T> → OrdinalRegressionOptions<T>

For Beginners

Ordinal Regression is the right choice when:

  • Your categories have a natural order (1 < 2 < 3 < 4 < 5)
  • The distances between categories may not be equal
  • You want predictions that respect the ordering

Examples:

  • Customer satisfaction: Very Unsatisfied, Unsatisfied, Neutral, Satisfied, Very Satisfied
  • Movie ratings: 1 star, 2 stars, 3 stars, 4 stars, 5 stars
  • Pain levels: None, Mild, Moderate, Severe
  • Education level: High School, Some College, Bachelor’s, Master’s, PhD

The model learns “thresholds” that separate the ordered categories. Each feature can push predictions up or down the ordinal scale.

How It Works

Ordinal Regression is used when the target variable has naturally ordered categories, such as survey responses (strongly disagree to strongly agree), star ratings (1-5 stars), or disease severity (none, mild, moderate, severe). Unlike regular classification which ignores the order, ordinal regression models the cumulative probabilities using ordered thresholds.

The model uses the proportional odds (cumulative logit) assumption: P(Y ≤ k) = sigmoid(α_k - β^T × x) where α_k are ordered thresholds (cutpoints) and β are the feature coefficients.

Constructors

Constructor Summary
OrdinalRegressionOptions()

Properties

Property Summary
OrdinalLinkFunction LinkFunction { get; set; } Gets or sets the link function type for the ordinal regression.
bool FitIntercept { get; set; } Gets or sets whether to fit an intercept term.
double LearningRate { get; set; } Gets or sets the learning rate for gradient descent optimization.
double RegularizationStrength { get; set; } Gets or sets the regularization strength (L2 penalty).
double Tolerance { get; set; } Gets or sets the convergence tolerance for the optimization algorithm.
int MaxIterations { get; set; } Gets or sets the maximum number of iterations for the optimization algorithm.