QUGaR is a C++ library designed to generate efficient quadrature rules for computing integrals in high-order unfitted/immersed/CutFEM methods. Additionally, it offers functionalities for generating unfitted domain reparameterizations for visualization purposes.
Currently, QUGaR is in its early stages. Initially, it supports unfitted domains created by implicit functions via Algoim. Future updates will include support for 2D and 3D B-reps.
While it is intended to be used with any library, QUGaR provides out-of-the-box interoperability with the FEniCSx Python interfaces. A gentle introduction can be found here.
Documentation can be viewed at https://pantolin.github.io/qugar/main/index.html.
Note
Right now, QUGaR installation has to be done "manually" from the sources. However, it is our intention to provide a conda-forge recipe in the near future. Stay tuned!
First clone the repository and go inside
git clone https://github.com/pantolin/qugar.git
cd qugarTo build and install the C++ library, from the qugar/ root directory run:
cmake -G Ninja -DCMAKE_BUILD_TYPE=Release -B build -S cpp/
cmake --build build --parallel 4
cmake --install buildQUGaR's Python interface requires the C++ library. So before installing the Python interface, make sure you have the C++ library installed.
To build and install the Python interface, under the qugar/ root directory run
python3 -m pip -v install -r ./python/build-requirements.txt
python3 -m pip -v install --no-build-isolation ./python -UIf you want to use QUGaR's functionalities together with FEniCSx library, install also DOLFINx, including pyvista dependency.
Further details about the installation of the C++ and Python modules can be found at https://pantolin.github.io/qugar/latest/installation.html.
It is also possible to use QUGaR from a docker container.
The docker file may be built and run from the qugar/ root directory as
docker build -f docker/Dockerfile -t qugar .
docker run -it -v $(pwd):/root/shared -w /root/shared qugar bash -iQUGaR is free software: you can redistribute it and/or modify it under the terms of the MIT license.