Version 1.0
Contact: Vincent Etienne / Email: vetienne@rocketmail.com
DjanGo is a versatile C++ tool for modelling wave propagation with finite-difference & finite-element methods. It targets applications towards wave propagation in various fields: geophysics, seismology, ocean acoustics and sound modelling to name a few. Anyone who is interested in using DjanGo or contributing to its development is invited to contact me.
Features of DjanGo
- Wave propagation formulation
- Acoustic and elastic wave formulation
- 1st and 2nd order equation formulation
- 1D and 2D geometries
- Boundary conditions
- Free surface, rigid surface
- Absorbing boundaries: CPML and Sponge
- Parallelism
- Multi threading (OpenMP)
- Subdomain decomposition (MPI)
FDM characteristics
- Staggered grids
- 2nd to 16th order in space
- Second-order leap frog time integration scheme
FEM characteristics
- Continuous Galerkin Spectral Element method
- Discontinuous Galerkin Spectral Element method with full p-adaptivity
- Segment (1D) and quadrangle (2D) elements
- GLL nodes (arbitrarily number)
- Second-order leap frog time integration scheme
Intensive test cases have been designed to validate accuracy and convergence.
| Version | Description | Release date |
|---|---|---|
| v1.0 | Initial version | August 2024 |
To use DjanGo on your computer you need
- C++ compiler with OpenMP support
- MPI library
🔔 DjanGo has been developped under the Linux environment and all scripts in this projects are shell scripts that run on Linux.
DjanGo runs on CPU (support for GPU accelerators will be available sometime).
To display figures and hear sounds with the provided material, Matlab is necessary.
In order to compile and run DjanGo, you need to source one of the files in the directory ./env
cd ./env
Example to set up the environment for DjanGo with GCC compiler:
source setEnvMarsGcc.sh
🔔 For a new system, you would need to create a file for your system (take example from one of the existing files)
To compile DjanGo, go to ./build, and use the command make
Executable can be found in ./bin/django
🔔 If DjanGo environment has not been set (see Environment script (mandatory)), compilation will abort.
By default, DjanGo is compiled in single in precision
To compile in double precision: make precision=double
Some additional tools are provided and need also to be compiled. Go to ./misc/tool/build, and use the command make
To check that DhanGo has correctly been built and works fine, go to ./script and launch
sh runValidationTests.sh
This script runs a set a light test cases and should complete within few minutes on a laptop.
You should get in the ouptput report (displayed on the terminal)
- All tests Ok (PASSED 528)
- No test with an error (FAILED 0)
Check the summary at the end of report to have a quick look on this.
DjanGo has been successfully tested on the hardware, operating systems and compilers listed below.
DjanGo can be launched from a terminal with all configuration parameters within a single xml file.
To get help on the parameters
./bin/django -h
bin: binaries
build: compilation directory (Makefile is there)
demo: some applications in geophysics and sound modelling
env: environment scripts
include: all include *.h files
misc: miscellaneous dirs, including tools
script: validation scripts
src: all source *.cpp files