mpiemses3d-tools
CLI utilities for MPIEMSES3D plasma simulations.
Installation
pip install mpiemses3d-tools
Commands
| Command | Description |
|---|---|
inp2toml |
Convert Fortran namelist (plasma.inp) to TOML format |
toml2inp |
Convert plasma.toml back to legacy Fortran namelist format |
emu / emses-unit |
Unit conversion, TOML/input linting, and parameter reference lookup |
toml-upgrade |
Upgrade plasma.toml from format v1 to v2 |
emses-cp / cpem |
Copy the mpiemses3D binary as mpiemses3D, auto-selecting mpiemses3D-<env> on KUDPC |
mpiemses3d-build |
Build and install an environment-specific mpiemses3D-<env> command |
mpiemses-codex-plugin |
Compatibility helper for Codex marketplace registration; use codex plugin marketplace add/upgrade in user docs |
mpiemses-claude-plugin |
Compatibility helper for Claude Code marketplace registration; use claude plugin marketplace add/update in user docs |
Parameter reference lookup examples:
emu lint plasma.toml
emu lint plasma.inp --format inp --mpi-size 64
emu describe esorem
emu describe emflag
emu describe species --language en
Agent Plugins
Codex Installation
Register the Codex marketplace directly with the Codex CLI:
codex plugin marketplace add CS12-Laboratory/MPIEMSES3D \
--ref main \
--sparse .agents/plugins \
--sparse plugins/mpiemses3d-context
codex
# Open /plugins, install "MPIEMSES3D Context", then restart Codex.
Codex Update
Update the registered marketplace with:
codex plugin marketplace upgrade mpiemses3d
Claude Code Installation
Register the Claude Code marketplace and install the plugin with:
claude plugin marketplace add CS12-Laboratory/MPIEMSES3D@main \
--scope user \
--sparse .claude-plugin plugins/mpiemses3d-context
claude plugin install mpiemses3d-context@mpiemses3d --scope user
# Run /reload-plugins inside Claude Code or restart Claude Code.
Claude Code Update
Update the registered marketplace with:
claude plugin marketplace update mpiemses3d
runops integration
This package registers the emses adapter for runops
2.x through the runops.adapters entry point (mpiemses3d_tools.runops_adapter:Adapter).
When mpiemses3d-tools is installed in a runops project's .venv, runo init emses and
runo update find the adapter and copy the MPIEMSES3D agent skills and references
(plugins/mpiemses3d-context, shipped in the wheel as mpiemses3d_tools/agent_context)
into the project's .agents/skills/ and .claude/skills/.
The job runs from the run directory and writes to work/latest. For ES continuation,
the adapter finds SNAPSHOT1 under work/latest (or work for older layouts) and
links it as SNAPSHOT0 in the new run directory. The native reader resolves this
input from the job's working directory; -o changes only the output destination.
Python API
from mpiemses3d_tools.plasma_toml import PlasmaToml
from mpiemses3d_tools.unit_system import UnitSystem
from mpiemses3d_tools.inp2toml import inp2toml
1 maintainer
Metadata
1 maintainer
Release files for mpiemses3d-tools 4.22.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mpiemses3d_tools-4.22.1-py3-none-any.whl | Python 3 | none | any | Details |
Release files / mpiemses3d_tools-4.22.1-py3-none-any.whl
| Download URL | mpiemses3d_tools-4.22.1-py3-none-any.whl |
|---|---|
| Size | 461.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
814930967ed41fd9c3a7e42fd711d5c711923b23f8ee73ae466b7c37ce9ac48a
|
|
BLAKE2b-256 checksum How to use checksums |
93d9095762c8414b6dfb3aa4a9259c45c3d079fa0145ab24da471e1c0f3a20a7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logSecurity for mpiemses3d-tools 4.22.1
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.
Full provenance
All 1 file in this release has been uploaded with provenance metadata.
Attestation for mpiemses3d_tools-4.22.1-py3-none-any.whl
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 23, 2026.
Transparency logA 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.
