ParticlePhaseSpace

Spec sheet

Purpose

ParticlePhaseSpace is a Python library for importing, analysing, and manipulating particle phase-space data.Read 12 Oct 2026 · bwheelz36.github.io

Intended users

The repository describes the library as a common tool for working with particle phase spaces, and its topics include accelerator physics, TOPAS, and Twiss.Read 12 Oct 2026 · github.com

Free plan

YesRead 23 Sep 2026 · bwheelz36.github.io

Support

The repository asks users to report problems or request support through its Issues tab.Read 12 Oct 2026 · github.com

License

The public GitHub repository identifies the project as GPL-3.0 licensed.Read 12 Oct 2026 · github.com

Analysis

The examples show energy statistics and calculations of RMS Twiss parameters.Read 12 Oct 2026 · bwheelz36.github.io

Combination limitation

The example notes that identical particles cannot be added to an existing phase space unless particle IDs are updated first.Read 12 Oct 2026 · bwheelz36.github.io

Data exporters

Documented exporters write CSV and TOPAS ASCII or binary formats.Read 12 Oct 2026 · bwheelz36.github.io

Data loaders

Documented loaders include IAEA, pandas, Tibaray, TOPAS, and p2sat text data.Read 12 Oct 2026 · bwheelz36.github.io

Data transformations

The documentation covers translations, rotations, projections, and regridding of phase-space data.Read 12 Oct 2026 · bwheelz36.github.io

Delivery mode

webRead 23 Sep 2026 · bwheelz36.github.io

Experimental feature

The documentation describes Gaussian KDE resampling as fairly experimental and advises using it with extreme caution.Read 12 Oct 2026 · bwheelz36.github.io

Extensibility

Users can write custom DataLoaders and DataExporters for data formats the library does not already support.Read 12 Oct 2026 · github.com

IAEA limitation

The IAEA loader may require fine tuning and is unlikely to work out of the box with arbitrary IAEA phase-space files.Read 12 Oct 2026 · bwheelz36.github.io

IAEA loader requirement

The IAEA loader requires users to provide a data schema because the format does not allow the loader to infer it generally.Read 12 Oct 2026 · bwheelz36.github.io

Installation

The documentation says to install it with `pip install ParticlePhaseSpace`.Read 12 Oct 2026 · bwheelz36.github.io

Plots

Documented plots include energy and momentum histograms, particle-position plots, trace-space plots, and fluence maps.Read 12 Oct 2026 · bwheelz36.github.io

Python requirement

PyPI lists Python versions 3.9 and later, below 4.0, as the package requirement.Read 12 Oct 2026 · pypi.org

Supported particles

The documented supported particles are electrons, positrons, gammas, protons, neutrons, and optical photons.Read 12 Oct 2026 · bwheelz36.github.io

TOPAS export limit

The TOPAS exporter does not handle time features and flags every particle as a new history.Read 12 Oct 2026 · bwheelz36.github.io

TOPAS import limit

The TOPAS loader does not handle time or particle-ID fields, which may or may not be present in TOPAS data.Read 12 Oct 2026 · bwheelz36.github.io

Transformations

The transformation documentation lists projection, regridding, rotation, and translation operations.Read 12 Oct 2026 · bwheelz36.github.io

Units

The library supports multiple unit sets and allows users to define new unit sets.Read 12 Oct 2026 · bwheelz36.github.io

Visualization

Documented plots include energy, position, momentum, transverse trace space, particle counts over time, and fluence maps.Read 12 Oct 2026 · bwheelz36.github.io

Workflow

The library describes its workflow as import, analyse, export.Read 12 Oct 2026 · github.com

Plans and prices

Every ParticlePhaseSpace plan and price →

Where Specifiction places it

• Physics Simulation Software#40 of 897.8