$ show Universite-Gustave-Eiffel/I-Simpa
I‑Simpa is a mature, open‑source desktop application for 3D numerical sound propagation modelling, designed for scientific acoustic simulations. The system provides a full GUI (built with wxWidgets and OpenGL) for defining acoustic scenes (sources, receivers, materials, meshes), running multiple calculation cores (particle tracing SPPS, classical theory TCR, and experimental TLM), and post‑processing results via point/surface receivers, impulse responses, and sound maps. It features a tree‑based data model with XML persistence, a Python scripting layer for automation and custom tools, and supports industry‑standard file formats (STL, PLY, GABE binary arrays). The codebase is predominantly C++ with a Boost.Python bridge, and is actively maintained by the Environmental Acoustic Research unit at Université Gustave‑Eiffel. The architecture follows a classic monolith pattern with clear separation: a core calculation library (`src/spps/`, `src/ctr/`), a 3D rendering engine (`src/isimpa/3dengine/`), a GUI layer (`src/isimpa/IHM/`), and a data manager with element/property tree. Python scripts in `SystemScript/` extend the UI through a plugin mechanism. While the project is functionally complete and validated against benchmarks, it exhibits moderate technical drift: bundled MathJax 2.7.5 (2018) for documentation, some French comments and variable names, and a few Python 2 remnants. Despite this, the component design—especially the octree spatial index, GABE binary I/O, and XML element tree—are cleanly abstracted and potentially reusable in other scientific or simulation contexts. The repository also includes extensive documentation and tutorials, though the experimental directivity feature is flagged as undocumented.
The LLM identified 5 files worth highlighting for reuse:
Implements the GABE (Generic Array Binary Exchange) format – a self‑describing, column‑oriented binary file format with typed columns (string, int, float). Supports read, write, append, and random access. The design is clean, with a well‑defined header and data block structure. This component is a reusable building block for any scientific application needing compact, portable tabular data exchange.
A generic octree template (octree44) for 3D spatial indexing with overlap tests against spheres, triangles, segments, and cylinders. The implementation uses a template parameter for the element type and provides insertion, removal, and query operations. It is self‑contained, header‑only, and could be extracted for use in any 3D simulation or game engine.
The core `Element` base class that underpins the entire project data model. It provides a hierarchical tree of nodes, each with a UUID, icon, and a dynamic property system supporting text, boolean, decimal, color, font, and file types. Properties are serialized to/from XML via `SaveXMLDoc` and `LoadXMLDoc`. This pattern is a reusable foundation for any application needing a persistent, editable data tree.
A vendored copy of pugixml, a lightweight, high‑performance XML parser with DOM and XPath support. The code is clean, well‑tested (included test suite), and used extensively for project file I/O. While not original to this project, its careful integration and the presence of a test allocator demonstrate good engineering practice. It can be reused as a standalone XML library.
The `InstanceManager` manages a global mapping between C++ objects (identified by type and an index) and their Python wrappers. It uses `boost::python` to expose C++ objects to Python scripts and ensures proper reference counting. This pattern is reusable for any C++ application that needs a safe, scriptable API.