DG_RoomAcoustics is an open-source software package designed for the simulation of room acoustics using the time-domain wave-based method. This software implements the nodal discontinuous Galerkin (DG) method for spatial discretization of the linear acoustic equations, integrated over time with high-order schemes such as explicit Runge-Kutta and ADER (Arbitrary high-order DERivative) integration. DG_RoomAcoustics excels in scenarios where traditional geometrical acoustics tools fall short, providing superior accuracy in capturing complex wave phenomena such as diffraction, scattering, and modal effects. The software is designed to be user-friendly, with a focus on ease of use and flexibility, allowing researchers and engineers to simulate a wide range of room acoustics problems with high accuracy and computational efficiency.
To install DG_RoomAcoustics from GitHub repository, do:
git clone https://github.com/hqwang815/DG_RoomAcoustics.git
cd edg-acoustics
python3 -m pip install .To use DG_RoomAcoustics, please refer to the examples provided in the examples directory of the repository. These examples cover a range of scenarios to help you understand how to apply the software to your specific needs.
This project is licensed under the GNU General Public License v3.0. For more details, see the LICENSE file for details.
This documentation is designed to help you to understand and develop DG_RoomAcoustics effectively.
We welcome contributions to DG_RoomAcoustics! If you would like to help improve the project, you can have a look at the contribution guidelines.
Huiqing Wang
Email: h.wang6@tue.nl
Artur Palha
Email: A.Palha@tudelft.nl
DG_RoomAcoustics uses two open-source packages:
-
meshio: A versatile mesh file input/output library.
-
modepy: A library for evaluating and integrating with modal (polynomial) bases on simplices.
We would like to thank the authors of these packages for their contributions to the open-source community.
If you use DG_RoomAcoustics in your research, please help our scientific visibility by citing our work! Please cite the following paper: to be added.
This work was supported by the Dutch Research Council (NWO) under the project "A new era of room acoustics simulation software: from academic advances to a sustainable open source project and community" (project number 19430). The authors would also like to acknowledge the support of eScience center of Netherlands under the grant of "Small-Scale Initiatives in Software Performance Optimization" (OpenSSI 2021b)
- Implement high-performance computing techniques to accelerate simulations, particularly focusing on GPU acceleration.
- Develop a more user-friendly interface to simplify the setup and execution of simulation scenarios.
- Integrate additional acoustic modeling features based on community feedback, including advanced boundary condition models and post-processing tools for acoustic parameter calculations.
- Enhance documentation and examples to provide more comprehensive guidance and support to new users.
This package was firstly created following Cookiecutter and the NLeSC/python-template. Later modifications were made by the authors of the project.