https://github.com/cchandre/hamlorenz
Hamiltonian Lorenz models
https://github.com/cchandre/hamlorenz
hamiltonian hamiltonian-dynamics hamiltonian-systems lorenz-96 lorenz96 symplectic-integrator symplectic-integrators waves
Last synced: 3 months ago
JSON representation
Hamiltonian Lorenz models
- Host: GitHub
- URL: https://github.com/cchandre/hamlorenz
- Owner: cchandre
- License: bsd-2-clause
- Created: 2025-06-05T13:07:47.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2026-01-19T15:52:42.000Z (4 months ago)
- Last Synced: 2026-01-19T22:00:21.950Z (4 months ago)
- Topics: hamiltonian, hamiltonian-dynamics, hamiltonian-systems, lorenz-96, lorenz96, symplectic-integrator, symplectic-integrators, waves
- Language: Python
- Homepage:
- Size: 83 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Hamiltonian Lorenz Models
This package implements **Hamiltonian Lorenz-like models**, a class of low-order dynamical systems that extend the classical Lorenz-96 and Lorenz-2005 frameworks by incorporating a **Hamiltonian structure**. These models are designed to preserve certain physical invariants—such as energy and Casimirs—making them particularly well-suited for studying conservative dynamical systems, geophysical flows, and chaotic transport.
[](https://archive.softwareheritage.org/swh:1:dir:2e47f563b4867d1cfd866173a9c0d66266e37bca;origin=https://pypi.org/project/HamLorenz/;visit=swh:1:snp:98a3ade4f85c1d188c1b82ed281be6b6c325e612;anchor=swh:1:rel:595ee664e187f4b9482a7d8d6060c19366fea088;path=/hamlorenz-0.1.11/)
## Installation
Installation within a Python virtual environment:
```
python3 -m pip install hamlorenz
```
For more information on creating a Python virtual environment, click [here](https://realpython.com/python-virtual-environments-a-primer/). For a summary with the main steps, click [here](https://github.com/cchandre/HamLorenz/wiki/Python-Virtual-Environment-Primer).
### Features
* **Hamiltonian structure**: The time evolution of the system is derived from a Hamiltonian, preserving energy exactly as in the continuous-time limit.
* **Casimir invariants**: Multiple conserved quantities beyond energy, ensuring the system evolves on a constrained manifold.
* **Symplectic integrators**: Optional numerical solvers designed for long-time energy and Casimir invariant preservation.
* **Lyapunov spectrum computation**: Quantifies the level of chaos in the system via Lyapunov exponents.
* **Fourier-based desymmetrization**: Enables translational symmetry reduction to study physical variables in a more interpretable form.
* **PDF and time series visualization**: Built-in tools to analyze and visualize system statistics and dynamics.
### Applications
* Modeling barotropic dynamics or simplified atmospheric flows.
* Testing chaos detection and prediction techniques.
* Benchmarking conservative integration schemes.
### Reference
For a full mathematical formulation and analysis of these models, see:
**Fedele, Chandre, Horvat, and Žagar**
*Hamiltonian Lorenz-like models*,
*Physica D*, Vol. 472, 134494 (2025).
[https://doi.org/10.1016/j.physd.2024.134494](https://doi.org/10.1016/j.physd.2024.134494)
```bibtex
@article{HamLorenz,
title = {Hamiltonian Lorenz-like models},
author = {Francesco Fedele and Cristel Chandre and Martin Horvat and Nedjeljka Žagar},
journal = {Physica D: Nonlinear Phenomena},
volume = {472},
pages = {134494},
year = {2025},
doi = {https://doi.org/10.1016/j.physd.2024.134494},
}
```
---
### Documentation & Examples
Examples can be found at [Examples](https://github.com/cchandre/HamLorenz/wiki/Examples)
The full documentation, including detailed function explanations, is available on the [Wiki Page](https://github.com/cchandre/HamLorenz/wiki).