DipolEq

Dipole equilibrium design code

Based on "TokaMac v2.0" by L. Bai and M. Mauel at Columbia University.

Can be used to show high beta equilibria in a dipole confined plasma. In other words, solve the Grad-Shafranov equation in a machine with an "first closed flux surface" and no toroidal field.

The code is licensed under the MIT license. (Except for the ClibPDF code, which no longer is available but was licensed for free use in academic use. This code is not linked into the python package version of this code.)

If you use this code, please reference this paper as source.

D. T. Garnier, J. Kesner, and M. E. Mauel, “Magnetohydrodynamic stability in a levitated dipole,” Phys. Plasmas, vol. 6, no. 9, pp. 3431–3434, Jan. 1999, doi: 10.1063/1.873601.

C Code - Command Line Version

Compilation

The original code is written in C (and some C++) and gives a command line interface, that outputs a PDF, HDF5 and other output files. The code can be compiled with cmake. There are example codes for how to process hdf5 files (into, for example an EFIT gfile) in the postprocess directory.

Dependencies

Ubuntu

The recommended build is for hdf5, zlib and libjpeg libraries to be installed:

sudo apt install cmake gcc zlib1g-dev libjpeg-dev libhdf5-dev

macOS

cmake and hdf5 can be installed with macports or homebrew and should be enough to compile the code.

brew install cmake hdf5

sudo port install cmake hdf5

Build and Install

The code can be configured and compiled with cmake. The recommended way to compile is to create a build directory and run cmake from there:

cd dipoleq
mkdir build
cd build
cmake ..
cmake --build .
sudo cmake --install .

Usage

The code can be run from the command line with the following command:

dipoleq -f <input_file>

See the Testing directories for examples of input files [*.in].

There is a second command line tool that can be used to generate a EFIT gfile from the output hdf5 file:

dipoleq_geqdsk <output.h5>

Python Module Interface

A python version of the code is now available. This relies on the pybind11 library to wrap the C code into a python module. This wraps the main features of the code into a python module, although the outer loop of the code is now in python. The python module is not yet fully documented, but the main features are available, and regularly tested against the original C code. For packaging, the "scikit-build-core" package is used to build the code using a standard pyproject.toml file.

Complilation

The python module can be compiled with the following command: pip install . This may install in your user directory or in a virtual environment. It will also install the dipoleq and dipoleq_geqdsk command line tools as well, though these are actually calls to the python / pybind11 version of the code and no longer include ClibPDF or HDF5 directly. This may become the preferred way to install the code in the future.

Usage

Python usage is still in development. More on this soon.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dipoleq-0.11.2.tar.gz (3.3 MB view details)

Uploaded Sep 1, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

dipoleq-0.11.2-cp314-cp314-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (414.2 kB view details)

Uploaded Sep 1, 2026 CPython 3.14manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

dipoleq-0.11.2-cp314-cp314-macosx_11_0_arm64.whl (329.8 kB view details)

Uploaded Sep 1, 2026 CPython 3.14macOS 11.0+ ARM64

dipoleq-0.11.2-cp314-cp314-macosx_10_15_x86_64.whl (376.9 kB view details)

Uploaded Sep 1, 2026 CPython 3.14macOS 10.15+ x86-64

dipoleq-0.11.2-cp313-cp313-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (413.9 kB view details)

Uploaded Sep 1, 2026 CPython 3.13manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

dipoleq-0.11.2-cp313-cp313-macosx_11_0_arm64.whl (329.5 kB view details)

Uploaded Sep 1, 2026 CPython 3.13macOS 11.0+ ARM64

dipoleq-0.11.2-cp313-cp313-macosx_10_15_x86_64.whl (376.8 kB view details)

Uploaded Sep 1, 2026 CPython 3.13macOS 10.15+ x86-64

dipoleq-0.11.2-cp312-cp312-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (414.1 kB view details)

Uploaded Sep 1, 2026 CPython 3.12manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

dipoleq-0.11.2-cp312-cp312-macosx_11_0_arm64.whl (329.4 kB view details)

