Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

GitHub Workflow Status GitHub release (latest by date) jossstatus

PyPI PyPI - Implementation PyPI - Downloads

Docker Pulls badge

lite-badge

Documentation

A preliminary collection of documentation (demos, tutorials, mini API) can be found here and is also part of the i-tutorials of NGSolve, see here. A simple doxygen collection of NGSolve, ngsxfem and ngstrefftz C++ API can be found here.

About ngsxfem

ngsxfem is an add-on library to the finite element package Netgen/NGSolve which enables the use of unfitted finite element technologies known as XFEM, CutFEM, TraceFEM, Finite Cell, ... . ngsxfem is an academic software. Its primary intention is to facilitate the development and validation of new numerical methods for partial differential equations.

The features of ngsxfem

The main features of ngsxfem are:

  • Tools to work on a subset of the triangulation, the "active mesh" only
  • Numerical integration on geometries that are (implicitly) described through level set functions.
  • Higher order representation of level set geometries
  • Space-Time Finite Elements for the treatment of moving domain problems
  • All these features combined with the usual flexibility and power of NGSolve.

ngsxfem has been used in a variety of applications. In the document doc/feature-details.md (see also compiled pdf ) more details on the features is given and in doc/literature.md (see also the rendered literature page and the compiled pdf ) an overview of the scientific literature where ngsxfem is used is provided. If you have used ngsxfem in a publication that is missing there, please open an issue or a pull request (the list is generated from doc/literature.yaml).

Not all features of ngsxfem and NGSolve can directly be combined. Here is an overview of ngsxfem and NGSolve features and if they can directly be combined:

Features ⇲ CFE XFE DG Iso MLS ST Gh Ag Hex Tet MPI
CFE: CutFEM form. / / y y y y y y y y y
XFE: XFEM formulation / / y y n n y n y y y
DG: Discont. Galerkin y y / y n y y y y y n
Iso: isoparametric map y y y / n y y y y y y
MLS: multiple level set y n n n / n y y n y y
ST: space-time FEM y n y y n / y n y y y
Gh: Ghost penalty y y y y y y / / y y n
Ag: Agg. FEM y n y y y n / / y y n
Hex: quads / hexes y y y y n y y y / / y
Tet: trigs./tets y y y y y y y y / / y
MPI: MPI y y n y y y n n y y /

Some of the nos are work in progress and some have not been considered so far. If you need a certain combination to work, please contact us and we will see what we can do (MPI for Gh is planned for the not so far future).

Examples and Documentation

We provide two main sources with which to learn how to use ngsxfem:

  • At https://github.com/ngsxfem/ngsxfem-jupyter you can find tutorial-style jupyter notebooks for ngsxfem. These explain the core functionalities and usage of the tools provided by ngsxfem. You can run those tutorials interactively (without the need of a local installation) through binder.
  • In the demos-directory we provide several examples that demonstrate the usage of ngsxfem features. See demos/README.md for details.

Installation

We provide installation instructions for building/installing through pip and building/installing from sources in INSTALLATION.md. Further, a docker image is available which can be used to run ngsxfem through docker.

List of contributing authors

Major contributions:

  • Christoph Lehrenfeld (main author)
  • Fabian Heimann (cut integration, space-time, AggFEM)
  • Henry von Wahl (multiple levelsets, mac support, AggFEM)
  • Janosch Preuss (space-time)
  • Thomas Ludescher (multigrid)
  • Paul Stocker (CI, docu, builds, AggFEM)

Additional contributions:

  • Pedro Costa Klein (CI, docu)
  • Maximilian Zienecker (SIMD, CI)

Community guidelines

If you observe any problems with the software / examples / documentation / installation or want to contribute, you can get in touch with us through either:

Citing

If you use ngsxfem for academic work, please consider citing our publication:

C. Lehrenfeld, F. Heimann, J. Preuß and H. von Wahl
ngsxfem: Add-on to NGSolve for geometrically unfitted finite element discretizations
Journal of Open Source Software, 6(64), 3237,
https://doi.org/10.21105/joss.03237

Metadata

Release files for xfem 2.1.2607.dev14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for xfem 2.1.2607.dev14
File Size Uploaded Provenance
xfem-2.1.2607.dev14.tar.gz 2.2 MB Without provenance Details

