systems.builtin.deterministic.continuous.VanDerPolOscillator
systems.builtin.deterministic.continuous.VanDerPolOscillator(*args, **kwargs)Van der Pol oscillator - self-excited nonlinear oscillator with limit cycle.
Physical System:
Originally meant to model electronic oscillator circuits. The system exhibits self-sustained oscillations.
The key feature is nonlinear damping: - Near origin: negative damping (pumps energy in) - Far from origin: positive damping (dissipates energy) - Result: stable limit cycle (periodic orbit)
State Space:
State: x = [x, y] - x: Primary variable [V or dimensionless] * In electrical circuit: voltage or current * In general: oscillating quantity
- y: Derivative-related variable [V/s or dimensionless]
* y ≈ ẋ for μ → 0
* Not exactly velocity for μ > 0 (includes nonlinear term)
Output: y_out = [x] - Measures only x (the oscillating variable) - Partial observation (y not directly measured)
Dynamics:
The Van der Pol equation in standard form:
ẋ = y
ẏ = μ(1 - x²)y - x
Or as a second-order ODE: ẍ - μ(1 - x²)ẋ + x = 0
First equation: Simply defines y ≈ ẋ
Second equation: - μ(1 - x²)y: Nonlinear damping (Van der Pol term) * When |x| < 1: (1 - x²) > 0 → negative damping (adds energy) * When |x| > 1: (1 - x²) < 0 → positive damping (removes energy) * Balance creates stable limit cycle
- -x: Linear restoring force (like harmonic oscillator)
- Provides natural frequency ω₀ ≈ 1
Parameters:
mu : float, default=1.0 Nonlinearity parameter [dimensionless]. Controls strength of nonlinear damping and oscillation shape:
- **μ → 0**: Nearly sinusoidal (harmonic oscillator)
* Period T ≈ 2π
* Smooth, sinusoidal limit cycle
- **μ = 1**: Standard Van der Pol
* Period T ≈ 6.7
* Mildly distorted sinusoid
- **μ >> 1**: Relaxation oscillations
* Period T ≈ (3 - 2ln(2))μ ≈ 1.614μ
* Sharp "fast" and "slow" phases
* Almost discontinuous (spikes and plateaus)
Behavior Regimes:
1. Small μ (μ < 0.1): Harmonic-like - Nearly sinusoidal oscillations - Frequency ≈ 1 rad/s - Smooth limit cycle - Weak nonlinearity
2. Moderate μ (0.1 < μ < 3): Nonlinear oscillations - Visible waveform distortion - Frequency slightly reduced - Standard Van der Pol behavior
3. Large μ (μ > 3): Relaxation oscillations - Two-timescale dynamics - Fast jumps between slow plateaus - Very non-sinusoidal - Period proportional to μ
Equilibrium:
Origin (unstable): x_eq = [0, 0]
The origin is: - Unstable focus (spiral): trajectories spiral outward - All trajectories (except origin) approach the limit cycle - Eigenvalues: λ = μ/2 ± i√(4-μ²)/2 * Real part positive (unstable) * Imaginary part gives oscillation frequency
Limit Cycle:
The system has a unique stable limit cycle:
Properties: - Globally attracting (except from origin) - Isolated (no nearby periodic orbits) - Amplitude ≈ 2 for all μ (approximately) - Period depends on μ: * μ → 0: T → 2π (harmonic) * μ = 1: T ≈ 6.7 * μ >> 1: T ≈ 1.614μ
Basin of attraction: Entire plane except origin - Any non-zero initial condition → limit cycle - Time to converge depends on distance from cycle
Relaxation Oscillations (μ >> 1):
For large μ, the system exhibits relaxation oscillations:
Mechanism: 1. Slow phase: x grows slowly along stable manifold 2. Jump: At x ≈ 1, rapid transition (fast manifold) 3. Slow phase: x decreases slowly along stable manifold 4. Jump: At x ≈ -1, rapid transition back 5. Repeat
Characteristics: - Distinct timescales (ε = 1/μ is small parameter) - Almost piecewise linear trajectory - Useful model for on-off systems (heart beats, neurons)
See Also:
DuffingOscillator : Another nonlinear oscillator (can be chaotic) Lorenz : 3D system that exhibits chaos NonlinearChainSystem : Multiple coupled oscillators