Freedom251 › Physics Simulation Software
ParticlePhaseSpace
What ParticlePhaseSpace is
ParticlePhaseSpace is a free Python library for importing, analysing, transforming, and exporting particle phase-space data. Its workflow covers import, analysis, and export, with loaders for IAEA, pandas, Tibaray, TOPAS, and p2sat text data. Exporters write CSV and TOPAS ASCII or binary formats. Analysis includes RMS Twiss parameters, energy statistics, time filtering, and particle-density assessment. Plots cover energy and momentum histograms, particle positions, transverse trace space, particle counts over time, and fluence maps. Transformation tools provide projection, regridding, rotation, and translation. The library supports multiple or user-defined unit sets and documents electrons, positrons, gammas, protons, neutrons, and optical photons. Custom loaders and exporters can extend format support. Installation uses pip, and Python 3.9 through below 4.0 is required. The project is GPL-3.0 licensed and delivered for Linux through its website. Format limitations affect TOPAS and IAEA workflows, while Gaussian KDE resampling is marked experimental.
Who it suits
ParticlePhaseSpace suits accelerator-physics and related users working with particle phase spaces, TOPAS, Twiss parameters, and custom data formats. It is intended for Python workflows requiring analysis, visualization, and transformations.
What it does well
- Free with no usage or volume limits stated
- Supports several phase-space data loaders
- Provides Twiss and energy analysis
- Includes plots and transformations
- Allows custom loaders and exporters
What to know first
- TOPAS import omits time and particle-ID fields
- IAEA files may require schema tuning
- Gaussian KDE resampling is experimental
- Requires Python 3.9 or later below 4.0
Plans
| Plan | Billed and limits | Price |
|---|---|---|
| ParticlePhaseSpace | No usage or volume limits stated | Free |
As bwheelz36.github.io lists them, read 12 Oct 2026. The maker's own page has the final word.
Verdict
ParticlePhaseSpace offers a broad, extensible workflow for particle phase-space data at no listed cost. Users should account for format-specific omissions, IAEA setup requirements, and the caution attached to KDE resampling.
Facts from ParticlePhaseSpace's own pages
- Analysis
- The library documents RMS Twiss parameter calculation, energy statistics, time filtering, and particle-density assessment. · bwheelz36.github.io, 12 Oct 2026
- Combination limitation
- The example notes that identical particles cannot be added to an existing phase space unless particle IDs are updated first. · bwheelz36.github.io, 12 Oct 2026
- Data exporters
- Documented exporters write CSV and TOPAS ASCII or binary formats. · bwheelz36.github.io, 12 Oct 2026
- Data loaders
- Documented loaders include IAEA, pandas, Tibaray, TOPAS, and p2sat text data. · bwheelz36.github.io, 12 Oct 2026
- Data transformations
- The documentation covers translations, rotations, projections, and regridding of phase-space data. · bwheelz36.github.io, 12 Oct 2026
- Delivery mode
- web · bwheelz36.github.io, 23 Sept 2026
- Experimental feature
- The documentation describes Gaussian KDE resampling as fairly experimental and advises using it with extreme caution. · bwheelz36.github.io, 12 Oct 2026
- Extensibility
- Users can write custom DataLoaders and DataExporters for data formats the library does not already support. · github.com, 12 Oct 2026
- Free plan
- Yes · bwheelz36.github.io, 23 Sept 2026
- IAEA limitation
- The IAEA loader may require fine tuning and is unlikely to work out of the box with arbitrary IAEA phase-space files. · bwheelz36.github.io, 12 Oct 2026
- 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. · bwheelz36.github.io, 12 Oct 2026
- Installation
- The documentation says to install it with `pip install ParticlePhaseSpace`. · bwheelz36.github.io, 12 Oct 2026
- 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. · github.com, 12 Oct 2026
- License
- The public GitHub repository identifies the project as GPL-3.0 licensed. · github.com, 12 Oct 2026
- Plots
- Documented plots include energy and momentum histograms, particle-position plots, trace-space plots, and fluence maps. · bwheelz36.github.io, 12 Oct 2026
- Purpose
- ParticlePhaseSpace is a Python library for importing, analysing, and manipulating particle phase-space data. · bwheelz36.github.io, 12 Oct 2026
- Python requirement
- PyPI lists Python versions 3.9 and later, below 4.0, as the package requirement. · pypi.org, 12 Oct 2026
- Support
- The repository asks users to report problems or request support through its Issues tab. · github.com, 12 Oct 2026
- Supported particles
- The documented supported particles are electrons, positrons, gammas, protons, neutrons, and optical photons. · bwheelz36.github.io, 12 Oct 2026
- TOPAS export limit
- The TOPAS exporter does not handle time features and flags every particle as a new history. · bwheelz36.github.io, 12 Oct 2026
- TOPAS import limit
- The TOPAS loader does not handle time or particle-ID fields, which may or may not be present in TOPAS data. · bwheelz36.github.io, 12 Oct 2026
- Transformations
- The transformation documentation lists projection, regridding, rotation, and translation operations. · bwheelz36.github.io, 12 Oct 2026
- Units
- The library supports multiple unit sets and allows users to define new unit sets. · bwheelz36.github.io, 12 Oct 2026
- Visualization
- Documented plots include energy, position, momentum, transverse trace space, particle counts over time, and fluence maps. · bwheelz36.github.io, 12 Oct 2026
Where ParticlePhaseSpace stands on Freedom251
- Physics Simulation Software#67 of 89