BLAST-ImpactX · ax3l · Mar 18, 2025 · Mar 21, 2025
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
@@ -45,6 +45,7 @@ jobs:
         python3 -m pip install --upgrade -r tests/python/requirements.txt
         python3 -m pip install --upgrade pipx
         python3 -m pipx install openPMD-validator
+        python3 -c "import openpmd_api as io; print(io.__version__)"
     - name: CCache Cache
       uses: actions/cache@v4
       # - once stored under a key, they become immutable (even if local cache path content changes)

diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
@@ -87,6 +87,7 @@ jobs:
         python3 -m pip install -U -r examples/requirements.txt
         python3 -m pip install -U -r tests/python/requirements.txt
         python3 -m pip install -U openPMD-validator
+        python3 -c "import openpmd_api as io; print(io.__version__)"
     - name: Build
       env:
         # Work-around for windows-latest GH runner issue, see
@@ -209,6 +210,7 @@ jobs:
         python3 -m pip install -U -r examples/requirements.txt
         python3 -m pip install -U -r tests/python/requirements.txt
         python3 -m pip install -U openPMD-validator
+        python3 -c "import openpmd_api as io; print(io.__version__)"
     - name: Build
       shell: cmd
       env:

diff --git a/docs/source/dataanalysis/dataanalysis.rst b/docs/source/dataanalysis/dataanalysis.rst
@@ -52,7 +52,7 @@ Example to print the integrated orbit path length ``s`` at each beam monitor pos
 
    import openpmd_api as io
 
-   series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+   series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 
    for k_i, i in series.iterations.items():
        beam = i.particles["beam"]

diff --git a/examples/achromatic_spectrometer/analysis_spectrometer.py b/examples/achromatic_spectrometer/analysis_spectrometer.py
@@ -35,7 +35,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/achromatic_spectrometer/input_spectrometer.in b/examples/achromatic_spectrometer/input_spectrometer.in
@@ -25,7 +25,6 @@ lattice.elements = monitor bend1 plasma_lens drift1 monitor
 lattice.nslice = 25
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 bend1.type = sbend_exact
 bend1.ds = 1.0

diff --git a/examples/achromatic_spectrometer/run_spectrometer.py b/examples/achromatic_spectrometer/run_spectrometer.py
@@ -43,7 +43,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 ns = 25  # number of slices per ds in the element

diff --git a/examples/alignment/analysis_alignment.py b/examples/alignment/analysis_alignment.py
@@ -37,7 +37,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/alignment/input_alignment.in b/examples/alignment/input_alignment.in
@@ -25,7 +25,6 @@ lattice.elements = monitor quad_err monitor
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 quad_err.type = quad
 quad_err.ds = 1.0

diff --git a/examples/alignment/run_alignment.py b/examples/alignment/run_alignment.py
@@ -43,7 +43,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice)
 ns = 1  # number of slices per ds in the element

diff --git a/examples/aperture/analysis_absorber.py b/examples/aperture/analysis_absorber.py
@@ -34,12 +34,12 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()
 
-series_lost = io.Series("diags/openPMD/particles_lost.h5", io.Access.read_only)
+series_lost = io.Series("diags/openPMD/particles_lost.%E", io.Access.read_only)
 particles_lost = series_lost.iterations[0].particles["beam"].to_df()
 
 # compare number of particles

diff --git a/examples/aperture/analysis_aperture.py b/examples/aperture/analysis_aperture.py
@@ -34,12 +34,12 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()
 
-series_lost = io.Series("diags/openPMD/particles_lost.h5", io.Access.read_only)
+series_lost = io.Series("diags/openPMD/particles_lost.%E", io.Access.read_only)
 particles_lost = series_lost.iterations[0].particles["beam"].to_df()
 
 # compare number of particles

diff --git a/examples/aperture/analysis_aperture_periodic.py b/examples/aperture/analysis_aperture_periodic.py
@@ -34,12 +34,12 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()
 
-series_lost = io.Series("diags/openPMD/particles_lost.h5", io.Access.read_only)
+series_lost = io.Series("diags/openPMD/particles_lost.%E", io.Access.read_only)
 particles_lost = series_lost.iterations[0].particles["beam"].to_df()
 
 # compare number of particles