Uploaded Sep 1, 2026 CPython 3.12macOS 11.0+ ARM64

dipoleq-0.11.2-cp312-cp312-macosx_10_15_x86_64.whl (376.9 kB view details)

Uploaded Sep 1, 2026 CPython 3.12macOS 10.15+ x86-64

dipoleq-0.11.2-cp311-cp311-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (414.7 kB view details)

Uploaded Sep 1, 2026 CPython 3.11manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

dipoleq-0.11.2-cp311-cp311-macosx_11_0_arm64.whl (330.5 kB view details)

Uploaded Sep 1, 2026 CPython 3.11macOS 11.0+ ARM64

dipoleq-0.11.2-cp311-cp311-macosx_10_15_x86_64.whl (376.3 kB view details)

Uploaded Sep 1, 2026 CPython 3.11macOS 10.15+ x86-64

dipoleq-0.11.2-cp310-cp310-manylinux_2_27_x86_64.manylinux_2_28_x86_64.whl (414.4 kB view details)

Uploaded Sep 1, 2026 CPython 3.10manylinux: glibc 2.27+ x86-64manylinux: glibc 2.28+ x86-64

dipoleq-0.11.2-cp310-cp310-macosx_11_0_arm64.whl (329.7 kB view details)

Uploaded Sep 1, 2026 CPython 3.10macOS 11.0+ ARM64

dipoleq-0.11.2-cp310-cp310-macosx_10_15_x86_64.whl (375.2 kB view details)

Uploaded Sep 1, 2026 CPython 3.10macOS 10.15+ x86-64

File details

Details for the file dipoleq-0.11.2.tar.gz.

File metadata

Download URL: dipoleq-0.11.2.tar.gz
Upload date: Sep 1, 2026
Size: 3.3 MB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for dipoleq-0.11.2.tar.gz
Algorithm	Hash digest
SHA256	`c145e2ffebee4e41558b2142a265a56ab6c99cccbdba18e1447faf6202156963`
MD5	`ea34cd2f48d3ee5f11604fd6d5377fae`
BLAKE2b-256	`d4a6d9a18f2f1007028e9b73561b991cbc3ba61b48bbb4d42884a99968c2e643`

Algorithm	Hash digest
SHA256	`8dd8b558a117267f93abb0ed23191d80ab49b5cd1cf17740da471cd9c820ff2e`
MD5	`e263125bfc6955add32c16203b635541`
BLAKE2b-256	`50dabe16c35632200b474f2f3e2f69031b16d2cea06334a470e6fab3ea022049`

Algorithm	Hash digest
SHA256	`97b91c00bdeffe34c2373449183d178de4f1226ada9d119c6e37eaa991818a7c`
MD5	`2b08af546aa50cbebb0763b6df521b9d`
BLAKE2b-256	`d2ed4fa507a24b56a31d2293b655dfb80e58055e8d406f2ad9bcfb92f74efcc2`

Algorithm	Hash digest
SHA256	`d0e0b7a555bc95a0c6ee50b8c44ae2730c827f3b73e08ddee1c039a853b3e96d`
MD5	`2d40ada4278f73c3b55510e310bc6576`
BLAKE2b-256	`6b28dca2a7bb8ff4afbae767f83137a772eb814a7c4907bd15b466c755b50d89`

Algorithm	Hash digest
SHA256	`80fadbb1451534449c69a4eb1128491ad8780eb2ee6e8261c7303ccd84064390`
MD5	`fabb44a45deeaf06ab46752047501da2`
BLAKE2b-256	`ea103f9a1770fa3ecea1a6bcbfed93a27f4ed45cfab27e09f277e60f25b951b9`

Algorithm	Hash digest
SHA256	`5be635134c3d81cd0409f51c49b04e14aa2559f1dcaf20fb163f59515be8059e`
MD5	`0e888a642656113bb340bf1cb7b61d19`
BLAKE2b-256	`f0f50f7a42f5dbec042fd25904d3d359c7951a9d7ba7112ed422c778a8b1ddc8`

