DampedSineCurve Class

Represents a damped sine wave curve used for modeling oscillatory phenomena with exponential decay.

Definition

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

Remarks

Use the DampedSineCurve class to represent a five-parameter damped sinusoidal curve commonly encountered in physics and engineering when modeling oscillatory systems with damping.

A damped sine wave describes oscillations whose amplitude decreases exponentially over time, typical of systems with friction, resistance, or energy dissipation. Examples include the motion of a damped harmonic oscillator, RLC circuits, and mechanical vibrations.

The equation is:

y(x) = A e^{-kx} \sin\left(\frac{2\pi x}{T} + \phi\right) + C

Parameters:

  • A – Initial amplitude (amplitude at x = 0). See Amplitude.
  • k – Damping coefficient (rate of exponential decay). See DampingCoefficient.
  • T – Period (determines oscillation rate). See Period.
  • φ – Phase offset (horizontal shift of the oscillation). See PhaseOffset.
  • C – Baseline offset (equilibrium position). See Offset.

Applications:

  • RLC electrical circuits
  • Mechanical vibrations and damped oscillators
  • Seismic wave analysis
  • Signal processing and decay analysis
  • Acoustic resonance
  • Quantum mechanics (wave packet decay)

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

Constructors

DampedSineCurve Constructs a new damped sine wave curve.

Properties

Amplitude Gets or sets the initial amplitude (A).
DampingCoefficient Gets or sets the damping coefficient (k).
Offset Gets or sets the baseline offset (C).
Parameters Gets the collection of parameters that determine the shape of this Curve.
(Inherited from Curve)
Period Gets or sets the period (T).
PhaseOffset Gets or sets the phase offset (φ).

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 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)
NormalizeParameters Normalize damped sine parameters to a canonical form: A ≥ 0, T > 0, φ ∈ (-π, π]. This removes sign and 2π ambiguities between amplitude, period, and phase.
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