ngstrefftz 0.3.2602.dev11__tar.gz → 0.3.2604.dev5__tar.gz

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/.github/workflows/build.yml

@@ -83,14 +83,31 @@ jobs:
           deps = tomllib.loads(pathlib.Path("pyproject.toml").read_text())["project"]["dependencies"]
           subprocess.check_call(["pip", "install", *deps])
           PY
-      - name: build ngstrefftz gtest
+      - name: Configure
         run: |
-          mkdir $GITHUB_WORKSPACE/NGSTrefftz/make
-          cd $GITHUB_WORKSPACE/NGSTrefftz/make
-          cmake .. -DNGSTREFFTZ_USE_GTEST=ON
-          make
-      - name: run gtest
-        run: $GITHUB_WORKSPACE/NGSTrefftz/make/trefftz_gtest
+          cmake \
+            -S "$GITHUB_WORKSPACE/NGSTrefftz" \
+            -B "$GITHUB_WORKSPACE/NGSTrefftz/make" \
+            -DNGSTREFFTZ_USE_GTEST=ON \
+            -DCMAKE_BUILD_TYPE=Release
+      - name: Build
+        run: |
+          cmake --build "$GITHUB_WORKSPACE/NGSTrefftz/make" 
+      - name: Run tests
+        run: |
+          NGSOLVE_BLAS_LIBS="$(python - <<'PY'
+          import ngsolve_openblas
+          print(":".join(str(p) for p in ngsolve_openblas.get_libraries()))
+          PY
+          )"
+
+          echo "Preloading NGSolve BLAS libraries:"
+          echo "${NGSOLVE_BLAS_LIBS}"
+
+          LD_PRELOAD="${NGSOLVE_BLAS_LIBS}${LD_PRELOAD:+:${LD_PRELOAD}}" \
+            ctest \
+              --test-dir "$GITHUB_WORKSPACE/NGSTrefftz/make" \
+              --output-on-failure
 
   build_wheels:
     if: ${{ inputs.level != 'test_only' }}
@@ -321,7 +338,7 @@ jobs:
           journal: joss
           paper-path: docs/paper/paper.md
       - name: Upload
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: joss_paper
           path: docs/paper/paper.pdf

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/CMakeLists.txt

@@ -1,4 +1,4 @@
-cmake_minimum_required(VERSION 3.16)
+cmake_minimum_required(VERSION 3.18)
 ########################################################
 project(ngstrefftz)
 ########################################################
@@ -32,12 +32,111 @@ download_if_possible (
     "${CMAKE_BINARY_DIR}/cmake_modules/ngsolve_addon.cmake")
 set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} ${CMAKE_BINARY_DIR}/cmake_modules)
 
