Richards Curve Class
Definition
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 10.0.0
public class RichardsCurve : NonlinearCurve- Inheritance
- Object → Curve → NonlinearCurve → RichardsCurve
Remarks
Use the RichardsCurve class to represent a five-parameter Richards curve, also known as the generalized logistic curve. It provides a flexible family of sigmoidal curves that includes the logistic and Gompertz curves as special cases.
The Richards curve is widely used in growth modeling because it can accommodate asymmetric growth patterns through its shape parameter ν. When ν = 1, it reduces to the logistic curve; as ν approaches infinity, it approaches the Gompertz curve; and when ν = 2, it yields a symmetric curve similar to the logistic but with different parameterization.
The equation is:
y(x) = A \left(1 + \nu e^{-k(x-x_0)}\right)^{-1/\nu} + CParameters:
- A – Upper asymptote (maximum value minus baseline). See Amplitude.
- ν – Shape parameter (controls asymmetry). See Shape.
- k – Growth rate parameter. See GrowthRate.
- x₀ – Inflection point location. See InflectionPoint.
- C – Baseline offset (lower asymptote). See Offset.
Applications:
- Flexible growth modeling (population, tumor, crop)
- Pharmacokinetic dose-response with asymmetry
- Epidemic modeling with varied progression rates
- Product adoption curves
- Learning curves and skill acquisition
For details on how to fit a curve of this type, see the NonlinearCurveFitter class.
Constructors
| Richards | Constructs a new Richards curve. |
Properties
| Amplitude | Gets or sets the upper asymptote amplitude (A). |
| Growth | Gets or sets the growth rate (k). |
| Inflection | Gets or sets the inflection point location (x₀). |
| Offset | Gets or sets the baseline offset (C). |
| Parameters |
Gets the collection of parameters that determine the shape of this
Curve.
(Inherited from Curve) |
| Shape | Gets or sets the shape parameter (ν). |
Methods
| Clone |
Constructs an exact copy of this instance.
(Inherited from Curve) |
| Equals | Determines whether the specified object is equal to the current object. (Inherited from Object) |
| Fill |
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) |
| Fill |
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>)) |
| Finalize | Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object) |
| Find |
Gets the set of X-coordinates where the curve crosses
the X-axis.
(Inherited from Curve) |
| Get |
Returns a CurveFitter object that can be used to fit the curve to data.
(Inherited from NonlinearCurve) |
| Get |
Returns a Curve that represents the derivative
of this Curve.
(Inherited from Curve) |
| Get | Serves as the default hash function. (Inherited from Object) |
| Get |
Returns a vector containing initial values for the parameters for a curve fit
through the specified data.
(Overrides NonlinearCurve.GetInitialFitParameters(Vector<Double>, Vector<Double>)) |
| Get |
Returns a vector with the partial derivatives
of the curve with respect to each of the curve parameters.
(Inherited from NonlinearCurve) |
| Get | Gets 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) |
| Memberwise | Creates a shallow copy of the current Object. (Inherited from Object) |
| OnParameter |
Called after a Curve parameter has been changed.
(Inherited from Curve) |
| OnParameter |
Called before the value of a curve parameter is changed.
(Inherited from Curve) |
| Set |
Sets a curve parameter to the specified value.
(Inherited from Curve) |
| Slope |
Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve) |
| Slope |
Gets the slope of the curve at the specified X-coordinate.
(Overrides Curve.SlopeAt(Double)) |
| Slope |
Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve) |
| Slope |
Gets the slopes of the curve at the specified X-coordinates.
(Inherited from Curve) |
| Slope |
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) |
| Tangent |
Gets the tangent line to the curve at the
specified X-coordinate.
(Inherited from Curve) |
| ToString | Returns a string that represents the current object. (Inherited from Object) |
| Value |
Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve) |
| Value |
Gets the Y-value of the curve at the specified X-coordinate.
(Overrides Curve.ValueAt(Double)) |
| Value |
Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve) |
| Value |
Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve) |
| Value |
Gets the Y-values of the curve at the specified X-coordinates.
(Inherited from Curve) |