PICMI
The Particle-In-Cell Modeling Interface (PICMI) standard establishes conventions for the naming and structuring of input files for Particle-In-Cell simulations.
The goal of the standard is to propose a set (or dictionary) of names and definitions that can be used in simulations, with as little changes as possible between codes.
Just as two persons do generally not use the exact same set of words from a dictionary (whatever the language), each code will use syntax (associated with unique functionalities of the code) that others will not. However, it is expected that, just like two persons will use and understand the same words and syntax for the most common topics, codes will share the same language for common definitions and tasks.
For example, it is expected that most PIC codes can share the same syntax to define a grid, a commonly-used field solver, a set of particles, etc. On the other hand, only a subset of the codes will offer, e.g. mesh refinement, field ionization, or code steering by the user. In this case, it is up to the implementation with each code to decide whether to ignore, raise a warning or an error, when an undefined statement is encountered. For more flexibility and robustness, conditional statements are available to the user to execute or read lines of the input script, based on the targeted code.
The intent is for the standard to be agnostic of the language of implementation, which can then potentially be performed using JSON, Python, FORTRAN or other means.
Warning: The standard is still evolving at this point. The most basic components of the standard have been defined and are being refined. New components are being added.
Contents of this repository
This repository contains:
-
A set of example scripts that use the PICMI standard (in the directory
Examples) -
A Python package that contains the base classes for the implementation of the PICMI standard (in the directory
PICMI_Python). It is best to install the package from PyPI:pip install picmistandardOptionally, it can be installed from the source (run from the main directory where the pyproject.toml file is).
python -m pip install .(The code will be automatically uploaded to PyPI upon creation of a new release on Github.)
-
The sources to generate the Sphinx documentation for the PICMI standard (in the directory
Docs). In order to generate the Sphinx documentation, first install Sphinx, as well as the version of the PICMI standard that you would like to document (e.g. viapython setup.py). Then type:cd Docs make htmlYou can then view the documentation by opening the file
Docs/build/html/index.htmlwith a standard web browser.
Release files for picmistandard 0.35.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| picmistandard-0.35.0.tar.gz | 31.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| picmistandard-0.35.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 65.8 kB
Release files / picmistandard-0.35.0.tar.gz
| Download URL | picmistandard-0.35.0.tar.gz |
|---|---|
| Size | 31.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2227d65de53f278d83407cd347907b91218ecb19df6c9d83fc38855f27ed652f
|
|
BLAKE2b-256 checksum How to use checksums |
9dfc22312db5a32a99d11e01e66c987e762d89f53451d20c13c1c66ac6dd3a8e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 6, 2026.
Transparency logRelease files / picmistandard-0.35.0-py3-none-any.whl
| Download URL | picmistandard-0.35.0-py3-none-any.whl |
|---|---|
| Size | 34.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
97c8649d4114925bb3422a069fa8c689addb12dc6d6aba978ce3ce919152d666
|
|
BLAKE2b-256 checksum How to use checksums |
4c50d8809b6971bb0b921cb5e5dba0022a1d10241a603c2753a0ff8bd1aba41a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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 6, 2026.
Transparency log
