MCPL - Monte Carlo Particle Lists
MCPL files, with extensions .mcpl and .mcpl.gz is a binary format for usage
in physics particle simulations. It contains lists of particle state
information, and can be used to interchange or reuse particles between various
Monte Carlo simulation applications. The format itself is formally described in:
T. Kittelmann, et al., Monte Carlo Particle Lists: MCPL, Computer Physics Communications 218, 17-42 (2017), https://doi.org/10.1016/j.cpc.2017.04.012
All MCPL code is provided under the highly liberal open source Apache 2.0 license (http://www.apache.org/licenses/LICENSE-2.0), and further instructions and documentation can be found at https://mctools.github.io/mcpl/.
The mcpl-extra package
The mcpl-extra package is intended to provide tools and conversion utilities
related to MCPL files, beyond what is available in the mcpl-core package. This
currently includes converters to and from file formats related to PHITS and
MCNP(5/X/6).
For more details about how to use these converters, refer to the https://mctools.github.io/mcpl/hooks_mcnp and https://mctools.github.io/mcpl/hooks_phits pages.
Scientific reference
Copyright 2015-2026 MCPL developers.
This software was mainly developed at the European Spallation Source ERIC (ESS) and the Technical University of Denmark (DTU). This work was supported in part by the European Union's Horizon 2020 research and innovation programme under grant agreement No 676548 (the BrightnESS project).
All MCPL files are distributed under the Apache 2.0 license, available at http://www.apache.org/licenses/LICENSE-2.0, as well as in the LICENSE file found in the source distribution.
A substantial effort went into developing MCPL. If you use it for your work, we would appreciate it if you would use the following reference in your work:
T. Kittelmann, et al., Monte Carlo Particle Lists: MCPL, Computer Physics Communications 218, 17-42 (2017), https://doi.org/10.1016/j.cpc.2017.04.012
Support for specific third party applications
Note that some users might also wish to additionally install the mcpl-extra
package, which contains cmdline tools for converting between the binary data
files native to some third-party Monte Carlo applications (currently PHITS and
MCNP[X/5/6]). Users of Geant4 might wish to install the mcpl-geant4 package,
which provides C++ classes (and CMake configuration code) for integrating MCPL
I/O into Geant4 simulations. Finally, many Monte Carlo applications have
directly integrated support for MCPL I/O into their codes. At the time of
writing, the list of applications with known support from MCPL I/O includes:
- McStas (built in)
- McXtrace (built in)
- OpenMC (built in)
- Cinema/Prompt (built in)
- VITESS (built in)
- RESTRAX/SIMRES (built in)
- McVine (built in)
- MCNPX, MCNP5, MCNP6 (based on
ssw2mcpl/mcpl2sswfrom themcpl-extrapackage) - PHITS (based on
phits2mcpl/mcpl2phitsfrom themcpl-extrapackage) - Geant4 (based on C++/CMake code from the
mcpl-geant4package)
Note that instructions for installation and setup of third-party products like those listed above are beyond the scope of the MCPL project. Please refer to the products own instructions for more information.
1 maintainer
Metadata
1 maintainer
Release files for mcpl-extra 2.2.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcpl_extra-2.2.8.tar.gz | 38.5 kB | Details |
Built distributions (wheels)
Total release size: 601.3 kB
Release files / mcpl_extra-2.2.8.tar.gz
| Download URL | mcpl_extra-2.2.8.tar.gz |
|---|---|
| Size | 38.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6e219886b20f7cf063416897b935c35ac9fe868a5e5f67c6aaa73b0fee77667c
|
|
BLAKE2b-256 checksum How to use checksums |
7b2cda429721ba8f82bf430e1b877b9196ba208c882d907d1219d01c2d5434d1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-win_arm64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-win_arm64.whl |
|---|---|
| Size | 45.3 kB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
ef42fd437f26a3ee2d59dfffcbc0887edb5300c3932f8967a3586c2eac492b14
|
|
BLAKE2b-256 checksum How to use checksums |
82291643eb6465a57e6ecaff150a9939e00713c448d96b115bfbd4d17c769011
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-win_amd64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-win_amd64.whl |
|---|---|
| Size | 50.4 kB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
da4be1c03ef3fc32b5ecf3094b52337f04c2ca6aeb299ea4ebb44e1efbabb5de
|
|
BLAKE2b-256 checksum How to use checksums |
68d1bb20f3a9ead1cd0abc2db41cea2b3d462e8ef122be256664a32cc08e79da
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-musllinux_1_2_x86_64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-musllinux_1_2_x86_64.whl |
|---|---|
| Size | 58.1 kB |
| Tags | Linux musl 1.2+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
bf4afc1016f9250f64927d23d48161179261987c396e5bc80058a3b1f5a4b449
|
|
BLAKE2b-256 checksum How to use checksums |
c9aab4515369cbdf16acfe549f6bad4e47ec0314d08d99810662789e1e703da3
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-musllinux_1_2_aarch64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-musllinux_1_2_aarch64.whl |
|---|---|
| Size | 60.7 kB |
| Tags | Linux musl 1.2+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
f0316a64d5b6d6ebcd4baf342c0dd55f3482d1f0b3a64fc9db22a8832ae3e9b8
|
|
BLAKE2b-256 checksum How to use checksums |
06331885b36693e860e854208ca47a089f5698f20b4621240941c38ca7fecaa5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl |
|---|---|
| Size | 57.8 kB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
76975cf48f9bf0e393e8fc6aac407158a14620cb1142ce0ddeb7bb145dd7d12d
|
|
BLAKE2b-256 checksum How to use checksums |
f5ba08c9587b54f4b6d81737c686e40b38e850f30e1c568cbdd39be9aaccacca
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl |
|---|---|
| Size | 59.0 kB |
| Tags | Linux glibc 2.17+ x86-64 Linux glibc 2.28+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
594eaf912cdd62add4c0047c745d73d6af5e519cc0804f9b0c2f8a9081633bd7
|
|
BLAKE2b-256 checksum How to use checksums |
702fa06ffb5c705637e835fe7e82fbfc64df21af0a31015b522e09428c82ee16
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl |
|---|---|
| Size | 57.6 kB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
86edaf5799e38c19a36fc5b8e903fa1e055ae19d42dafa5b2ea0df65c9f18464
|
|
BLAKE2b-256 checksum How to use checksums |
0b2a245a4f65ced6e009a3eb335bbc6d08b297c4554befc66dc8c2f0df754f97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl |
|---|---|
| Size | 62.6 kB |
| Tags | Linux glibc 2.17+ ARM64 Linux glibc 2.28+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
f65388637eef60c7fb305ec280d4693c6d658c1ab950d97d71dc830d94a201ce
|
|
BLAKE2b-256 checksum How to use checksums |
f85e0a1e60f3a5fae5374d95d9485b6e13c716e04973a16276baeb7bcb9438df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-macosx_11_0_arm64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 56.2 kB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
7881d515b1aa848d58eb310ab2d89b0574abd7cfe2e5106710817723fea9e36a
|
|
BLAKE2b-256 checksum How to use checksums |
80ddb9c37b992dd15246ba87803efb994f4611823e28ce0475c665c7fa53c7df
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency logRelease files / mcpl_extra-2.2.8-py3-none-macosx_10_9_x86_64.whl
| Download URL | mcpl_extra-2.2.8-py3-none-macosx_10_9_x86_64.whl |
|---|---|
| Size | 55.1 kB |
| Tags | Python 3 macOS 10.9+ x86-64 |
|
SHA-256 checksum How to use checksums |
717445143d3ec457fba479a840e058816fea4e93badb2f11b0ee6cf47688e5f2
|
|
BLAKE2b-256 checksum How to use checksums |
128ca7b2c0b59f2f26621c1b743e1bcc3e48687210c6b6e2a2e1e7c04f725ed2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 18, 2026.
Transparency log