Built distributions (wheels)

Table of built distributions (wheels) for xfem 2.1.2607.dev14
File
xfem-2.1.2607.dev14-cp313-cp313-win_amd64.whl CPython 3.13 CPython 3.13 Windows x86-64 Details
xfem-2.1.2607.dev14-cp313-cp313-manylinux_2_28_x86_64.manylinux2014_x86_64.whl CPython 3.13 CPython 3.13 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details
xfem-2.1.2607.dev14-cp313-cp313-macosx_10_9_universal2.whl CPython 3.13 CPython 3.13 macOS 10.9+ universal2 (ARM64, x86-64) Details
xfem-2.1.2607.dev14-cp312-cp312-win_amd64.whl CPython 3.12 CPython 3.12 Windows x86-64 Details
xfem-2.1.2607.dev14-cp312-cp312-manylinux_2_28_x86_64.manylinux2014_x86_64.whl CPython 3.12 CPython 3.12 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details
xfem-2.1.2607.dev14-cp312-cp312-macosx_10_9_universal2.whl CPython 3.12 CPython 3.12 macOS 10.9+ universal2 (ARM64, x86-64) Details
xfem-2.1.2607.dev14-cp311-cp311-win_amd64.whl CPython 3.11 CPython 3.11 Windows x86-64 Details
xfem-2.1.2607.dev14-cp311-cp311-manylinux_2_28_x86_64.manylinux2014_x86_64.whl CPython 3.11 CPython 3.11 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details
xfem-2.1.2607.dev14-cp311-cp311-macosx_10_9_universal2.whl CPython 3.11 CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64) Details
xfem-2.1.2607.dev14-cp310-cp310-manylinux_2_28_x86_64.manylinux2014_x86_64.whl CPython 3.10 CPython 3.10 Linux glibc 2.17+ x86-64, Linux glibc 2.28+ x86-64 Details
xfem-2.1.2607.dev14-cp310-cp310-macosx_10_9_universal2.whl CPython 3.10 CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64) Details

Total release size: 30.5 MB

Release files / xfem-2.1.2607.dev14.tar.gz

Download URL xfem-2.1.2607.dev14.tar.gz
Size 2.2 MB
Tags Source
SHA-256 checksum
How to use checksums
9427c63383a3da4dce769afde9c1950f69b2357ae6ca00d2198dc29b909dc772
BLAKE2b-256 checksum
How to use checksums
32587992ad6b90d9ab6c751ec310c17dacc0f1d04701303e08af9da500485eea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp313-cp313-win_amd64.whl

Download URL xfem-2.1.2607.dev14-cp313-cp313-win_amd64.whl
Size 2.9 MB
Tags CPython 3.13 Windows x86-64
SHA-256 checksum
How to use checksums
d611134cd8614c56b287c4a4b3c3d13e328b8ef2594a5f0f59d1eb5b96188474
BLAKE2b-256 checksum
How to use checksums
85dac296712dcff21944fc2ebb401d0c93ba489d24e63b0bfc5f3bc42b10cbc0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp313-cp313-manylinux_2_28_x86_64.manylinux2014_x86_64.whl

Download URL xfem-2.1.2607.dev14-cp313-cp313-manylinux_2_28_x86_64.manylinux2014_x86_64.whl
Size 1.9 MB
Tags CPython 3.13 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
2d63a20d7f003c6679bb51c36c6b4890e0fa7a483dd1174bcea41165aa982828
BLAKE2b-256 checksum
How to use checksums
dc343c1eb6599a5da7b7abc9d357bcb3453e6921ba2491e311544ef48e0dafda
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp313-cp313-macosx_10_9_universal2.whl

Download URL xfem-2.1.2607.dev14-cp313-cp313-macosx_10_9_universal2.whl
Size 3.0 MB
Tags CPython 3.13 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
d67f0ca6551d86fad92e813e240a21624ebf19d4cb66e3e7803439c02950a4c3
BLAKE2b-256 checksum
How to use checksums
0ae826a9b5b2773f94f64a277156493e143127e449fa466ee69b539235935826
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp312-cp312-win_amd64.whl