diff --git a/examples/aperture/analysis_aperture_thick.py b/examples/aperture/analysis_aperture_thick.py
@@ -34,12 +34,12 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()
 
-series_lost = io.Series("diags/openPMD/particles_lost.h5", io.Access.read_only)
+series_lost = io.Series("diags/openPMD/particles_lost.%E", io.Access.read_only)
 particles_lost = series_lost.iterations[0].particles["beam"].to_df()
 
 # compare number of particles

diff --git a/examples/aperture/input_absorber.in b/examples/aperture/input_absorber.in
@@ -25,7 +25,6 @@ lattice.elements = monitor drift collimator monitor
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 drift.type = drift
 drift.ds = 0.123

diff --git a/examples/aperture/input_aperture.in b/examples/aperture/input_aperture.in
@@ -25,7 +25,6 @@ lattice.elements = monitor drift collimator monitor
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 drift.type = drift
 drift.ds = 0.123

diff --git a/examples/aperture/input_aperture_periodic.in b/examples/aperture/input_aperture_periodic.in
@@ -25,7 +25,6 @@ lattice.elements = monitor drift pepperpot monitor
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 drift.type = drift
 drift.ds = 0.123

diff --git a/examples/aperture/input_aperture_thick.in b/examples/aperture/input_aperture_thick.in
@@ -25,7 +25,6 @@ lattice.elements = monitor drift monitor
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 drift.type = drift
 drift.ds = 0.123

diff --git a/examples/aperture/run_absorber.py b/examples/aperture/run_absorber.py
@@ -15,7 +15,6 @@
 sim.space_charge = False
 # sim.diagnostics = False  # benchmarking
 sim.slice_step_diagnostics = True
-sim.particle_lost_diagnostics_backend = "h5"
 
 # domain decomposition & space charge mesh
 sim.init_grids()