+# -----------------------------------------------------------------------------
+# ngsolve-targets.cmake may reference MKL::MKL before NGSolveConfig.cmake has imported it
+if(NOT TARGET MKL::MKL)
+    set(MKL_INTERFACE "lp64" CACHE STRING "MKL integer interface" FORCE)
+    set(MKL_LINK "sdl" CACHE STRING "MKL linking model" FORCE)
+    set(_NGSTREFFTZ_MKL_HINTS)
+    if(MKL_ROOT)
+        list(APPEND _NGSTREFFTZ_MKL_HINTS "${MKL_ROOT}/lib/cmake/mkl")
+    endif()
+    if(DEFINED ENV{MKLROOT} AND NOT "$ENV{MKLROOT}" STREQUAL "")
+        list(APPEND _NGSTREFFTZ_MKL_HINTS "$ENV{MKLROOT}/lib/cmake/mkl")
+    endif()
+    list(APPEND _NGSTREFFTZ_MKL_HINTS
+        "/opt/intel/oneapi/mkl/latest/lib/cmake/mkl"
+        "$ENV{HOME}/.local/lib/cmake/mkl"
+    )
+    find_package(MKL CONFIG QUIET HINTS ${_NGSTREFFTZ_MKL_HINTS})
+endif()
+
+# Older NGSolve wheels used the PyPI mkl-devel package.
+if(NOT TARGET MKL::MKL)
+    find_package(Python3 QUIET COMPONENTS Interpreter)
+    if(Python3_Interpreter_FOUND)
+        execute_process(
+            COMMAND "${Python3_EXECUTABLE}" -c
+                "from importlib.metadata import files; fs=files('mkl-devel') or []; print(next((str(p.locate().parent.resolve()) for p in fs if p.name == 'MKLConfig.cmake'), ''))"
+            RESULT_VARIABLE _NGSTREFFTZ_MKL_QUERY_RESULT
+            OUTPUT_VARIABLE _NGSTREFFTZ_MKL_CONFIG_DIR
+            OUTPUT_STRIP_TRAILING_WHITESPACE
+            ERROR_QUIET
+        )
+        if(_NGSTREFFTZ_MKL_QUERY_RESULT EQUAL 0
+           AND _NGSTREFFTZ_MKL_CONFIG_DIR
+           AND EXISTS "${_NGSTREFFTZ_MKL_CONFIG_DIR}/MKLConfig.cmake")
+            find_package(MKL CONFIG QUIET
+                HINTS "${_NGSTREFFTZ_MKL_CONFIG_DIR}"
+                NO_DEFAULT_PATH
+            )
+        endif()
+    endif()
+endif()
+
+if(TARGET MKL::MKL)
+    message(STATUS "Preloaded MKL::MKL for the NGSolve CMake package")
+endif()
+
+unset(_NGSTREFFTZ_MKL_HINTS)
+unset(_NGSTREFFTZ_MKL_QUERY_RESULT)
+unset(_NGSTREFFTZ_MKL_CONFIG_DIR)
+
+function(ngstrefftz_relocate_ngsolve_openblas)
+    if(NOT TARGET ngs_lapack OR APPLE)
+        return()
+    endif()
+
+    get_target_property(_ngs_lapack_libs ngs_lapack INTERFACE_LINK_LIBRARIES)
+    if(NOT _ngs_lapack_libs)
+        return()
+    endif()
+
+    set(_ngs_openblas_paths_are_stale FALSE)
+    foreach(_lib IN LISTS _ngs_lapack_libs)
+        if(IS_ABSOLUTE "${_lib}"
+           AND "${_lib}" MATCHES "ngsolve_openblas"
+           AND NOT EXISTS "${_lib}")
+            set(_ngs_openblas_paths_are_stale TRUE)
+        endif()
+    endforeach()
+
+    if(NOT _ngs_openblas_paths_are_stale)
+        return()
+    endif()
+
+    find_package(Python3 REQUIRED COMPONENTS Interpreter)
+
+    execute_process(
+        COMMAND "${Python3_EXECUTABLE}" -c
+            "import importlib.util, pathlib, sys; s=importlib.util.find_spec('ngsolve_openblas'); p=pathlib.Path(next(iter(s.submodule_search_locations))) if s and s.submodule_search_locations else None; libs=([*p.glob('libopenblas*.so*'), *p.glob('libgfortran*.so*')] if p and sys.platform.startswith('linux') else ([p/'openblas.lib'] if p and sys.platform.startswith('win') else [])); print(';'.join(str(x.resolve()) for x in libs if x.exists()))"
+        RESULT_VARIABLE _ngs_openblas_query_result
+        OUTPUT_VARIABLE _ngs_openblas_libraries
+        OUTPUT_STRIP_TRAILING_WHITESPACE
+        ERROR_VARIABLE _ngs_openblas_query_error
+    )
+
+    if(NOT _ngs_openblas_query_result EQUAL 0 OR NOT _ngs_openblas_libraries)
+        message(FATAL_ERROR
+            "NGSolve's ngs_lapack target contains stale ngsolve_openblas paths, "
+            "but the active Python environment does not provide usable OpenBLAS "
+            "libraries. Python error: ${_ngs_openblas_query_error}")
+    endif()
+
+    message(STATUS
+        "Relocating NGSolve OpenBLAS link interface to: ${_ngs_openblas_libraries}")
+    set_property(TARGET ngs_lapack PROPERTY
+        INTERFACE_LINK_LIBRARIES "${_ngs_openblas_libraries}")
+endfunction()
+# -----------------------------------------------------------------------------
+
 ### ngstrefftz
 
 set(addon_name ngstrefftz)
 project(ngstrefftz)
 include_directories(SYSTEM ${CMAKE_SOURCE_DIR}/external_dependencies/ngstents/src) # SYSTEM to suppress warnings from headers
 include(${CMAKE_BINARY_DIR}/cmake_modules/ngsolve_addon.cmake)
+ngstrefftz_relocate_ngsolve_openblas()
 add_ngsolve_addon(ngstrefftz
     ${CMAKE_SOURCE_DIR}/external_dependencies/ngstents/src/tents.cpp
     src/python_trefftz.cpp
@@ -90,98 +189,23 @@ endif()
 ### user options
 set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR} CACHE PATH "build dir")
 set(NGSTREFFTZ_USE_GTEST OFF CACHE BOOL "Try to use gtest")
