ContactImpactBench: Reproducible numerical benchmarks for compliant-impact and frictional-contact models
Year: 2026
Type: software
Abstract: ContactImpactBench v0.1.4 — Reproducible Numerical Benchmarks for Compliant Impact and Frictional Contact ContactImpactBench is an open-source Python research software package designed for reproducible numerical verification of reduced compliant-impact dynamics and frictional-contact models. It provides computational implementations, archived reference datasets, automated verification tests, and command-line tools for examining numerical consistency, energy balance, and differences between contact-model approximations. Software components The software includes three principal benchmark components: N3.3 — Reduced spatial oblique-impact dynamics. A reduced compliant-contact model incorporating tangential contact-history effects and coupled sliding–spinning friction, with numerical diagnostics of the implemented energy balance. N3.4 — Independent normal-impact integration. Event-localized numerical integration of the normal-impact subsystem using an independently implemented DOP853-based procedure, enabling comparison with a discrete integration scheme under the same normal contact law. N3.6 — Distributed sliding–spinning friction. Numerical evaluation of distributed friction forces and moments over prescribed circular contact patches, including comparisons with an ellipsoidal friction approximation. The distribution contains documented Python interfaces, executable examples, numerical reference data, and tools for reproducing archived benchmark calculations. Verification and reproducibility Version 0.1.4 has successfully passed: 24 automated software tests using pytest. 64 archived numerical regression checks, comprising 36 N3.3 cases, 24 N3.4 cases, and 4 N3.6 cases. Continuous-integration checks using GitHub Actions on Windows and Ubuntu. Local verification on Windows with Python 3.14.3, NumPy 2.5.4, and SciPy 1.18.1. Distribution metadata checks for the Python wheel and source archive. An additional cross-language numerical verification study compared the normal-impact subsystem with a separately implemented C++17 Runge–Kutta solver using identical contact laws and initial conditions. The study supports numerical consistency across independent implementations and integration procedures. Scientific scope and limitations ContactImpactBench is intended for numerical-method verification, reproducibility studies, comparison of simplified contact formulations, and identification of implementation-level inconsistencies. Passing numerical regression tests does not constitute experimental physical validation. The software does not provide an experimentally validated predictive model of the impact of a real inflated hyperelastic shell. Its reduced contact laws and prescribed pressure distributions must be assessed against the assumptions and requirements of each intended application. The package is a specialized verification toolkit rather than a general-purpose multibody dynamics solver. Version 0.1.4 This release updates the software authorship and citation metadata, including CITATION.cff, Python package metadata, and supporting documentation. The verified numerical algorithms and archived reference datasets are preserved from version 0.1.3. Authors Serhii Podliesnyi — ORCID: 0000-0001-8271-4004 Oksana Chmykhova — ORCID: 0000-0002-9198-9701 Bohdan Vorobiov — ORCID: 0000-0002-0264-354X Affiliation: Donbas State Engineering Academy, Ukraine. Availability and licensing Source code: https://github.com/spodlesny2318-arch/ContactImpactBench Versioned source release: https://github.com/spodlesny2318-arch/ContactImpactBench/releases/tag/v0.1.4 PyPI distribution: https://pypi.org/project/contactimpactbench/0.1.4/ License: MIT Installation and verification Install the released package from PyPI: python -m pip install contactimpactbench==0.1.4 Run the complete archived numerical regression suite: python -m contactimpactbench verify --full This archived release provides a version-specific, reproducible software baseline for computational contact-mechanics research and for citation in the associated SoftwareX manuscript.
Institution: Donbass State Engineering Academy
Language: English
Subfield: Control and Systems Engineering
Field: Engineering
Domain: Physical Sciences
Open Access status: green
OpenAlex ID: W7225801992
Cites:
Cited by:
Related to: