mpiemses3d-tools 4.17.0

CLI utilities for MPIEMSES3D plasma simulations

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

Python API

from mpiemses3d_tools.plasma_toml import PlasmaToml
from mpiemses3d_tools.unit_system import UnitSystem
from mpiemses3d_tools.inp2toml import inp2toml