-set(NGSTREFFTZ_USE_MKL ${NGSOLVE_USE_MKL} CACHE BOOL "Try to use mkl")
-set(NGSTREFFTZ_USE_LAPACK ${NGSOLVE_USE_LAPACK} CACHE BOOL "Try to use lapack from ngsolve")
-
-### link LAPACK or MKL if possible
-if (NGSTREFFTZ_USE_MKL)
-    download_if_possible(
-        "https://raw.githubusercontent.com/NGSolve/ngsolve/master/cmake/cmake_modules/FindMKL.cmake"
-        "${CMAKE_BINARY_DIR}/cmake_modules/FindMKL.cmake")
-
-    #file(COPY ${CMAKE_SOURCE_DIR}/FindMKL.cmake DESTINATION
-    #"${CMAKE_BINARY_DIR}/cmake_modules/FindMKL.cmake")
-
-    #message(STATUS "MKL_ROOT=${MKL_ROOT}")
-    #message(STATUS "NGSOLVED=${NGSolve_DIR}")
-
-    #set(PIP_MKL_ROOT FALSE CACHE BOOL "Set to true if MKL_ROOT is set by pip")
-    #message(STATUS "PIP_MKL_ROOT=${PIP_MKL_ROOT}")
-    #if(PIP_MKL_ROOT AND LINUX)
-        #set(MKL_ROOT "${NGSolve_DIR}/../../.." CACHE PATH "MKL root directory" )
-        #set(MKL_LIBRARY "${MKL_ROOT}/lib/libmkl_rt.so.2" CACHE PATH "MKL library" )
-        #set(MKL_INCLUDE_DIR "${MKL_ROOT}/include" CACHE PATH "MKL include directory" )
-        #message(STATUS "set MKL_LIBRARY=${MKL_LIBRARY}")
-    #elseif(PIP_MKL_ROOT AND WIN32)
-        #set(MKL_ROOT "${NGSolve_DIR}/../../../.." CACHE PATH "MKL root directory" )
-        #set(MKL_LIBRARY "${MKL_ROOT}/Library/lib/mkl_rt.lib" CACHE PATH "MKL library" )
-        #set(MKL_INCLUDE_DIR "${MKL_ROOT}/Library/include" CACHE PATH "MKL include directory" )
-    #endif()
-
-    set(MKL_ARCH "intel64")
-    if(NOT MKL_INTERFACE)
-        set(MKL_INTERFACE "lp64")
-    endif(NOT MKL_INTERFACE)
-    set(MKL_MULTI_THREADED ON CACHE BOOL "Use threaded MKL libs")
-    if(NOT MKL_MULTI_THREADED)
-      set(MKL_THREADING sequential)
-    endif()
-    set(MKL_STATIC OFF CACHE BOOL "Link static MKL")
-    set(MKL_SDL ON CACHE BOOL "Link single dynamic MKL lib")
-    if(NOT MKL_LINK)
-      if(MKL_STATIC)
-        set(MKL_LINK static)
-      elseif(MKL_SDL)
-        set(MKL_LINK sdl)
-      else()
-        set(MKL_LINK dynamic)
-      endif()
-    endif()
+set(NGSTREFFTZ_USE_LAPACK ${NGSOLVE_USE_LAPACK} CACHE BOOL
+    "Use the BLAS/LAPACK backend exported by NGSolve")
+set(NGSTREFFTZ_USE_MKL ${NGSOLVE_USE_MKL})
 
-    file(WRITE ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/findmklconf.py "from contextlib import suppress;import importlib.metadata; [print( f.locate().parent.resolve().absolute().as_posix()) if f.match('MKLConfig.cmake') else 0 for f in importlib.metadata.files('mkl-devel')]")
-    execute_process(COMMAND ${Python3_EXECUTABLE} ${CMAKE_LIBRARY_OUTPUT_DIRECTORY}/findmklconf.py ERROR_QUIET OUTPUT_STRIP_TRAILING_WHITESPACE OUTPUT_VARIABLE MKL_CONF_FROM_PY)
-    if(MKL_CONF_FROM_PY)
-        message(STATUS "MKL_CONF_FROM_PY=${MKL_CONF_FROM_PY}")
-        message(STATUS "pylibdir=${python3_library_dir}")
-        set(MKL_ROOT ${MKL_CONF_FROM_PY}/../../.. CACHE PATH "MKL root directory" )
-        set(MKL_LIBRARY ${MKL_ROOT}/lib/libmkl_rt.so.2 CACHE PATH "MKL library" )
-        set(MKL_INCLUDE_DIR ${MKL_ROOT}/include CACHE PATH "MKL include directory" )
+### use the LAPACK backend exported by NGSolve hopefully...
+if(NGSTREFFTZ_USE_LAPACK)
+    if(NOT NGSOLVE_USE_LAPACK)
+        message(FATAL_ERROR "NGSTREFFTZ_USE_LAPACK=ON, but NGSolve was built without LAPACK")
+    elseif(NOT TARGET ngs_lapack)
+        message(FATAL_ERROR "NGSolve reports LAPACK support, but did not export the ngs_lapack target")
     endif()
