Numav (work in progress)

Numav is a C++ library with Julia bindings to perform acoustics and vibrations simulations.

How to start the development container

The development container can be started in two ways:

• directly in a linux terminal environment;
• through the Dev Containers VS Code extension.

Linux terminal

To start the container directly in a Linux terminal environment, go to the root directory of this repository and run:

./docker/start-container.sh <path-to-your-github-ssh-keys>

<path-to-your-github-ssh-keys> is an optional argument. Its default value is ~/.ssh.

VS Code

To start the container through the Dev Containers VS Code extension, install it and open the root folder of this repository. Then, click the remote indicator in the bottom-left corner and select Reopen in Container.

How to build libnumav (static)

Run:

rm -rf build &&
cmake -B build -D CMAKE_BUILD_TYPE=Release &&
cmake --build build --parallel ${nproc}

How to build libnumav (dynamic)

Run:

rm -rf build &&
cmake -B build -D CMAKE_BUILD_TYPE=Release -D BUILD_SHARED_LIBS=TRUE &&
cmake --build build --parallel ${nproc}

How to build and run tests

Run:

rm -rf build &&
cmake -B build \
-D CMAKE_BUILD_TYPE=Release \
-D BUILD_TESTS=TRUE \
-D CMAKE_PREFIX_PATH="\
/opt/intel/oneapi/mkl/2025.2/lib/cmake;\
/HDF_Group/HDF5/2.1.1" &&
cmake --build build --parallel ${nproc} &&
./build/tests_bin/test1

How to link a code against libnumav.a (Static Numav)

Run:

g++ -o my_simulation my_simulation.cpp -Iinclude -L./build/lib -L/opt/intel/oneapi/mkl/2025.2/lib -Wl,--start-group -l:libmkl_core.a -l:libmkl_gf_ilp64.a -l:libmkl_gnu_thread.a -Wl,--end-group -lgomp -lpthread -lm -ldl -lnumav -m64 -flto

How to link a code against libnumav.so (Dynamic Numav)

Run:

g++ -o my_simulation my_simulation.cpp -I include -L ./build/lib -l numav -Wl,-rpath,./build/lib

How to build numav_julia

rm -rf build &&
rm -rf julia-bindings/override/lib &&
cmake -B build \
-D CMAKE_BUILD_TYPE=Release \
-D SOLVER=ONEMKL \
-D BIND_JULIA=TRUE \
-D CMAKE_INSTALL_PREFIX=julia-bindings/override \
-D CMAKE_PREFIX_PATH="\
/opt/intel/oneapi/mkl/2025.2/lib/cmake;\
/usr/local/share/julia/artifacts/662f181f562225e139306f1e6e383c70bc9255f9;\
/HDF_Group/HDF5/2.1.1" &&
cmake --build build --parallel ${nproc} &&
cmake --install ./build

How to build the JLL for local testing

rm -rf build && rm -rf install && rm -rf products && julia +1.12.4 \
/workspace/julia-bindings/Yggdrasil/N/numav_julia/build_tarballs.jl \
--deploy-jll=local

Dev the Julia packages

dev numav_julia_jll
dev /workspace/julia-bindings/Numav