virtual-casing 0.3.0__tar.gz → 0.3.1__tar.gz

virtual_casing-0.3.1/CITATION.cff

@@ -0,0 +1,119 @@
+cff-version: 1.2.0
+message: "If you use virtual-casing, please cite the software and the papers below."
+type: software
+title: "virtual-casing: the virtual-casing principle on toroidal surfaces"
+authors:
+  - given-names: Dhairya
+    family-names: Malhotra
+  - given-names: Bharat
+    family-names: Medasani
+  - given-names: Matt
+    family-names: Landreman
+  - given-names: Chris
+    family-names: Smiet
+  - given-names: Antoine
+    family-names: Cerfon
+abstract: "A C++ library, with C and Python interfaces, that computes from the total magnetic field on a toroidal surface the part due to currents outside (or inside) the surface, on and off the surface, and the gradient of the external part, using the virtual-casing principle and the high-order singular quadratures of BIEST."
+repository-code: "https://github.com/hiddenSymmetries/virtual-casing"
+license: Apache-2.0
+preferred-citation:
+  type: article
+  title: "Efficient high-order singular quadrature schemes in magnetic fusion"
+  authors:
+    - given-names: Dhairya
+      family-names: Malhotra
+    - given-names: Antoine J.
+      family-names: Cerfon
+    - given-names: Michael
+      family-names: "O'Neil"
+    - given-names: Evan
+      family-names: Toler
+  journal: "Plasma Physics and Controlled Fusion"
+  publisher:
+    name: IOP Publishing
+  volume: 62
+  issue: 2
+  start: "024004"
+  year: 2020
+  month: 2
+  doi: "10.1088/1361-6587/ab57f4"
+references:
+  - type: article
+    title: "Taylor states in stellarators: A fast high-order boundary integral solver"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+      - given-names: Antoine
+        family-names: Cerfon
+      - given-names: Lise-Marie
+        family-names: Imbert-Gérard
+      - given-names: Michael
+        family-names: "O'Neil"
+    journal: "Journal of Computational Physics"
+    publisher:
+      name: Elsevier BV
+    volume: 397
+    start: 108791
+    year: 2019
+    month: 11
+    doi: "10.1016/j.jcp.2019.06.067"
+    notes: "The singular quadrature that virtual-casing uses through BIEST."
+  - type: article
+    title: "Efficient high-order singular quadrature schemes in magnetic fusion"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+      - given-names: Antoine J.
+        family-names: Cerfon
+      - given-names: Michael
+        family-names: "O'Neil"
+      - given-names: Evan
+        family-names: Toler
+    journal: "Plasma Physics and Controlled Fusion"
+    publisher:
+      name: IOP Publishing
+    volume: 62
+    issue: 2
+    start: "024004"
+    year: 2020
+    month: 2
+    doi: "10.1088/1361-6587/ab57f4"
+  - type: software
+    title: "BIEST: Boundary Integral Equation Solver for Taylor states"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+    repository-code: "https://github.com/dmalhotra/BIEST"
+    license: Apache-2.0
+    doi: "10.5281/zenodo.23511944"
+    notes: "virtual-casing uses BIEST's singular quadratures, surface operators and off-surface operator, included as the git submodule extern/BIEST."
+  - type: software
+    title: "SCTL: Scientific Computing Template Library"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+      - given-names: Tianyue
+        family-names: Li
+      - given-names: Robert
+        family-names: Blackwell
+      - given-names: Abtin
+        family-names: Rahimian
+      - given-names: Wen
+        family-names: Yan
+      - given-names: Xuanzhao
+        family-names: Gao
+    repository-code: "https://github.com/dmalhotra/SCTL"
+    url: "https://sctl.readthedocs.io"
+    license: Apache-2.0
+    doi: "10.5281/zenodo.23511629"
+    notes: "virtual-casing is built on SCTL, included as the git submodule extern/SCTL: directly for its containers, and through BIEST for the adaptive near-surface quadrature of off-surface evaluation (QuadElemList), FFTs and Gauss-Legendre rules."
+  - type: software
+    title: findFFTW
+    authors:
+      - given-names: Wenzel
+        family-names: Jakob
+      - given-names: Patrick
+        family-names: Bos
+    repository-code: "https://github.com/egpbos/findFFTW"
+    license: BSD-3-Clause
+    notes: "cmake/FindFFTW.cmake."

