amerta: A Python Library for Idealized 1D Saint--Venant Dam-Break Simulation

Dasapta E. Irawan; Sandy H. S. Herho; Iwan P. Anwar; Faruq Khadami; Astyka Pamumpuni; Rendy D. Kartiko; Edi Riawan; Rusmawan Suwarman; Deny J. Puradimaja

arXiv · 2605.31011

amerta: A Python Library for Idealized 1D Saint--Venant Dam-Break Simulation

Dasapta E. Irawan·Sandy H. S. Herho·Iwan P. Anwar·Faruq Khadami·Astyka Pamumpuni·Rendy D. Kartiko·Edi Riawan·Rusmawan Suwarman·Deny J. Puradimaja

View original source ↗Read source document ↗Export metadata ↓

Abstract

The Saint-Venant shallow water equations (SWE) govern depth-integrated free-surface flows arising in dam-break inundation, flood routing, tsunami runup, and estuarine tidal dynamics. Closed-form analytical solutions exist only for highly idealized Riemann configurations, making rigorously verified numerical solvers essential. This work presents amerta, an open-source Python library that solves the one-dimensional frictionless Saint-Venant system on a uniform Cartesian grid using Monotone Upstream-centered Schemes for Conservation Laws (MUSCL) reconstruction with a minmod slope limiter, the Harten-Lax-van Leer-Contact (HLLC) approximate Riemann solver, and two-stage strong-stability-preserving Runge-Kutta (SSP-RK) time integration. Numba just-in-time (JIT) compilation accelerates the performance-critical kernels. The solver is verified end-to-end against the four canonical Riemann configurations: wet-bed dam break, dry-bed dam break, double rarefaction, and double shock. A six-component post-processing pipeline quantifies space-time topology, final-time error norms with empirical quantile decomposition, self-similarity collapse onto the analytical Riemann fan, integral-norm evolution, boundary-flux-corrected mass and energy diagnostics, and phase-plane analysis against analytical wave curves. The implementation conserves discrete mass to floating-point precision, satisfies discrete entropy admissibility identically, and reproduces all four analytical wave-curve geometries to within sub-centimetre accuracy in the depth-velocity phase plane. The complete source code, analytical-solution evaluators, post-processing scripts, and Network Common Data Format (NetCDF) archives are released under the MIT license.

Explore related subjects

physics.flu-dyn physics.ao-ph physics.comp-ph

Keep this discovery

Explore connections, maps & timelines

BibTeX RIS

Dasapta E. Irawan, Sandy H. S. Herho, Iwan P. Anwar, Faruq Khadami, Astyka Pamumpuni, Rendy D. Kartiko, Edi Riawan, Rusmawan Suwarman, Deny J. Puradimaja. 2026-05-29. amerta: A Python Library for Idealized 1D Saint--Venant Dam-Break Simulation. https://arxiv.org/abs/2605.31011

Cite the original work for its findings. Save a collection to share your selection of sources.

KEEP EXPLORING

Related papers

arXiv2026

Cross-helicity and chaotic dynamics of full-disc solar magnetic field

Using the results of laboratory experiments and direct numerical simulations, as well as observations of the full-disc solar magnetic field and sunspot number dynamics, it is demonstrated that cross-helicity can dominate the decaying part of the frequency power spectra of the magnetic field generated by a magnetohydrodynamic (MHD) dynamo in chaotic/turbulent swirling flows for sufficiently strong MHD turbulence (including the solar dynamo). The theoretical consideration is based on a Kolmogorov-like phenomenology within the framework of the distributed chaos concept. It is also shown that the solar full-disc magnetic field for the last two solar cycles with weak magnetic activity exhibits deterministic chaotic behavior concentrated around the equator.

physics.flu-dyn↗

arXiv2026

Manifestation of spurious currents and interface regularization in wind turbulence over fast-propagating waves

Accurate simulation of wind turbulence over fast-propagating waves requires interface-capturing methods that suppress numerical artifacts while accurately resolving momentum transfer across the interface. In high wave-age regimes, numerical errors at the air-water interface can reach magnitudes comparable to the physical flow, directly affecting predicted turbulence statistics. This study examines widely used interface-capturing techniques to evaluate how curvature estimation and flux discretization influence wind-wave simulations through the resulting spurious currents and interface regularization. A systematic assessment is performed using static and translating droplet benchmarks, together with solitary and monochromatic wave cases, to identify and quantify the dominant numerical error mechanisms. In addition, comparison with experimental measurements reveals how these primary error sources manifest in coupled wind-wave simulations. These findings clarify the numerical origin of the observed discrepancies and underscore the importance of accurate curvature and flux treatment in high wave-age regimes, without which numerical artifacts risk being misattributed to genuine wind-wave physics.

physics.flu-dyn↗

arXiv2026

A reconfigurable multi-axis cyber-physical framework for multi-regime fluid--structure interaction experiments

Fluid--structure interaction (FSI) experiments are typically built around mechanical dynamics and constraints imposed by the physical apparatus, so changing mass, stiffness, damping, or allowable motion often requires hardware reconfiguration. Here we present a reconfigurable cyber-physical framework in which these properties are instead assigned through software-defined dynamics. The system provides three translational and one rotational degree of freedom, each independently configurable as prescribed, load-responsive, or locked, with operating roles that can also be reassigned during a running experiment. Measured forces and torques are incorporated into real-time virtual dynamic models, while a common supervisory architecture coordinates multi-axis motion, mode switching, synchronized data acquisition, and diagnostic positioning. The prescribed-motion pathway is validated using a pitching hydrofoil by comparison with published thrust and power scaling trends, while the load-responsive pathway is evaluated using an active-heave/passive-pitch benchmark that reproduces the expected frequency-dependent resonant response over the tested conditions. The same platform is then reconfigured for intra-cycle active--passive pitching, coordinated vertical-axis turbine-surrogate motion, force-driven passive surge, and automated multilayer stereoscopic particle image velocimetry. These results demonstrate that distinct FSI boundary conditions and measurement requirements can be implemented within a common motion, sensing, and control architecture. By treating mechanical roles and constraints as software-defined experimental variables, the framework provides a reusable basis for reconfigurable FSI experiments without redesigning the underlying platform for each application.

physics.flu-dyn↗