-    #set(MKL_VERSION_H "${MKL_ROOT}/include/mkl_version.h")
-
-    #set(d lib/cmake/mkl)
-    #find_package(MKL CONFIG REQUIRED HINTS ${MKL_CONF} ${MKL_ROOT}/${d} PATHS /opt/intel/oneapi/mkl/latest/${d} ~/.local/${d})
-
-    unset(USE_MPI CACHE)
-    find_package(MKL)
-
-    #if(USE_MUMPS)
-        ## include scalapack
-        #set( LAPACK_LIBRARIES "${MKL_LIBRARIES}")
-        #set( ENABLE_SCALAPACK ON)
-    #else(USE_MUMPS)
-        #set( LAPACK_LIBRARIES "${MKL_MINIMAL_LIBRARIES}")
-    #endif(USE_MUMPS)
-
-    if(MKL_FOUND)
-        message(STATUS "Found MKL_MINIMAL_LIBRARIES=${MKL_MINIMAL_LIBRARIES}")
-        set( LAPACK_LIBRARIES "${MKL_MINIMAL_LIBRARIES}")
-    else()
-        message("${Red}MKL not found!${ColourReset}")
-    endif()
-endif (NGSTREFFTZ_USE_MKL)
-if(NGSTREFFTZ_USE_LAPACK AND NOT LAPACK_LIBRARIES)
-    message(STATUS "Looking for LAPACK")
-    find_package(LAPACK)
-endif(NGSTREFFTZ_USE_LAPACK AND NOT LAPACK_LIBRARIES)
-if(LAPACK_LIBRARIES)
-    #target_link_libraries(ngstrefftz PRIVATE $<BUILD_INTERFACE:ngs_lapack>)
-    message(STATUS "Linking with LAPACK_LIBRARIES=${LAPACK_LIBRARIES}")
-    target_link_libraries(ngstrefftz PRIVATE ${LAPACK_LIBRARIES})
+    message(STATUS "Linking NGSTrefftz against the NGSolve ngs_lapack target")
+    target_link_libraries(ngstrefftz PRIVATE ngs_lapack)
     target_compile_definitions(ngstrefftz PRIVATE NGSTREFFTZ_USE_LAPACK)
-else(LAPACK_LIBRARIES)
-    message("${Red}LAPACK not found, restricted usage${ColourReset}")
-endif(LAPACK_LIBRARIES)
+else()
+    message(WARNING "LAPACK disabled for NGSTrefftz, restricted usage!")
+endif()
 
 ### doc
 option(NGSTREFFTZ_BUILD_DOC "Build documentation" OFF)
@@ -247,11 +271,10 @@ if(NGSTREFFTZ_USE_GTEST)
     find_package(GTest REQUIRED)
     include(GoogleTest)
     if(CMAKE_VERSION VERSION_GREATER_EQUAL "3.18")
-        find_package(Python3 REQUIRED COMPONENTS Development.Embed)
+        find_package(Python3 REQUIRED COMPONENTS Interpreter Development.Embed)
     endif()
-    add_executable(trefftz_gtest
-        ${CMAKE_SOURCE_DIR}/test/embtrefftz_gtest.cpp
-    )
+    add_executable(trefftz_gtest ${CMAKE_SOURCE_DIR}/test/embtrefftz_gtest.cpp)
+
     target_include_directories(trefftz_gtest BEFORE PRIVATE
         $<TARGET_PROPERTY:ngsolve,INTERFACE_INCLUDE_DIRECTORIES>
         ${CMAKE_SOURCE_DIR}/src
@@ -262,9 +285,12 @@ if(NGSTREFFTZ_USE_GTEST)
         ngsolve
         ngstrefftz
     )
+    if(TARGET ngs_lapack)
+        target_link_libraries(trefftz_gtest PRIVATE ngs_lapack)
+    endif()
     set_target_properties(trefftz_gtest PROPERTIES
         PREFIX ""
-        CXX_STANDARD 17
+        CXX_STANDARD 20
         CXX_STANDARD_REQUIRED ON
     )
     gtest_add_tests(TARGET trefftz_gtest)

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/PKG-INFO

@@ -1,15 +1,13 @@
 Metadata-Version: 2.2
 Name: ngstrefftz
-Version: 0.3.2602.dev11
+Version: 0.3.2604.dev5
 Summary: NGSTrefftz is an add-on to NGSolve for Trefftz methods.
 Author-Email: Paul Stocker <paul.stocker@univie.ac.at>
 Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
 Project-URL: Documentation, https://paulst.github.io/NGSTrefftz
 Project-URL: Repository, https://github.com/PaulSt/ngstrefftz
 Requires-Python: >=3.10
-Requires-Dist: mkl<2026.0,>=2024; platform_system != "Darwin"
-Requires-Dist: mkl-devel<2026.0,>=2024; platform_system != "Darwin"
-Requires-Dist: ngsolve==6.2.2603
+Requires-Dist: ngsolve==6.2.2605
 Description-Content-Type: text/markdown
 
 # NGSTrefftz