Download URL xfem-2.1.2607.dev14-cp312-cp312-win_amd64.whl
Size 2.9 MB
Tags CPython 3.12 Windows x86-64
SHA-256 checksum
How to use checksums
e198a3a80d629f7e0236b2a6e148bef7a6293dbe1692f304542be974482c6399
BLAKE2b-256 checksum
How to use checksums
3b723bd916da75d262729164ed045e0622019b10183b5de973a1b4437486abbe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp312-cp312-manylinux_2_28_x86_64.manylinux2014_x86_64.whl

Download URL xfem-2.1.2607.dev14-cp312-cp312-manylinux_2_28_x86_64.manylinux2014_x86_64.whl
Size 1.9 MB
Tags CPython 3.12 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
8a2623b74798ecb7c5fe725c01207455627b5cd62cec8ee2ba88b18d6a16e008
BLAKE2b-256 checksum
How to use checksums
e04c51d50a6af02dbdad1188032314e1f4cba2be14f16d95727211d59142c310
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp312-cp312-macosx_10_9_universal2.whl

Download URL xfem-2.1.2607.dev14-cp312-cp312-macosx_10_9_universal2.whl
Size 3.0 MB
Tags CPython 3.12 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
c0285cf816032fc1a4cea1265aec576993f38e4ef12a13eee65c6f2225bf78fc
BLAKE2b-256 checksum
How to use checksums
03cdbca097bff42eec3f943126e35c600f01d29074e7f2d738ed3bc470ba1bf9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp311-cp311-win_amd64.whl

Download URL xfem-2.1.2607.dev14-cp311-cp311-win_amd64.whl
Size 2.9 MB
Tags CPython 3.11 Windows x86-64
SHA-256 checksum
How to use checksums
208256dabf403ef2c77837d8beae58c2237339ae77529aa9180ac509adf9ff6a
BLAKE2b-256 checksum
How to use checksums
9529660508b40c62444ddb3dbb656584fd030e727098882f8081ac3f005cab9d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp311-cp311-manylinux_2_28_x86_64.manylinux2014_x86_64.whl

Download URL xfem-2.1.2607.dev14-cp311-cp311-manylinux_2_28_x86_64.manylinux2014_x86_64.whl
Size 1.9 MB
Tags CPython 3.11 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
730c64d168a889e616fa9ce745b54c764be3b1c3938abab43c665d7084eed6fb
BLAKE2b-256 checksum
How to use checksums
6a957f2213f28dd3a52c233c23a829c36a2694109e90b649840be602c92f86ac
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp311-cp311-macosx_10_9_universal2.whl

Download URL xfem-2.1.2607.dev14-cp311-cp311-macosx_10_9_universal2.whl
Size 3.0 MB
Tags CPython 3.11 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
5ad00222827bb962b91e491dfd4493ff6b5608987f5b78929056ae26e75c4ee9
BLAKE2b-256 checksum
How to use checksums
397092392a92ebb2d35e154337bfa024c93659573782fdb03f3fd295557ccb11
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp310-cp310-manylinux_2_28_x86_64.manylinux2014_x86_64.whl

Download URL xfem-2.1.2607.dev14-cp310-cp310-manylinux_2_28_x86_64.manylinux2014_x86_64.whl
Size 1.9 MB
Tags CPython 3.10 Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64
SHA-256 checksum
How to use checksums
54d9c1d8b91ffd4ab737b50d40349416e39030540bfe9b3fd14e275d16032b86
BLAKE2b-256 checksum
How to use checksums
535343873d6e8e8da061a2bb442908988899adec3eae2b9b296de659fa6df0dc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Release files / xfem-2.1.2607.dev14-cp310-cp310-macosx_10_9_universal2.whl

Download URL xfem-2.1.2607.dev14-cp310-cp310-macosx_10_9_universal2.whl
Size 3.0 MB
Tags CPython 3.10 macOS 10.9+ universal2 (ARM64, x86-64)
SHA-256 checksum
How to use checksums
b18b9cd54b13749cdfc6a3cf5b11499d6a0961dc6320c3895ca6fc2829083e7d
BLAKE2b-256 checksum
How to use checksums
43546fe0298cc5587c5a17d03582ae0f59d77a108a886398aeedd4bf95713981
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.16

Security for xfem 2.1.2607.dev14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page