FiveParameterLogisticCurve Class

Represents a five-parameter logistic (5PL) curve with asymmetry factor for dose-response modeling.

Definition

Namespace: Numerics.NET.Curves.Nonlinear
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 10.0.0
C#
public class FiveParameterLogisticCurve : NonlinearCurve
Inheritance
Object  →  Curve  →  NonlinearCurve  →  FiveParameterLogisticCurve

Remarks

Use the FiveParameterLogisticCurve class to fit a five-parameter logistic curve to asymmetric dose-response data. This extends the standard 4PL model by adding an asymmetry parameter (s) that allows the curve to have different slopes on the ascending and descending portions.

Equation:

y = A₂ + (A₁ - A₂) / (1 + (x/x₀)^p)^s

Parameters:

  • A₁ – Upper asymptote (maximum response)
  • A₂ – Lower asymptote (minimum response, baseline)
  • x₀ – Inflection point (EC₅₀, IC₅₀, or ED₅₀)
  • p – Hill slope (steepness factor)
  • s – Asymmetry factor (s = 1 reduces to 4PL; s ≠ 1 creates asymmetry)

Applications:

  • Asymmetric dose-response curves in pharmacology
  • ELISA curves with asymmetric behavior
  • Bioassays with non-standard kinetics
  • Receptor binding with complex mechanisms
  • Growth curves with asymmetric transitions

The asymmetry parameter (s) provides flexibility for data that doesn't follow the symmetric pattern of the standard 4PL curve. When s = 1, the 5PL reduces to the 4PL model. Values of s > 1 create a sharper transition on one side, while s < 1 creates a more gradual transition.

When to Use 5PL vs 4PL: Use the 5PL model when visual inspection or residual analysis of a 4PL fit shows systematic deviation indicating asymmetry. However, be aware that the additional parameter increases the risk of overfitting with limited data. Compare model fit statistics (AIC, BIC) to determine if the additional complexity is justified.

.

For details on how to fit a curve of this type, see the NonlinearCurveFitter class.

Constructors

FiveParameterLogisticCurve Constructs a new logistic curve.

Properties

AsymmetryFactor Gets or sets the asymmetry
Center Gets or sets the center of the logistic curve.
FinalValue Gets or sets the initial value of the logistic curve.
HillSlope Gets or sets the Hill slope of the logistic curve.
InitialValue Gets or sets the initial value of the logistical curve.
Parameters Gets the collection of parameters that determine the shape of this Curve.
(Inherited from Curve)

Methods

Clone Constructs an exact copy of this instance.
(Inherited from Curve)
EqualsDetermines whether the specified object is equal to the current object.
(Inherited from Object)
FillNumericalPartialDerivatives Fills a dense vector with the partial derivatives of the curve with respect to each of the curve parameters computed using numerical differentiation.
(Inherited from NonlinearCurve)
FillPartialDerivatives Fills a dense vector with the partial derivatives of the curve with respect to each of the curve parameters.
(Overrides NonlinearCurve.FillPartialDerivatives(Double, DenseVector<Double>))
FinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.
(Inherited from Object)
FindRoots Gets the set of X-coordinates where the curve crosses the X-axis.
(Inherited from Curve)
GetCurveFitter Returns a CurveFitter object that can be used to fit the curve to data.
(Inherited from NonlinearCurve)
GetDerivative Returns a Curve that represents the derivative of this Curve.
(Inherited from Curve)
GetHashCodeServes as the default hash function.
(Inherited from Object)
GetInitialFitParameters Returns a vector containing initial values for the parameters for a curve fit through on the specified data.
(Overrides NonlinearCurve.GetInitialFitParameters(Vector<Double>, Vector<Double>))
GetPartialDerivatives Returns a vector with the partial derivatives of the curve with respect to each of the curve parameters.
(Inherited from NonlinearCurve)
GetTypeGets the Type of the current instance.
(Inherited from Object)
Integral Gets the definite integral of the curve between the specified X-coordinates.
(Inherited from Curve)
MemberwiseCloneCreates a shallow copy of the current Object.
(Inherited from Object)
OnParameterChanged Called after a Curve parameter has been changed.
(Inherited from Curve)
OnParameterChanging Called before the value of a curve parameter is changed.
(Inherited from Curve)
SetParameter Sets a curve parameter to the specified value.
(Inherited from Curve)
SlopeAt(Double[]) Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve)
SlopeAt(Double) Gets the slope of the curve at the specified X-coordinate.
(Overrides Curve.SlopeAt(Double))
SlopeAt(ReadOnlySpan<Double>) Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve)
SlopeAt(Vector<Double>) Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve)
SlopeAt(ReadOnlySpan<Double>, Span<Double>) Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve)
Solve Finds the x value where the curve reaches the specified y value.
(Inherited from Curve)
TangentAt Gets the tangent line to the curve at the specified X-coordinate.
(Inherited from Curve)
ToStringReturns a string that represents the current object.
(Inherited from Object)
ValueAt(Double[]) Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve)
ValueAt(Double) Gets the Y-value of the curve at the specified X-coordinate.
(Overrides Curve.ValueAt(Double))
ValueAt(ReadOnlySpan<Double>) Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve)
ValueAt(Vector<Double>) Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve)
ValueAt(ReadOnlySpan<Double>, Span<Double>) Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve)

See Also