@@ -43,7 +42,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 sim.lattice.extend(

diff --git a/examples/aperture/run_aperture.py b/examples/aperture/run_aperture.py
@@ -15,7 +15,6 @@
 sim.space_charge = False
 # sim.diagnostics = False  # benchmarking
 sim.slice_step_diagnostics = True
-sim.particle_lost_diagnostics_backend = "h5"
 
 # domain decomposition & space charge mesh
 sim.init_grids()
@@ -43,7 +42,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 sim.lattice.extend(

diff --git a/examples/aperture/run_aperture_periodic.py b/examples/aperture/run_aperture_periodic.py
@@ -15,7 +15,6 @@
 sim.space_charge = False
 # sim.diagnostics = False  # benchmarking
 sim.slice_step_diagnostics = True
-sim.particle_lost_diagnostics_backend = "h5"
 
 # domain decomposition & space charge mesh
 sim.init_grids()
@@ -43,7 +42,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 sim.lattice.extend(

diff --git a/examples/aperture/run_aperture_thick.py b/examples/aperture/run_aperture_thick.py
@@ -15,7 +15,6 @@
 sim.space_charge = False
 # sim.diagnostics = False  # benchmarking
 sim.slice_step_diagnostics = True
-sim.particle_lost_diagnostics_backend = "h5"
 
 # domain decomposition & space charge mesh
 sim.init_grids()
@@ -43,7 +42,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 sim.lattice.extend(

diff --git a/examples/apochromatic/analysis_apochromatic.py b/examples/apochromatic/analysis_apochromatic.py
@@ -35,7 +35,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/apochromatic/analysis_apochromatic_pl.py b/examples/apochromatic/analysis_apochromatic_pl.py
@@ -34,7 +34,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/apochromatic/input_apochromatic.in b/examples/apochromatic/input_apochromatic.in
@@ -24,7 +24,6 @@ lattice.elements = monitor dr1 q1 q2 q3 dr2 q4 q5 dr2 q6 q7 q8 dr1 monitor
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 dr1.type = drift_chromatic
 dr1.ds = 1.0

diff --git a/examples/apochromatic/input_apochromatic_pl.in b/examples/apochromatic/input_apochromatic_pl.in
@@ -25,7 +25,6 @@ lattice.elements = monitor dr1 q1 dr2 q2 dr2 q3 dr2 q4 dr2 q5 dr2 q6 dr2 q7 dr1
 lattice.nslice = 1
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 dr1.type = drift_chromatic
 dr1.ds = 1.0

diff --git a/examples/apochromatic/run_apochromatic.py b/examples/apochromatic/run_apochromatic.py
@@ -44,7 +44,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice)
 ns = 25  # number of slices per ds in the element

diff --git a/examples/apochromatic/run_apochromatic_pl.py b/examples/apochromatic/run_apochromatic_pl.py
@@ -44,7 +44,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice)
 ns = 25  # number of slices per ds in the element

diff --git a/examples/cfbend/analysis_cfbend.py b/examples/cfbend/analysis_cfbend.py
@@ -35,7 +35,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/cfbend/input_cfbend.in b/examples/cfbend/input_cfbend.in
@@ -31,7 +31,6 @@ cfbend1.rc = 7.613657587094493   # bending radius [m]
 cfbend1.k = -7.057403   # (upright) quadrupole component [m^(-2)]
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 
 ###############################################################################

diff --git a/examples/cfbend/run_cfbend.py b/examples/cfbend/run_cfbend.py
@@ -44,7 +44,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 ns = 25  # number of slices per ds in the element

diff --git a/examples/cfchannel/analysis_cfchannel.py b/examples/cfchannel/analysis_cfchannel.py
@@ -35,7 +35,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/cfchannel/analysis_cfchannel_10nC.py b/examples/cfchannel/analysis_cfchannel_10nC.py
@@ -34,7 +34,7 @@ def get_moments(beam):
 
 
 # initial/final beam
-series = io.Series("diags/openPMD/monitor.h5", io.Access.read_only)
+series = io.Series("diags/openPMD/monitor.%E", io.Access.read_only)
 last_step = list(series.iterations)[-1]
 initial = series.iterations[1].particles["beam"].to_df()
 final = series.iterations[last_step].particles["beam"].to_df()

diff --git a/examples/cfchannel/input_cfchannel.in b/examples/cfchannel/input_cfchannel.in
@@ -24,7 +24,6 @@ beam.mutpt = 0.0
 lattice.elements = monitor constf1 monitor
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 constf1.type = constf
 constf1.ds = 2.0

diff --git a/examples/cfchannel/input_cfchannel_10nC_fft.in b/examples/cfchannel/input_cfchannel_10nC_fft.in
@@ -24,7 +24,6 @@ lattice.nslice = 50
 #lattice.nslice = 60 # optional for increased precision
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 constf1.type = constf
 constf1.ds = 2.0

diff --git a/examples/cfchannel/input_cfchannel_10nC_mlmg.in b/examples/cfchannel/input_cfchannel_10nC_mlmg.in
@@ -24,7 +24,6 @@ lattice.nslice = 50
 #lattice.nslice = 60 # optional for increased precision
 
 monitor.type = beam_monitor
-monitor.backend = h5
 
 constf1.type = constf
 constf1.ds = 2.0

diff --git a/examples/cfchannel/run_cfchannel.py b/examples/cfchannel/run_cfchannel.py
@@ -41,7 +41,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 sim.lattice.extend(

diff --git a/examples/cfchannel/run_cfchannel_10nC_fft.py b/examples/cfchannel/run_cfchannel_10nC_fft.py
@@ -44,7 +44,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 nslice = 50  # use 1e5 for increased precision

diff --git a/examples/cfchannel/run_cfchannel_10nC_mlmg.py b/examples/cfchannel/run_cfchannel_10nC_mlmg.py
@@ -43,7 +43,7 @@
 sim.add_particles(bunch_charge_C, distr, npart)
 
 # add beam diagnostics
-monitor = elements.BeamMonitor("monitor", backend="h5")
+monitor = elements.BeamMonitor("monitor")
 
 # design the accelerator lattice
 nslice = 50  # use 1e5 for increased precision