virtual_casing-0.3.1/MANIFEST.in

@@ -0,0 +1,9 @@
+include src/python.cpp src/cpu_features.cpp src/__init__.py
+include src/__init__.pyi src/_vc_baseline.pyi src/py.typed
+include test/virtual-casing.cpp
+include LICENSE NOTICE README.md
+graft include
+graft extern/SCTL/include
+graft extern/BIEST/include
+graft cmake
+global-include CMakeLists.txt *.cmake

virtual_casing-0.3.1/NOTICE

@@ -0,0 +1,38 @@
+virtual-casing: the virtual-casing principle on toroidal surfaces
+
+Copyright (C) 2021-2026 The Simons Foundation, Inc. and the virtual-casing authors
+
+Authors:
+  Dhairya Malhotra (lead author)
+  Bharat Medasani (Python bindings, the C++ interface returning values, CMake
+    build and Python packaging)
+  Matt Landreman (Python tests, documentation of the grids)
+  Chris Smiet (Python docstrings and argument names)
+  Antoine Cerfon (analytic field in the axisymmetric test)
+Each source file names its own authors in its header.
+
+Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+Ports and translations of this code to other programming languages, whether
+made by hand or with automated tools, are derived from this work. The authors
+of this code remain authors of every part derived from it, and Section 4 of
+the License requires distributions of such works to retain this notice and
+the notices in the file headers.
+
+Request from the authors:
+  - Cite virtual-casing, BIEST, SCTL and the publications describing them
+    (listed in README.md and CITATION.cff) in work that uses it.
+  - A port or translation of virtual-casing as a whole, or of a substantial
+    part of it, lists the authors named in the headers of the files it
+    derives from in its own author list, credited for the original
+    implementation, just as a translated book keeps its author and credits
+    its translator. Smaller reuse credits them as third-party code, as
+    virtual-casing does for its third-party code.
+  - Do not use this code to generate automated ports or clones without
+    substantive human oversight and understanding of its design.
+  - Do not use this code or its documentation to train AI models.
+
+Third-party code:
+  cmake/FindFFTW.cmake, from findFFTW (https://github.com/egpbos/findFFTW),
+  Copyright (c) 2015 Wenzel Jakob and (c) 2017 Patrick Bos, BSD-3-Clause
+  License (see the file header).

virtual_casing-0.3.1/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: virtual_casing
+Version: 0.3.1
+Summary: Python Wrapper for Virtual Casing
+Author: Dhairya Malhotra, Matt Landreman, Chris Smiet, Antoine Cerfon
+Author-Email: Bharat Medasani <mbkumar@gmail.com>
+Maintainer: Dhairya Malhotra, Bharat Medasani, Matt Landreman, Chris Smiet
+License-Expression: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: C++
+Classifier: Operating System :: OS Independent
+Project-URL: Repository, https://github.com/hiddenSymmetries/virtual-casing
+Project-URL: Issues, https://github.com/hiddenSymmetries/virtual-casing/issues
+Requires-Python: >=3.10
+Provides-Extra: test
+Requires-Dist: pytest>=6.0; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pybind11-stubgen<4,>=3.0; extra == "dev"
+Requires-Dist: pytest; extra == "dev"
+Description-Content-Type: text/markdown
+
+# virtual-casing
+
+## Installation
+### C++ Executable
+In addition to having C++ compiler (tested with GCC-9 and newer) that supports C++17 standard and OpenMP, install FFTW and LAPACK libraries. Intel MKL provides both of them.
+Also install cmake package. The CMake setup is written in a monolithic way so we have to install python dependencies also,
+even though they are strictly not required. On the python side, we require python header files and Numpy. All of them can be installed by using pip.
+
+    pip install cmake numpy
+  
+Create a folder called ``build`` and switch to ``build`` directory. 
+
+    mkdir build; cd build
+    
+Run cmake from within the build folder.
+
+    cmake ..
+  
+If the above command succeeds, we can go to the next step. Build the ``vc_testing`` executable by running
+
+    make vc_testing
+  
+If the compilation is successful, you will have ``vc_testing`` in the ``build`` folder. 
+
+Optionally, set the environment variable ``LIBXSMM_DIR`` to a build of [LIBXSMM](https://github.com/libxsmm/libxsmm)
+(version 2.0 or newer) before running cmake, or before installing the Python package, to use it for small matrix
+products. The Makefile uses it in the same way.
+
+
+### Python package
+
+To install the python package use pip:
+
+    python -m pip install .
+
+To build the wheel use:
+
+    python -m build --wheel
+
+which can be installed by:
+
+    pip install dist/virtual_casing*.whl
+
+## Testing
+
+Run the tests using
+
+    python -m unittest test -v
+
+## Citing virtual-casing
+
+If you use virtual-casing, or code derived from it, please cite the software and the papers below (also listed in [CITATION.cff](CITATION.cff)):
+
+- D. Malhotra, B. Medasani, M. Landreman, C. Smiet, A. Cerfon, *virtual-casing: the virtual-casing principle on toroidal surfaces*, https://github.com/hiddenSymmetries/virtual-casing.
+- D. Malhotra, *BIEST: Boundary Integral Equation Solver for Taylor states*, https://github.com/dmalhotra/BIEST, [doi:10.5281/zenodo.23511944](https://doi.org/10.5281/zenodo.23511944).
+- D. Malhotra, T. Li, R. Blackwell, A. Rahimian, W. Yan, X. Gao, *SCTL: Scientific Computing Template Library*, https://github.com/dmalhotra/SCTL, [doi:10.5281/zenodo.23511629](https://doi.org/10.5281/zenodo.23511629).
+- D. Malhotra, A. J. Cerfon, M. O'Neil, E. Toler, "Efficient high-order singular quadrature schemes in magnetic fusion," *Plasma Physics and Controlled Fusion* 62 (2020) 024004, [doi:10.1088/1361-6587/ab57f4](https://doi.org/10.1088/1361-6587/ab57f4).
+- D. Malhotra, A. Cerfon, L.-M. Imbert-Gérard, M. O'Neil, "Taylor states in stellarators: A fast high-order boundary integral solver," *Journal of Computational Physics* 397 (2019) 108791, [doi:10.1016/j.jcp.2019.06.067](https://doi.org/10.1016/j.jcp.2019.06.067).
+
+<details>
+<summary>BibTeX</summary>
+
+```bibtex
+@software{virtualcasing,
+  author    = {Malhotra, Dhairya and Medasani, Bharat and Landreman, Matt and Smiet, Chris and Cerfon, Antoine},
+  title     = {virtual-casing: the virtual-casing principle on toroidal surfaces},
+  url       = {https://github.com/hiddenSymmetries/virtual-casing},
+  version   = {0.3.0},
+  year      = {2026}
+}
+
+@software{biest,
+  author    = {Malhotra, Dhairya},
+  title     = {{BIEST}: Boundary Integral Equation Solver for {Taylor} states},
+  url       = {https://github.com/dmalhotra/BIEST},
+  doi       = {10.5281/zenodo.23511944},
+  version   = {1.0.0},
+  year      = {2026}
+}
+
+@software{sctl,
+  author    = {Malhotra, Dhairya and Li, Tianyue and Blackwell, Robert and Rahimian, Abtin and Yan, Wen and Gao, Xuanzhao},
+  title     = {{SCTL}: Scientific Computing Template Library},
+  url       = {https://github.com/dmalhotra/SCTL},
+  doi       = {10.5281/zenodo.23511629},
+  version   = {2.0.0},
+  year      = {2026}
+}
+
+@article{malhotra2020quadrature,
+  author  = {Malhotra, Dhairya and Cerfon, Antoine J. and O'Neil, Michael and Toler, Evan},
+  title   = {Efficient high-order singular quadrature schemes in magnetic fusion},
+  journal = {Plasma Physics and Controlled Fusion},
+  volume  = {62},
+  number  = {2},
+  pages   = {024004},
+  year    = {2020},
+  doi     = {10.1088/1361-6587/ab57f4}
+}
+
+@article{malhotra2019taylor,
+  author  = {Malhotra, Dhairya and Cerfon, Antoine and Imbert-G{\'e}rard, Lise-Marie and O'Neil, Michael},
+  title   = {Taylor states in stellarators: A fast high-order boundary integral solver},
+  journal = {Journal of Computational Physics},
+  volume  = {397},
+  pages   = {108791},
+  year    = {2019},
+  doi     = {10.1016/j.jcp.2019.06.067}
+}
+```
+
+</details>
+
+## License
+
+virtual-casing is licensed under the [Apache License 2.0](LICENSE). The [NOTICE](NOTICE) file lists the authors and must be kept in any redistribution, including ports to other languages. It also has the authors' requests on crediting them and on AI use.

virtual_casing-0.3.1/README.md

@@ -0,0 +1,116 @@
+# virtual-casing
+
+## Installation
+### C++ Executable
+In addition to having C++ compiler (tested with GCC-9 and newer) that supports C++17 standard and OpenMP, install FFTW and LAPACK libraries. Intel MKL provides both of them.
+Also install cmake package. The CMake setup is written in a monolithic way so we have to install python dependencies also,
+even though they are strictly not required. On the python side, we require python header files and Numpy. All of them can be installed by using pip.
+
+    pip install cmake numpy
+  
+Create a folder called ``build`` and switch to ``build`` directory. 
+
+    mkdir build; cd build
+    
+Run cmake from within the build folder.
+
+    cmake ..
+  
+If the above command succeeds, we can go to the next step. Build the ``vc_testing`` executable by running
+
+    make vc_testing
+  
+If the compilation is successful, you will have ``vc_testing`` in the ``build`` folder. 
+
+Optionally, set the environment variable ``LIBXSMM_DIR`` to a build of [LIBXSMM](https://github.com/libxsmm/libxsmm)
+(version 2.0 or newer) before running cmake, or before installing the Python package, to use it for small matrix
+products. The Makefile uses it in the same way.
+
+
+### Python package
+
+To install the python package use pip:
+
+    python -m pip install .
+
+To build the wheel use:
+
+    python -m build --wheel
+
+which can be installed by:
+
+    pip install dist/virtual_casing*.whl
+
+## Testing
+
+Run the tests using
+
+    python -m unittest test -v
+
+## Citing virtual-casing
+
+If you use virtual-casing, or code derived from it, please cite the software and the papers below (also listed in [CITATION.cff](CITATION.cff)):
+
+- D. Malhotra, B. Medasani, M. Landreman, C. Smiet, A. Cerfon, *virtual-casing: the virtual-casing principle on toroidal surfaces*, https://github.com/hiddenSymmetries/virtual-casing.
+- D. Malhotra, *BIEST: Boundary Integral Equation Solver for Taylor states*, https://github.com/dmalhotra/BIEST, [doi:10.5281/zenodo.23511944](https://doi.org/10.5281/zenodo.23511944).
+- D. Malhotra, T. Li, R. Blackwell, A. Rahimian, W. Yan, X. Gao, *SCTL: Scientific Computing Template Library*, https://github.com/dmalhotra/SCTL, [doi:10.5281/zenodo.23511629](https://doi.org/10.5281/zenodo.23511629).
+- D. Malhotra, A. J. Cerfon, M. O'Neil, E. Toler, "Efficient high-order singular quadrature schemes in magnetic fusion," *Plasma Physics and Controlled Fusion* 62 (2020) 024004, [doi:10.1088/1361-6587/ab57f4](https://doi.org/10.1088/1361-6587/ab57f4).
+- D. Malhotra, A. Cerfon, L.-M. Imbert-Gérard, M. O'Neil, "Taylor states in stellarators: A fast high-order boundary integral solver," *Journal of Computational Physics* 397 (2019) 108791, [doi:10.1016/j.jcp.2019.06.067](https://doi.org/10.1016/j.jcp.2019.06.067).
+
+<details>
+<summary>BibTeX</summary>
+
+```bibtex
+@software{virtualcasing,
+  author    = {Malhotra, Dhairya and Medasani, Bharat and Landreman, Matt and Smiet, Chris and Cerfon, Antoine},
+  title     = {virtual-casing: the virtual-casing principle on toroidal surfaces},
+  url       = {https://github.com/hiddenSymmetries/virtual-casing},
+  version   = {0.3.0},
+  year      = {2026}
+}
+
+@software{biest,
+  author    = {Malhotra, Dhairya},
+  title     = {{BIEST}: Boundary Integral Equation Solver for {Taylor} states},
+  url       = {https://github.com/dmalhotra/BIEST},
+  doi       = {10.5281/zenodo.23511944},
+  version   = {1.0.0},
+  year      = {2026}
+}
+
+@software{sctl,
+  author    = {Malhotra, Dhairya and Li, Tianyue and Blackwell, Robert and Rahimian, Abtin and Yan, Wen and Gao, Xuanzhao},
+  title     = {{SCTL}: Scientific Computing Template Library},
+  url       = {https://github.com/dmalhotra/SCTL},
+  doi       = {10.5281/zenodo.23511629},
+  version   = {2.0.0},
+  year      = {2026}
+}
+
+@article{malhotra2020quadrature,
+  author  = {Malhotra, Dhairya and Cerfon, Antoine J. and O'Neil, Michael and Toler, Evan},
+  title   = {Efficient high-order singular quadrature schemes in magnetic fusion},
+  journal = {Plasma Physics and Controlled Fusion},
+  volume  = {62},
+  number  = {2},
+  pages   = {024004},
+  year    = {2020},
+  doi     = {10.1088/1361-6587/ab57f4}
+}
+
+@article{malhotra2019taylor,
+  author  = {Malhotra, Dhairya and Cerfon, Antoine and Imbert-G{\'e}rard, Lise-Marie and O'Neil, Michael},
+  title   = {Taylor states in stellarators: A fast high-order boundary integral solver},
+  journal = {Journal of Computational Physics},
+  volume  = {397},
+  pages   = {108791},
+  year    = {2019},
+  doi     = {10.1016/j.jcp.2019.06.067}
+}
+```
+
+</details>
+
+## License
+
+virtual-casing is licensed under the [Apache License 2.0](LICENSE). The [NOTICE](NOTICE) file lists the authors and must be kept in any redistribution, including ports to other languages. It also has the authors' requests on crediting them and on AI use.

virtual_casing-0.3.1/extern/BIEST/CITATION.cff

@@ -0,0 +1,87 @@
+cff-version: 1.2.0
+message: "If you use BIEST, please cite both the software and the paper below."
+type: software
+title: "BIEST: Boundary Integral Equation Solver for Taylor states"
+authors:
+  - given-names: Dhairya
+    family-names: Malhotra
+abstract: "A header-only C++ library of high-order boundary integral equation solvers on toroidal surfaces, for Taylor states (force-free fields) and vacuum magnetic fields in stellarators."
+repository-code: "https://github.com/dmalhotra/BIEST"
+license: Apache-2.0
+version: "1.0.0"
+date-released: "2026-10-20"
+preferred-citation:
+  type: article
+  title: "Taylor states in stellarators: A fast high-order boundary integral solver"
+  authors:
+    - given-names: Dhairya
+      family-names: Malhotra
+    - given-names: Antoine
+      family-names: Cerfon
+    - given-names: Lise-Marie
+      family-names: Imbert-Gérard
+    - given-names: Michael
+      family-names: "O'Neil"
+  journal: "Journal of Computational Physics"
+  publisher:
+    name: Elsevier BV
+  volume: 397
+  start: 108791
+  year: 2019
+  month: 11
+  doi: "10.1016/j.jcp.2019.06.067"
+references:
+  - type: article
+    title: "Taylor states in stellarators: A fast high-order boundary integral solver"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+      - given-names: Antoine
+        family-names: Cerfon
+      - given-names: Lise-Marie
+        family-names: Imbert-Gérard
+      - given-names: Michael
+        family-names: "O'Neil"
+    journal: "Journal of Computational Physics"
+    publisher:
+      name: Elsevier BV
+    volume: 397
+    start: 108791
+    year: 2019
+    month: 11
+    doi: "10.1016/j.jcp.2019.06.067"
+  - type: article
+    title: "Efficient high-order singular quadrature schemes in magnetic fusion"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+      - given-names: Antoine J.
+        family-names: Cerfon
+      - given-names: Michael
+        family-names: "O'Neil"
+      - given-names: Evan
+        family-names: Toler
+    journal: "Plasma Physics and Controlled Fusion"
+    volume: 62
+    issue: 2
+    start: "024004"
+    year: 2020
+    month: 2
+    doi: "10.1088/1361-6587/ab57f4"
+  - type: software
+    title: "SCTL: Scientific Computing Template Library"
+    authors:
+      - given-names: Dhairya
+        family-names: Malhotra
+      - given-names: Tianyue
+        family-names: Li
+      - given-names: Robert
+        family-names: Blackwell
+      - given-names: Wen
+        family-names: Yan
+      - given-names: Xuanzhao
+        family-names: Gao
+    repository-code: "https://github.com/dmalhotra/SCTL"
+    url: "https://sctl.readthedocs.io"
+    license: Apache-2.0
+    notes: "BIEST is built on SCTL, included as the git submodule extern/SCTL."

virtual_casing-0.3.1/extern/BIEST/Makefile

@@ -0,0 +1,100 @@
+CXX=g++ # requires g++-9 or newer / icpc (with gcc compatibility 9 or newer) / clang++ with llvm-10 or newer
+CXXFLAGS = -std=c++17 -fopenmp -Wall -Wfloat-conversion # need C++17 and OpenMP
+
+SCTL_DIR=extern/SCTL
+CXXFLAGS += -I${SCTL_DIR}/include
+
+#Optional flags
+DEBUG ?= 0
+ifeq ($(DEBUG), 1)
+	CXXFLAGS += -O0 -fsanitize=address,leak,undefined,pointer-compare,pointer-subtract,float-divide-by-zero,float-cast-overflow -fno-sanitize-recover=all -fstack-protector # debug build
+	CXXFLAGS += -DSCTL_MEMDEBUG # Enable memory checks
+else
+	CXXFLAGS += -O3 -march=native -DNDEBUG # release build
+endif
+
+OS = $(shell uname -s)
+ifeq "$(OS)" "Darwin"
+	CXXFLAGS += -g -rdynamic -Wl,-no_pie # for stack trace (on Mac)
+else
+	CXXFLAGS += -gdwarf-4 -g -rdynamic # for stack trace
+	CXXFLAGS += -ldl # dladdr() in stacktrace.h (libc on glibc >=2.34, libdl otherwise)
+endif
+
+# GCC `-march=native` on Sapphire Rapids and newer Intel CPUs emits AVX-512-FP16
+# instructions (e.g. `vmovw`) that pre-2.38 binutils' system assembler can't
+# decode. Disable just the FP16 subset; the rest of -march=native is fine. If a
+# newer binutils is available (e.g. `module load binutils/2.43.1`), the user can
+# remove this flag manually. macOS clang doesn't emit avx512fp16 and doesn't
+# recognise the flag on Apple Silicon — skip there.
+ifneq "$(OS)" "Darwin"
+       CXXFLAGS += -mno-avx512fp16
+endif
+
+CXXFLAGS += -DSCTL_GLOBAL_MEM_BUFF=0 # Global memory buffer size in MB
+
+CXXFLAGS += -DSCTL_PROFILE=5 -DSCTL_VERBOSE # Enable profiling
+CXXFLAGS += -DSCTL_SIG_HANDLER
+
+#CXXFLAGS += -DSCTL_QUAD_T=__float128 # Enable quadruple precision
+
+
+CXXFLAGS += -lblas -DSCTL_HAVE_BLAS # use BLAS
+CXXFLAGS += -llapack -DSCTL_HAVE_LAPACK # use LAPACK
+#CXXFLAGS += -lopenblas -DSCTL_HAVE_BLAS -DSCTL_HAVE_LAPACK # use OpenBLAS for both (comment out the two lines above; `module load openblas`)
+#CXXFLAGS += -qmkl -DSCTL_HAVE_BLAS -DSCTL_HAVE_LAPACK -DSCTL_HAVE_FFTW3_MKL # use MKL BLAS, LAPACK and FFTW (Intel compiler)
+#CXXFLAGS += -lmkl_intel_lp64 -lmkl_sequential -lmkl_core -lpthread -DSCTL_HAVE_BLAS -DSCTL_HAVE_LAPACK # use MKL BLAS and LAPACK (non-Intel compiler)
+
+CXXFLAGS += -lfftw3_omp -DSCTL_FFTW_THREADS
+CXXFLAGS += -lfftw3 -DSCTL_HAVE_FFTW
+CXXFLAGS += -lfftw3f -DSCTL_HAVE_FFTWF
+CXXFLAGS += -lfftw3l -DSCTL_HAVE_FFTWL
+
+CXXFLAGS += -lmvec -lm -DSCTL_HAVE_LIBMVEC
+#CXXFLAGS += -DSCTL_HAVE_SVML
+
+#CXXFLAGS += -I${LIBXSMM_DIR}/include -L${LIBXSMM_DIR}/lib -l:libxsmm.a -lpthread -lrt -ldl -lm -DSCTL_HAVE_LIBXSMM # use LIBXSMM on Linux
+#CXXFLAGS += -I${LIBXSMM_DIR}/include -L${LIBXSMM_DIR}/lib -lxsmm -lpthread -ldl -lm -DSCTL_HAVE_LIBXSMM # use LIBXSMM on macOS
+
+#CXXFLAGS += -I${PETSC_DIR}/include -I${PETSC_DIR}/../include -DSCTL_HAVE_PETSC
+#LDLIBS += -L${PETSC_DIR}/lib -lpetsc
+
+RM = rm -f
+MKDIRS = mkdir -p
+
+BINDIR = ./bin
+SRCDIR = ./src
+OBJDIR = ./obj
+INCDIR = ./include
+
+TARGET_BIN = \
+       $(BINDIR)/table1 \
+       $(BINDIR)/table3 \
+       $(BINDIR)/table4 \
+       $(BINDIR)/table5 \
+       $(BINDIR)/table6 \
+       $(BINDIR)/table7 \
+       $(BINDIR)/example1 \
+       $(BINDIR)/quadrature-example \
+       $(BINDIR)/force-free-fields-example \
+       $(BINDIR)/double-layer-convergence \
+       $(BINDIR)/virtual-casing-principle
+
+.PHONY: all clean
+
+all : $(TARGET_BIN)
+
+$(BINDIR)/%: $(OBJDIR)/%.o
+	-@$(MKDIRS) $(dir $@)
+	$(CXX) $^ $(CXXFLAGS) $(LDLIBS) -o $@
+ifeq "$(OS)" "Darwin"
+	/usr/bin/dsymutil $@ -o $@.dSYM
+endif
+
+$(OBJDIR)/%.o: $(SRCDIR)/%.cpp
+	-@$(MKDIRS) $(dir $@)
+	$(CXX) $(CXXFLAGS) -I$(INCDIR) -c $^ -o $@
+
+clean:
+	$(RM) -r $(BINDIR)/* $(OBJDIR)/*
+

virtual_casing-0.3.1/extern/BIEST/NOTICE

@@ -0,0 +1,27 @@
+BIEST: Boundary Integral Equation Solver for Taylor states
+
+Copyright (C) 2018-2026 The Simons Foundation, Inc. and the BIEST authors
+
+Authors:
+  Dhairya Malhotra (lead author)
+Each source file names its own authors in its header.
+
+Licensed under the Apache License, Version 2.0 (see LICENSE).
+
+Ports and translations of this code to other programming languages, whether
+made by hand or with automated tools, are derived from this work. The authors
+of this code remain authors of every part derived from it, and Section 4 of
+the License requires distributions of such works to retain this notice and
+the notices in the file headers.
+
+Request from the authors:
+  - Cite BIEST and the publications describing it (see CITATION.cff) in work
+    that uses it.
+  - A port or translation of BIEST as a whole, or of a substantial part of it,
+    lists the authors named in the headers of the files it derives from in
+    its own author list, credited for the original implementation, just as
+    a translated book keeps its author and credits its translator. Smaller
+    reuse credits them as third-party code.
+  - Do not use this code to generate automated ports or clones without
+    substantive human oversight and understanding of its design.
+  - Do not use this code or its documentation to train AI models.

virtual_casing-0.3.1/extern/BIEST/README.md

@@ -0,0 +1,11 @@
+### Minimum requirements to compile:
+C++ compiler that supports C++17 standard
+
+
+### Optional libraries for better performance:
+BLAS, LAPACK, FFTW, LIBXSMM (see the Makefile)
+
+
+### License
+
+BIEST is licensed under the [Apache License 2.0](LICENSE). The [NOTICE](NOTICE) file lists the authors and must be kept in any redistribution, including ports to other languages. It also has the authors' requests on crediting them and on AI use.