Algorithm	Hash digest
SHA256	`ef92c9bab90b5e3b6bf7946acc98db4a645a38f07e98bc73607cfc133f02ed6d`
MD5	`7038244c5dd8c1f2cf7a98218507bf2a`
BLAKE2b-256	`712865789b7ae01a1c7673bcd57b38648ae0ad9306710c8d7ca5bc5f0e60063c`

Algorithm	Hash digest
SHA256	`2005b88950f715933c9cb43a68475a0f662c83bebc59cac75e3ee41d70655fec`
MD5	`004010097bb525e02889cdf06b58c657`
BLAKE2b-256	`c126b332c6924e1fd039ba4ff6aec0fac48503245f7f76d6f9e1d06c3653e45e`

Algorithm	Hash digest
SHA256	`248937eef3b22c7838d56e478fbc55660b274748971f67d47575d60c582331bc`
MD5	`059b1f353a89a72c64d5359ab7ae3ab7`
BLAKE2b-256	`e03c7097a3f01069670a7d457c748551a40087319325c274c475b218e7dfd93e`

Algorithm	Hash digest
SHA256	`472be1fe990489bc2e74598a244a60cda3be1d82a9e0c3e14afa4c6d2f8e4326`
MD5	`8720837423f0dfe36640a7fb9e9862b2`
BLAKE2b-256	`8c2a078ed0d58b81eeadec67c6c6b5a10e61a4f02d3317923e21aa1b3ef5f7cc`

Algorithm	Hash digest
SHA256	`326be8fa9ea218ca6aac9082893088b515a07b3d01afea64e46d3027005e5d60`
MD5	`adf1af92fc29134c187d4eb41db63324`
BLAKE2b-256	`76d579b8966a9d7d7cd7d91ec64d1fddee3ce4e3d366f5595fb6835550cd30c6`

Algorithm	Hash digest
SHA256	`e355d125d1e1613fc149dc1adc9f06a29c52117738c271379fa56f59c00a5c3f`
MD5	`3a046d381603f90895961179431424b0`
BLAKE2b-256	`792b5f7e7e99e4da48ccfb438be046d65bd39e82e6a3b26174ce8220df31cef5`

Algorithm	Hash digest
SHA256	`de0a252264dcb7a9283936a3c35db6232c8d71c9145c41b2e0c74cf8bd2cdad6`
MD5	`df9a8d52e4c3d1c41aced9e8a3535eff`
BLAKE2b-256	`b41f200cdbf9863492fbd857cf74cd31e5cbdea10ef60a06b08f9cd4ff8ba97c`

Algorithm	Hash digest
SHA256	`c107d1715e1b306f95badd39487e79d0df20da631b9817abadf9ae43fb20aeb6`
MD5	`b73fadfb66dd7d626c0e60d16f923103`
BLAKE2b-256	`cebdcca8a36ac6a5f8ccd5e519bfad6d1029b34f54dd48ea95f67ccf04ac5a8a`

Algorithm	Hash digest
SHA256	`c30de4042ec5962c217a954dc859c3ccf7048e6ce8782dc1e4b1ba2f3b6a96fc`
MD5	`78b1968cb208ddc131a3e79c391c5000`
BLAKE2b-256	`55ca4ac06aa2ee953d74a5e9a854cb4da4bc8e3388c2fd0295da96b0febb17de`

Algorithm	Hash digest
SHA256	`c14f380837a5f4c78c65572d1318b3937561cbef7000aa8d68cb49d81120192f`
MD5	`8323c5c145cf77dd3a8dc06db05c747b`
BLAKE2b-256	`0769d5d8a359e72d3c62e940a4fe9a900cff87220c77746c2a0a2e3b029966de`

dipoleq 0.11.2

DipolEq

C Code - Command Line Version

Compilation

Dependencies

Ubuntu

macOS

Build and Install

Usage

Python Module Interface

Complilation

Usage

Key dates

1 maintainer

Credits

License

Requires

Provides Extra

Classifiers

Download files

Source Distribution

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata