LinearCapAndLagModel#

Linear-softplus growth fitter with a softplus saturation ceiling.

Parameters and usage: LinearCapAndLagModel.

  • One row per: fitted group (the groupby columns)

  • Written to: the frame analyze() returns; when it is the pipeline’s model, a CLI run writes deliverables/LinearCapAndLagModel.csv and .parquet

  • Columns: 14, each a pattern (see Placeholders)

Placeholders

Some column names depend on how you run the operation. They are shown as patterns, with these placeholders:

<metric>

The fitted column without its metric-family prefix: fitting Size_Area writes LinearCapAndLagModel_Area_v.

LINEAR_CAP_AND_LAG_MODEL#

Metric family: LinearCapAndLagModel#

Column

Description

Type

LinearCapAndLagModel_<metric>_v

The post-lag phase growth rate.

Tier 1 · Direct phenotype

LinearCapAndLagModel_<metric>_s0

The initial size

Tier 1 · Direct phenotype

LinearCapAndLagModel_<metric>_lambda

The duration of the lag phase

Tier 1 · Direct phenotype

LinearCapAndLagModel_<metric>_alpha

lag phase transition sharpness

Tier 2 · Descriptive trait

LinearCapAndLagModel_<metric>_smax

Carrying capacity used by the model. Either the user-provided scalar or the per-group observed maximum.

Tier 1 · Direct phenotype

LinearCapAndLagModel_<metric>_beta

Saturation transition sharpness. Fitted per-group when a saturation shoulder is detected and beta is None at construction; held at the user-provided scalar (or the module default) when no shoulder is present.

Tier 2 · Descriptive trait

LinearCapAndLagModel_<metric>_mode

Fit variant selected per-group: ‘fixed_beta’ (beta held at the user-provided or module-default value) or ‘fitted_beta’ (beta fitted as a 5th free parameter when a saturation shoulder is detected).

Quality

MODEL_METRICS#

Every growth model writes these columns; see Shared columns.

Metric family: ModelMetrics#

Column

Description

Type

ModelMetrics_<metric>_MAE

The mean absolute error

Quality

ModelMetrics_<metric>_MSE

The mean squared error

Quality

ModelMetrics_<metric>_RMSE

The root mean squared error

Quality

ModelMetrics_<metric>_R2

The coefficient of determination

Quality

ModelMetrics_<metric>_NumSamples

The number of samples used for model fitting

Quality

ModelMetrics_<metric>_OptimizerLoss

The loss of model fitting

Quality

ModelMetrics_<metric>_OptimizerStatus

The output of the optimizer status

Quality