openPMD example datasets

This repository contains examples of openPMD datasets, in three different geometries:

• 2D Cartesian
• 3D Cartesian
• Cylindrical with azimuthal decomposition ("thetaMode")

The structure.h5 is an openPMD 1.1.0 compliant file contains the bare bones structure with no associated data.

In order to obtain these datasets:

• Clone this repository

git clone https://github.com/openPMD/openPMD-example-datasets.git

• Uncrompress the files

cd openPMD-example-datasets
tar -zxvf example-2d.tar.gz
tar -zxvf example-3d.tar.gz
tar -zxvf example-thetaMode.tar.gz
...

How were these files created?

Files created with the Particle-In-Cell code Warp

The files example-2d.tar.gz, example-3d.tar.gz and example-thetaMode.tar.gz were produced with the Particle-In-Cell code Warp. The resolution is intentionally very low, so as to produce data of manageable size.

The scripts that were used in order to produce these openPMD files from Warp can be found in the directory scripts/warp.

Examples created with the Particle-In-Cell code Synergia

The files synergia-fodo.tar.gz were generated by running the fodo_cxx example from the accelerator modeling package synergia (version/commit 2024.04.17-5a794e3c3). Is is the result of running the example file with the following command line options: ./fodo_cxx macroparticles=4096 gridx=8 gridy=8 gridz=8 turns=25. These include the following:

• bunch_dump.h5 - Contains the bunch after propagation through the FODO lattice after 25 turns
• particles.h5 - Contains the position/momentum of the first 1000 particles stored at the end of each turn as obtained by diagnostics_particles
• tracks.h5 - Contains the tracks of the first 100 particles as obtained by diagnostics_bulk_track
• diag.h5 - Contains the properties of the beam at the end of each turn as obtained by diagnostics_full2.

Examples created with the finite-element code FEMM

The files example-femm-3d.h5 and example-femm-thetaMode.h5 were produced using the finite-element code FEMM.

The scripts that were used in order to produce these openPMD files can be found in the directory scripts/femm.

Examples created with the Particle-In-Cell code PIConGPU

The files legacy_datasets.tar.gz were produced with the Particle-In-Cell code PIConGPU.