mercurial.core.dynamics module

Pattern dynamics with free energy gradient descent and persistence.

mercurial.core.dynamics.evolve_pattern_trajectory(pattern: Pattern, t_span: float, dt: float, temperature: float = 1.0, noise_amplitude: float = 0.01) → list

Evolve pattern over time using a simple Euler step.

mercurial.core.dynamics.free_energy_gradient(pattern: Pattern, free_energy_func=None, epsilon: float = 1e-06)

Compute ∇_v F(P) using finite differences. Returns (grad, current_F).

mercurial.core.dynamics.pattern_evolution_with_persistence(pattern: Pattern, dt: float, free_energy_func, gamma0: float = 0.001, S_crit: float = 10.0, noise_amplitude: float = 0.01, rng=None) → Tuple[Pattern, float]

Placeholder – implement as needed.

mercurial.core.dynamics.pattern_evolution_with_thermodynamics(pattern, dt, free_energy_func, noise_amplitude=0.01, rng=None)

Alias for pattern_evolution_with_persistence to satisfy legacy tests. Uses default persistence parameters.