1.11

What's Changed

• More %matplotlib widget in comments by @ax3l in #414
• Improve documentation for lpa_diag by @RemiLehe in #421
• Update CI to conda-incubator/setup-miniconda@v3 by @RemiLehe in #424
• Add script to automate release to PyPI by @RemiLehe in #413
• fix a bunch of typos (found by codespell) by @fchapoton in #423
• Remove obsolete python setup.py test command by @RemiLehe in #428
• Allow numpy2 by @dpgrote in #429
• Fix h5py reader for Fortran order by @RemiLehe in #430
• Fix figure display, when using %matplotlib widget by @RemiLehe in #432

New Contributors

• @fchapoton made their first contribution in #423
• @dpgrote made their first contribution in #429

Full Changelog: 1.10.0...1.11

1.10.0

What's Changed

• use %matplotlib widget by default by @BenWibking in #407
• BP4 Empty Skip: Inline Comment by @ax3l in #403
• Close #402 Fix deprecated ipython command by @RemiLehe in #410

New Contributors

• @BenWibking made their first contribution in #407

Full Changelog: 1.9.0...1.10.0

1.9.0

What's Changed

• When passing t, choose the closest iteration by @RemiLehe in #347
• README: Remove Travis-CI Badges by @ax3l in #369
• Adding attributes to the FieldMetaInformation object by @juliettepech in #372
• Sphinx documentation by @RemiLehe in #303
• Add readthedoc configuration by @RemiLehe in #375
• setup.py: no upper version of openPMD-api by @ax3l in #378
• Docs: correct 'get_mean_gamma' description in tutorials by @IlianCS in #379
• Do not use pyflakes for version 3.7 by @RemiLehe in #385
• Impose that user always passes iteration or t by @RemiLehe in #383
• Docs: Improve tutorials by adding basic analysis functions by @IlianCS in #382
• Improve get_laser_waist by @soerenjalas in #359
• Python 3.8+ by @ax3l in #387
• Update version number and CHANGELOG.md by @RemiLehe in #386
• Add all record attributes to FieldMetaInformation by @AngelFP in #390
• Support complex data in thetaMode geometry by @AngelFP in #389
• fix get_data for weighting in momentum reader by @PrometheusPi in #393
• Simplify names of radial particle components by @AngelFP in #392
• Close #396 warning when reading particle data by @RemiLehe in #398
• Support reading of 'rt' lasy files by @RemiLehe in #371

New Contributors

• @juliettepech made their first contribution in #372
• @IlianCS made their first contribution in #379

Full Changelog: 1.7.0...1.9.0

1.7.0

This release includes a few improvements:

• The function get_laser_waist is more robust: it does not automatically assume that the z axis is the last axis of the data. In addition, the user can now specify the laser propagation direction. (The default is z.) (See #345)

• The handling of unitSI is now more robust. (See #363)

1.6.0

This release adds a few features:

• openPMD-viewer can now read complex datasets (See #353)

• Avoid errors in LPA diagnostics in the absence of selected particles (See #358)

1.5.0

This release fixes a few miscellaneous bugs:

• Better 3D reconstruction for theta=None (See #344)

• Better support for ADIOS data (See #355)

• Support for group-based encoding (See #346)

1.4.0

This new release introduces several improvements:

• The changes introduced in 1.3.0 caused a major slowdown when reading certain types of data. This has been fixed in this new release. (See #340 for more details.)

• openPMD-viewer now supports thetaMode geometry with data written using r as the fastest index (as written by e.g. WarpX in addition to the previously supported data format which used z as the fastest index (as written by e.g. fbpic). (See 337)

• openPMD-viewer will raise an exception if the user asks for an iteration that is not part of the dataset (instead of printing a message and reverting to the first iteration, which can be confusing) (See 336)

1.3.0

This new release introduces preliminary support for mesh-refinement datasets
(see #332).

1.2.0

This new release introduces several bug-fixes and miscellaneous features:

• There is a new function get_energy_spread that returns the energy spread of the beam. This is partially redundant with get_mean_gamma, which is kept for backward compatibility. (see #304 and #317)

• The 3D field reconstruction from ThetaMode data now has an option max_resolution_3d that limits the resolution of the final 3D array. This is added in order to limit the memory footprint of this array. (see #307) The 3D reconstruction is now also more accurate, thanks to the implementation of linear interpolation. (see #311)

• A bug that affected reading ThetaMode data with the openpmd-api backend has been fixed. (see #313)

• A bug that affected get_laser_waist has been fixed. (see #320)

openPMD-api backend

This new release introduces the option to read openPMD files with different backends. In addition to the legacy h5py backend (which can read only HDF5 openPMD file), openPMD-viewer now has the option to use the openpmd-api backend (which can read both HDF5 and ADIOS openPMD files). Because the openpmd-api backend is thus more general, it is selected by default if available (i.e. if installed locally).
The user can override the default choice, by passing the backend argument when creating an OpenPMDTimeSeries object, and check which backend has been chosen by inspecting the .backend attribute of this object.

In addition, several smaller changes were introduced in this PR:

• The method get_laser_envelope can now take the argument laser_propagation in order to support lasers that do not propagates along the z axis.
• openPMD-viewer can now properly read groupBased openPMD files (i.e. files that contain several iterations) #301.
• Users can now pass arrays of ID to the ParticleTracker #283