How tiagovla/oiseau works
oiseau is a research-oriented DG time-domain framework for electromagnetic and wave-propagation simulation. The intended workflow runs from mesh input through DG discretization and geometric/integration operators to a linear DG solver; time-stepping and plotting provide supporting runtime capabilities, and Python exposes selected interfaces. The README also lists dispersive, anisotropic, and vector-fitting capabilities as planned, not established implementations. Edges are limited to README-documented workflow or source-index/import evidence; unsampled runtime wiring is not inferred.
Main entry points: mesh.hpp Mesh model · linear_dg.cpp Linear DG solver · dg_integration.cpp DG integration · dg_connectivity.hpp DG connectivity
Components 16
Mesh input
- Gmsh I/O
src/oiseau/io/gmsh_file.cpp - Mesh model
src/oiseau/mesh/mesh.hpp - Cell topology
src/oiseau/mesh/cell.hpp
DG discretization
- DG space
src/oiseau/dg/dg_space.hpp - Reference elements
src/oiseau/dg/nodal/ref_element.hpp - DG connectivity
src/oiseau/dg/dg_connectivity.hpp - DG geometry
src/oiseau/dg/dg_geometry.cpp - DG integration
src/oiseau/dg/dg_integration.cpp
Simulation runtime
- Equation system
src/oiseau/dg/equation.hpp - Linear DG solver
src/oiseau/dg/solver/linear_dg.cpp - Time integrators
src/oiseau/time/lsrk54.hpp - Plotting
src/oiseau/plotting/triplot.hpp - Planned media models
src/oiseau/dg/equation.hpp - Planned vector fitting
src/oiseau/dg
User interfaces
- Python bindings
python/oiseau/wrappers/mesh.cpp
Other components
- Simulation user
Connections 16
- Simulation user → Gmsh I/O: provides mesh
- Gmsh I/O → Mesh model: reads mesh
- Mesh model → DG space: discretizes
src/oiseau/dg/dg_space.hpp - Mesh model → DG connectivity: builds adjacency
src/oiseau/dg/dg_connectivity.hpp - Mesh model → DG geometry: computes factors
src/oiseau/dg/dg_geometry.cpp - Cell topology → Reference elements: selects shape
src/oiseau/dg/ref_element_type.hpp - Reference elements → DG integration: builds operators
src/oiseau/dg/dg_integration.cpp - DG connectivity → DG integration: supplies faces
src/oiseau/dg/dg_integration.cpp - DG geometry → DG integration: scales rules
src/oiseau/dg/dg_integration.cpp - Simulation user → Linear DG solver: runs simulation
- Linear DG solver → DG connectivity: uses adjacency
src/oiseau/dg/solver/linear_dg.cpp - Linear DG solver → DG geometry: uses factors
src/oiseau/dg/solver/linear_dg.cpp - Linear DG solver → DG integration: uses operators
src/oiseau/dg/solver/linear_dg.cpp - Simulation user → Python bindings: uses interface
- Simulation user → Planned media models: planned capability
- Simulation user → Planned vector fitting: planned capability