@@ -25,10 +23,15 @@ Description-Content-Type: text/markdown
 NGSTrefftz provides a framework to implement Trefftz finite element spaces for [NGSolve](https://www.ngsolve.org), with several Trefftz spaces already implemented. Additionally, Trefftz-DG on tent-pitched meshes for the acoustic wave equation is implemented using meshes provided by [ngstents](https://github.com/jayggg/ngstents). Furthermore, the package includes an implementation of the embedded Trefftz method.
 
 ## Try it out!
-You can try out some jupyter notebooks:
-* Launch the Binder here:   
-  [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/PaulSt/NGSTrefftz/HEAD?filepath=docs%2Fnotebooks%2Findex.ipynb)
-* Or run the docker locally (you need to have docker installed):
+The documentation is available here:
+
+[![docs](https://img.shields.io/badge/docs-NGSTrefftz-blue?logo=readthedocs)](https://paulst.github.io/NGSTrefftz/)
+
+You can also try the example notebooks directly in Binder:
+
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/PaulSt/NGSTrefftz/HEAD?filepath=docs%2Fnotebooks%2Findex.ipynb)
+
+or run them locally using Docker:
 
 ```bash
 git clone https://github.com/PaulSt/NGSTrefftz
@@ -36,43 +39,40 @@ cd NGSTrefftz && docker build -t ngstrefftz_jupyter .
 docker run -p 8888:8888 ngstrefftz_jupyter
 ```
 
-## Installing the package
-You can either:
- * install using pip
-
+## Installation
+The recommended installation is via pip:
 ```bash
 pip install ngstrefftz
 ```
-
- * or build from source
-
+Alternatively, to build NGSTrefftz from source:
 ```bash
 git clone --recursive https://github.com/PaulSt/NGSTrefftz
 mkdir ./NGSTrefftz/make && cd ./NGSTrefftz/make
 cmake ../ && make install
 ```
+When building from source, the following dependencies are required:
 
-### Dependencies
- * if you are using pip to install the package you can install the newest ngsolve and other dependencies using
-```bash
-pip install ngsolve --pre
-```
- * if you build the package from source the following software needs to be installed
-   * [cmake](https://cmake.org/) >= 3.1
-   * [gcc](https://gcc.gnu.org/) >= 9 or [clang](https://clang.llvm.org/) >= 10
-   * [lapack](http://www.netlib.org/lapack/) >= 3.9 (required to access the newest features)
-   * [ngsolve](https://www.ngsolve.org) >= 6.2  (to access the newest features the nightly version of NGSolve works best)
+* [cmake](https://cmake.org/) >= 3.1
+* [gcc](https://gcc.gnu.org/) >= 9 or [clang](https://clang.llvm.org/) >= 10
+* [lapack](http://www.netlib.org/lapack/) >= 3.9
+* [ngsolve](https://www.ngsolve.org) >= 6.2
+
+For access to the newest features, the nightly version of NGSolve usually works best.
 
 ## News
+🚀 Jan, 2026: [Trefftz Workshop](https://trefftz2026.univie.ac.at/) will be held on 7-9 September 2026 in Vienna, Austria
+
 ⚠️ Apr, 2025: `TrefftzEmbedding` has a new interface, please check the documentation for details.
 
-🚀 Jul, 2024: Conforming Trefftz embedding implementation by [@johann-cm](https://github.com/johann-cm) 
+🚀 Jul, 2024: Conforming Trefftz embedding implementation by [@johann-cm](https://github.com/johann-cm) with examples in [ngstSpaceKit](https://codeberg.org/johann-cm/ngstspacekit)
+<details>
+<summary>Older news</summary>
 
 ⚠️ Oct, 2022: With v0.2.0 the git history has undergone a major cleanup, please make sure to clone the repo anew.
 
 🚀 Oct, 2022: New and improved implementation of the embedded Trefftz method via `EmbeddedTrefftzFES`!
 
-🚀 Aug, 2022: Three different [pip](https://pypi.org/search/?q=ngstrefftz)-installer available, now using wheels! 
+🚀 Aug, 2022: [pip](https://pypi.org/search/?q=ngstrefftz)-installer available, now using wheels! 
 
 🚀 Mar, 2022: NGSTrefftz now has a [website](https://paulst.github.io/NGSTrefftz/)! 
 
@@ -81,8 +81,49 @@ pip install ngsolve --pre
 🚀 Jan, 2022: NGSTrefftz is now available via pip! 
 
 🚀 Nov, 2021: NGSTrefftz now comes in a docker and with binder notebooks! 
+</details>
+
+## Publications and citation
+
+If you are using `ngstrefftz` in your academic work, please consider citing the JOSS paper:
+
+```
+@article{Stocker2022NGSTrefftz,
+  author  = {Stocker, Paul},
+  title   = {{NGSTrefftz}: Add-on to {NGSolve} for {Trefftz} methods},
+  journal = {Journal of Open Source Software},
+  year    = {2022},
+  volume  = {7},
+  number  = {71},
+  pages   = {4135},
+  doi     = {10.21105/joss.04135}
+}
+```
 
-## Publications using the code
+<details>
+<summary><h3>Publications using NGSTrefftz</h3></summary>
+  
+* *Embedded Trefftz DG method for steady Navier-Stokes flow. Part II: Nonlinear problem*  
+Paul Stocker, Igor Voulis, Christoph Lehrenfeld, Philip L. Lederer  
+[![arXiv](https://img.shields.io/badge/arXiv-2606.13219-b31b1b.svg)](https://arxiv.org/abs/2606.13219)
+* *Embedded Trefftz DG method for steady Navier-Stokes flow. Part I: Oseen linearization*  
+Paul Stocker, Igor Voulis, Christoph Lehrenfeld, Philip L. Lederer  
+[![arXiv](https://img.shields.io/badge/arXiv-2606.13229-b31b1b.svg)](https://arxiv.org/abs/2606.13229)
+* *Embedded Trefftz DG method for reaction-diffusion problems on anisotropic meshes*  
+Sergio Gómez, Chiara Perinati, Paul Stocker, Igor Voulis  
+[![arXiv](https://img.shields.io/badge/arXiv-2606.03845-b31b1b.svg)](https://arxiv.org/abs/2606.03845)
+* *Discontinuous Galerkin Trefftz Methods for Model Reduction of Wave Phenomena*  
+Tobias Born, Karsten Urban  
+[PAMM article](https://doi.org/10.1002/pamm.70155)
+* *Releasing the pressure: High-order surface flow discretizations via discrete Helmholtz–Hodge decompositions*  
+Tim Brüers, Christoph Lehrenfeld, Tim van Beeck, Max Wardetzky  
+[![arXiv](https://img.shields.io/badge/arXiv-2603.27714-b31b1b.svg)](https://arxiv.org/abs/2603.27714)
+* *A discontinuous Galerkin method for elliptic-hyperbolic equations*  
+Chiara Perinati, Lise-Marie Imbert-Gérard, Andrea Moiola, Paul Stocker  
+[![arXiv](https://img.shields.io/badge/arXiv-2604.06910-b31b1b.svg)](https://arxiv.org/abs/2604.06910)
+* *Embedded Trefftz DG method for the Helmholtz equation*  
+Paul Stocker, Igor Voulis  
+[![arXiv](https://img.shields.io/badge/arXiv-2603.13034-b31b1b.svg)](https://arxiv.org/abs/2603.13034)
 * *A unified framework for Trefftz-like discretization methods*  
 Philip L. Lederer, Christoph Lehrenfeld, Paul Stocker, Igor Voulis  
 [![arXiv](https://img.shields.io/badge/arXiv-2412.00806-b31b1b.svg)](https://arxiv.org/abs/2412.00806)
@@ -107,14 +148,11 @@ Lise-Marie Imbert-Gérard, Andrea Moiola, Paul Stocker
 * *Tent pitching and Trefftz-DG method for the acoustic wave equation*  
 Ilaria Perugia, Joachim Schöberl, Paul Stocker, Christoph Wintersteiger   
 [![arXiv](https://img.shields.io/badge/arXiv-1907.02367-b31b1b.svg)](https://arxiv.org/abs/1907.02367)
+* *On the Conforming Trefftz Finite Element Method and Applications*  
+Johann Carl Meyer, [Master's thesis](https://doi.org/10.5281/zenodo.17307511)
 * *Space-time Trefftz DG methods for parabolic PDEs*  
 Constanze Heil, [Master's thesis](https://doi.org/10.25625/ZSA8UU/2L4C1E)
 * *Embedded Trefftz Trace DG Methods for PDEs on unfitted Surfaces*  
 Erik Schlesinger, [Master's thesis](https://doi.org/10.25625/QTOPWD/93ZYRQ)
 
-
-If you are using `ngstrefftz` in your academic work, please consider citing 
-```
-Stocker, P., (2022). NGSTrefftz: Add-on to NGSolve for Trefftz methods. 
-Journal of Open Source Software, 7(71), 4135, https://doi.org/10.21105/joss.04135
-```
+</details>

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/README.md

@@ -11,10 +11,15 @@
 NGSTrefftz provides a framework to implement Trefftz finite element spaces for [NGSolve](https://www.ngsolve.org), with several Trefftz spaces already implemented. Additionally, Trefftz-DG on tent-pitched meshes for the acoustic wave equation is implemented using meshes provided by [ngstents](https://github.com/jayggg/ngstents). Furthermore, the package includes an implementation of the embedded Trefftz method.
 
 ## Try it out!
-You can try out some jupyter notebooks:
-* Launch the Binder here:   
-  [![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/PaulSt/NGSTrefftz/HEAD?filepath=docs%2Fnotebooks%2Findex.ipynb)
-* Or run the docker locally (you need to have docker installed):
+The documentation is available here:
+
+[![docs](https://img.shields.io/badge/docs-NGSTrefftz-blue?logo=readthedocs)](https://paulst.github.io/NGSTrefftz/)
+
+You can also try the example notebooks directly in Binder:
+
+[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/PaulSt/NGSTrefftz/HEAD?filepath=docs%2Fnotebooks%2Findex.ipynb)
+
+or run them locally using Docker:
 
 ```bash
 git clone https://github.com/PaulSt/NGSTrefftz
@@ -22,43 +27,40 @@ cd NGSTrefftz && docker build -t ngstrefftz_jupyter .
 docker run -p 8888:8888 ngstrefftz_jupyter
 ```
 
-## Installing the package
-You can either:
- * install using pip
-
+## Installation
+The recommended installation is via pip:
 ```bash
 pip install ngstrefftz
 ```
-
- * or build from source
-
+Alternatively, to build NGSTrefftz from source:
 ```bash
 git clone --recursive https://github.com/PaulSt/NGSTrefftz
 mkdir ./NGSTrefftz/make && cd ./NGSTrefftz/make
 cmake ../ && make install
 ```
+When building from source, the following dependencies are required:
 
-### Dependencies
- * if you are using pip to install the package you can install the newest ngsolve and other dependencies using
-```bash
-pip install ngsolve --pre
-```
- * if you build the package from source the following software needs to be installed
-   * [cmake](https://cmake.org/) >= 3.1
-   * [gcc](https://gcc.gnu.org/) >= 9 or [clang](https://clang.llvm.org/) >= 10
-   * [lapack](http://www.netlib.org/lapack/) >= 3.9 (required to access the newest features)
-   * [ngsolve](https://www.ngsolve.org) >= 6.2  (to access the newest features the nightly version of NGSolve works best)
+* [cmake](https://cmake.org/) >= 3.1
+* [gcc](https://gcc.gnu.org/) >= 9 or [clang](https://clang.llvm.org/) >= 10
+* [lapack](http://www.netlib.org/lapack/) >= 3.9
+* [ngsolve](https://www.ngsolve.org) >= 6.2
+
+For access to the newest features, the nightly version of NGSolve usually works best.
 
 ## News
+🚀 Jan, 2026: [Trefftz Workshop](https://trefftz2026.univie.ac.at/) will be held on 7-9 September 2026 in Vienna, Austria
+
 ⚠️ Apr, 2025: `TrefftzEmbedding` has a new interface, please check the documentation for details.
 
-🚀 Jul, 2024: Conforming Trefftz embedding implementation by [@johann-cm](https://github.com/johann-cm) 
+🚀 Jul, 2024: Conforming Trefftz embedding implementation by [@johann-cm](https://github.com/johann-cm) with examples in [ngstSpaceKit](https://codeberg.org/johann-cm/ngstspacekit)
+<details>
+<summary>Older news</summary>
 
 ⚠️ Oct, 2022: With v0.2.0 the git history has undergone a major cleanup, please make sure to clone the repo anew.
 
 🚀 Oct, 2022: New and improved implementation of the embedded Trefftz method via `EmbeddedTrefftzFES`!
 
-🚀 Aug, 2022: Three different [pip](https://pypi.org/search/?q=ngstrefftz)-installer available, now using wheels! 
+🚀 Aug, 2022: [pip](https://pypi.org/search/?q=ngstrefftz)-installer available, now using wheels! 
 
 🚀 Mar, 2022: NGSTrefftz now has a [website](https://paulst.github.io/NGSTrefftz/)! 
 
@@ -67,8 +69,49 @@ pip install ngsolve --pre
 🚀 Jan, 2022: NGSTrefftz is now available via pip! 
 
 🚀 Nov, 2021: NGSTrefftz now comes in a docker and with binder notebooks! 
+</details>
+
+## Publications and citation
+
+If you are using `ngstrefftz` in your academic work, please consider citing the JOSS paper:
+
+```
+@article{Stocker2022NGSTrefftz,
+  author  = {Stocker, Paul},
+  title   = {{NGSTrefftz}: Add-on to {NGSolve} for {Trefftz} methods},
+  journal = {Journal of Open Source Software},
+  year    = {2022},
+  volume  = {7},
+  number  = {71},
+  pages   = {4135},
+  doi     = {10.21105/joss.04135}
+}
+```
 
-## Publications using the code
+<details>
+<summary><h3>Publications using NGSTrefftz</h3></summary>
+  
+* *Embedded Trefftz DG method for steady Navier-Stokes flow. Part II: Nonlinear problem*  
+Paul Stocker, Igor Voulis, Christoph Lehrenfeld, Philip L. Lederer  
+[![arXiv](https://img.shields.io/badge/arXiv-2606.13219-b31b1b.svg)](https://arxiv.org/abs/2606.13219)
+* *Embedded Trefftz DG method for steady Navier-Stokes flow. Part I: Oseen linearization*  
+Paul Stocker, Igor Voulis, Christoph Lehrenfeld, Philip L. Lederer  
+[![arXiv](https://img.shields.io/badge/arXiv-2606.13229-b31b1b.svg)](https://arxiv.org/abs/2606.13229)
+* *Embedded Trefftz DG method for reaction-diffusion problems on anisotropic meshes*  
+Sergio Gómez, Chiara Perinati, Paul Stocker, Igor Voulis  
+[![arXiv](https://img.shields.io/badge/arXiv-2606.03845-b31b1b.svg)](https://arxiv.org/abs/2606.03845)
+* *Discontinuous Galerkin Trefftz Methods for Model Reduction of Wave Phenomena*  
+Tobias Born, Karsten Urban  
+[PAMM article](https://doi.org/10.1002/pamm.70155)
+* *Releasing the pressure: High-order surface flow discretizations via discrete Helmholtz–Hodge decompositions*  
+Tim Brüers, Christoph Lehrenfeld, Tim van Beeck, Max Wardetzky  
+[![arXiv](https://img.shields.io/badge/arXiv-2603.27714-b31b1b.svg)](https://arxiv.org/abs/2603.27714)
+* *A discontinuous Galerkin method for elliptic-hyperbolic equations*  
+Chiara Perinati, Lise-Marie Imbert-Gérard, Andrea Moiola, Paul Stocker  
+[![arXiv](https://img.shields.io/badge/arXiv-2604.06910-b31b1b.svg)](https://arxiv.org/abs/2604.06910)
+* *Embedded Trefftz DG method for the Helmholtz equation*  
+Paul Stocker, Igor Voulis  
+[![arXiv](https://img.shields.io/badge/arXiv-2603.13034-b31b1b.svg)](https://arxiv.org/abs/2603.13034)
 * *A unified framework for Trefftz-like discretization methods*  
 Philip L. Lederer, Christoph Lehrenfeld, Paul Stocker, Igor Voulis  
 [![arXiv](https://img.shields.io/badge/arXiv-2412.00806-b31b1b.svg)](https://arxiv.org/abs/2412.00806)
@@ -93,14 +136,11 @@ Lise-Marie Imbert-Gérard, Andrea Moiola, Paul Stocker
 * *Tent pitching and Trefftz-DG method for the acoustic wave equation*  
 Ilaria Perugia, Joachim Schöberl, Paul Stocker, Christoph Wintersteiger   
 [![arXiv](https://img.shields.io/badge/arXiv-1907.02367-b31b1b.svg)](https://arxiv.org/abs/1907.02367)
+* *On the Conforming Trefftz Finite Element Method and Applications*  
+Johann Carl Meyer, [Master's thesis](https://doi.org/10.5281/zenodo.17307511)
 * *Space-time Trefftz DG methods for parabolic PDEs*  
 Constanze Heil, [Master's thesis](https://doi.org/10.25625/ZSA8UU/2L4C1E)
 * *Embedded Trefftz Trace DG Methods for PDEs on unfitted Surfaces*  
 Erik Schlesinger, [Master's thesis](https://doi.org/10.25625/QTOPWD/93ZYRQ)
 
-
-If you are using `ngstrefftz` in your academic work, please consider citing 
-```
-Stocker, P., (2022). NGSTrefftz: Add-on to NGSolve for Trefftz methods. 
-Journal of Open Source Software, 7(71), 4135, https://doi.org/10.21105/joss.04135
-```
+</details>

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/_version.py

@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
 commit_id: str | None
 __commit_id__: str | None
 
-__version__ = version = '0.3.2602.dev11'
-__version_tuple__ = version_tuple = (0, 3, 2602, 'dev11')
+__version__ = version = '0.3.2604.dev5'
+__version_tuple__ = version_tuple = (0, 3, 2604, 'dev5')
 
-__commit_id__ = commit_id = 'gc40007fb1'
+__commit_id__ = commit_id = 'g2374c3cb2'

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/docs/notebooks/embTrefftz-stokes.ipynb

@@ -315,7 +315,7 @@
     "PP, uf = TrefftzStokesEmb(fes, rhs)\n",
     "PPT = PP.CreateTranspose()\n",
     "TA = PPT @ a.mat @ PP\n",
-    "Tgfu = TA.Inverse(inverse=\"pardiso\") * (PPT * (f.vec - a.mat * uf))\n",
+    "Tgfu = TA.Inverse() * (PPT * (f.vec - a.mat * uf))\n",
     "gfu = GridFunction(fes)\n",
     "gfu.vec.data = PP * Tgfu + uf"
    ]

{ngstrefftz-0.3.2602.dev11 → ngstrefftz-0.3.2604.dev5}/docs/requirements.txt

@@ -11,6 +11,7 @@ nbconvert>=7.16.4
 nbformat>=5.10.4
 nbsphinx>=0.8.9
 notebook>=7.2.0
+anywidget>=0.6.0
 
 Sphinx>=7.3.7
 sphinx-rtd-theme>=2.0.0
@@ -22,5 +23,4 @@ numpy>=2.0.0
 scipy>=1.13.1
 webgui-jupyter-widgets>=0.2.35
 
-#ngstrefftz==0.3.2506
-xfem==2.1.2603
+#xfem==2.1.2605