openPMD · franzpoeschel · Dec 10, 2025 · Dec 10, 2025 · Dec 10, 2025 · Dec 10, 2025
diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
@@ -42,7 +42,7 @@ jobs:
 
         python3.exe -m pip wheel .
         if(!$?) { Exit $LASTEXITCODE }
-        python3.exe -m pip install openPMD_api-0.17.0.dev0-cp39-cp39-win_amd64.whl
+        python3.exe -m pip install openPMD_api-0.17.0-cp39-cp39-win_amd64.whl
         if(!$?) { Exit $LASTEXITCODE }
 
         python3.exe -c "import openpmd_api as api; print(api.variants)"

diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -3,16 +3,148 @@
 Changelog
 =========
 
-0.16.0
+0.17.0
 ------
+**Date:** TBD
 
-Changes to "0.15.0"
+
+Changes to "0.16.1"
+^^^^^^^^^^^^^^^^^^^
+
+Features
+""""""""
+
+- API:
+
+  - Unify Random-Access API and Streaming API into ``Series::snapshots()``, support reopening closed Iterations (#1592 #1810)
+  - Dataset-specific JSON/TOML configuration (#1646)
+  - Add a selection of chunk distribution algorithms for parallel data access (including RoundRobin, Blocks, BlocksOfSourceRanks, ByHostname, DiscardingStrategy) to the API and to ``openpmd-pipe`` (#824)
+- HDF5:
+
+  - HDF5 2.0.0 support (#1812)
+  - HDF5 filters (compression) with JSON/TOML configuration, C++ and Python examples for compression (#1644)
+  - Support for opening scalar datasets (#1764)
+- ADIOS2:
+
+  - ADIOS2 v2.11 support (#1804)
+  - Support reading variable encoding in random access mode (using step selection) (#1706 #1750)
+  - Support reading variable-encoded datasets with changing metadata (partial datasets, modifiable attributes) (#1746)
+  - Allow only up to 100 steps by default in BP5 group encoding (performance consideration) (#1732)
+- JSON/TOML IO backends:
+
+  - JSON/TOML: Abbreviated IO modes (#1493)
+- Performance:
+
+  - Performance optimizations for interacting with many meshes/species types (#1741)
+  - C++ API: optimized include times (#1774)
+  - Improve flushing performance for file-based Series with many steps (#1642)
+- Python:
+
+  - DataFrame: Add attribute columns (#1814)
+- Miscellaneous:
+
+  - Add JSON schema for openPMD file validation, introduce openpmd-convert-toml-json tool (#1426)
+  - Experimental support for openPMD standard 2.0 (#1551)
+  - Non-spatial meshes (in standard 2.0) (#1534)
+  - Optional shape in constant components (#1661)
+  - Stderr hints for lazy parsing when appropriate (#1802 #1816)
+  - storeChunk: use const-type pointers (#1778)
+  - Span API: use std::unique_ptr in default fallback (#1820)
+  - Pickle API: Cache unpickled Series to avoid repeated file access (#1654)
+  - Fix license headers (#1819)
+
+Bug Fixes
+"""""""""
+
+- ADIOS2:
+
+  - Deactivate Span API in BP5 up to ADIOS2 v2.10.2 (#1771)
+  - Fix propagation of joined dimension to the backend (#1740)
+  - Fix late unique_ptr puts without CLOSE_FILE or ADVANCE operations (#1744)
+  - Fix double write from unique_ptr (#1743)
+  - Fix hangup with writeIterations() (#1728)
+  - Always use CurrentStep() in mode::Read, fixing nonstandard SST workflows (#1749)
+.. - HDF5:
+
+
+- JSON/TOML IO backend:
+
+  - Remove unnecessary putJsonContents() calls (#1782)
+  - Fix uninitialized values (#1745)
+- Python:
+
+  - Fix reference counting (#1775)
+  - Type conversions for Series constructor (#1737)
+  - Support for zero-sized storeChunk in Span API Python (#1738)
+- General:
+
+  - Fix missing check for constant components (#1776)
+  - Fixes for deferred initialization (#1777)
+  - Remove leftover debugging messages (#1816)
+  - Fix Variant issue with certain CUDA versions (#1722 #1807)
+  - Fix behavior of Iteration::open() for correct use of Span API (#1794)
+  - iterator::operator== fix for C++20 (#1798)
+  - Fix a couple of false positive warnings (#1806 #1824)
+  - Safeguards for READ_LINEAR mode (#1753)
+
+Other
+"""""
+
+- CMake:
+
+  - Skip MPICXX dependency (#1785)
+- CI/Infrastructure:
+
+  - Upgrade to macOS-14 (#1808)
+  - Upgrade Musllinux runner to Ubuntu 24.04 (#1795)
+  - Upgrade Nvidia Nvhpc runner to 25.9 (#1811)
+  - Clang Tidy and Sanitizer: Use clang-19 on Ubuntu 24.04 (#1783)
+  - Update CodeQL action to v4 (#1790)
+  - Support for new CMake versions (#1742)
+  - Various pre-commit updates
+  - Move Ubuntu 20.04 workflows to 22.04 (#1731)
+- Documentation:
+
+  - Update streaming documentation to snapshots API (#1773)
+  - Doc: First Write with explicit float64 type (#1780)
+  - WarpX repo update (#1733)
+  - Link code examples to current version instead of dev (#1821)
+
+
+0.16.1
+------
+**Date:** 2025-01-15
+
+New Backends, Extension, Perf. & Memory
+
+This is the 0.16.0 release but with internal version bumps where they were missing.
+
+Changes to "0.16.0"
 ^^^^^^^^^^^^^^^^^^^
 
+Bug Fixes
+"""""""""
+
+- HDF5: Delete and re-create attribute when overwriting with diff. type #1697
+- TOUCH IOTask: Avoid setting files as dirty in non-write modes #1704
+- Fix CMake variables for controlling internal dependencies #1678
+- Bump toml11 dependency to ``v4.2.0`` by default #1679
+- Set ``PYBIND11_FINDPYTHON=ON`` #1684
+- Properly check for empty ``HDF5_VERSION`` in CMake #1702
+- Fix ICX build #1690
+- Explicitly specify ADIOS2 components in openPMDConfig.cmake #1693
+- Example 12: Use ``ULONG`` for particle patches #1710
+
 Other
 """""
 
-- ADIOS2: require version 2.9.0 #1711
+- Replace deprecated Python unittest API call #1681
+- Remove ``mpirun_workaround.sh`` #1698
+- CI: Upgrade appleclang14 build to MacOS 13 #1703
+- Docs:
+
+  - Fix Shipped Internally #1682
+  - Fix leftover ADIOS2 mentions #1683
 
 0.16.0
 ------

diff --git a/CITATION.cff b/CITATION.cff
@@ -37,7 +37,7 @@ contact:
   orcid: https://orcid.org/0000-0003-1943-7141
   email: [email protected]
 title: "openPMD-api: C++ & Python API for Scientific I/O with openPMD"
-version: 0.17.0-dev
+version: 0.17.0
 repository-code: https://github.com/openPMD/openPMD-api
 doi: 10.14278/rodare.27
 license: LGPL-3.0-or-later

diff --git a/NEWS.rst b/NEWS.rst
@@ -6,7 +6,19 @@ Upgrade Guide
 0.17.0
 ------
 
-ADIOS 2.9.0 is now the minimally supported version for ADIOS2 support.
+ADIOS 2.9.0 is now the minimally supported version for ADIOS2; support for ADIOS 2.11.0 has been added.
+HDF5 1.8.13 is now the minimally supported version for HDF5, support for HDF5 2.0 has been added.
+
+A new unified API for accessing Iterations/Snapshots has been introduced in ``series.snapshots()``.
+This replaces access via ``series.iterations``, ``series.writeIterations()`` and ``series.readIterations()`` which are now deprecated.
+``series.writeIterations()`` and ``series.readIterations()`` are now implemented internally in terms of ``series.snapshots()``, but remain backward-compatible to old useage.
+
+The behavior of ``series.snapshots()`` is determined by the selected ``Access`` type:
+
+* ``Access::CREATE_RANDOM_ACCESS`` and ``Access::READ_RANDOM_ACCESS`` behave the same way as ``series.iterations`` did so far.
+  ``Access::CREATE`` and ``Access::READ_ONLY`` are now aliases for these two access types.
+* ``Access::CREATE_LINEAR`` and ``Access::READ_LINEAR`` are used for creating/accessing Iterations one after another, e.g. in a Stream. These modes are more restricted in their API contract, but will work for streaming and file data alike, and ensure more resource-friendly IO patterns.
+  If the ADIOS2 backend uses steps, then old steps cannot be reopened after closing them.
 
 0.16.0
 ------

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -93,7 +93,7 @@
 # The short X.Y version.
 version = u'0.17.0'
 # The full version, including alpha/beta/rc tags.
-release = u'0.17.0-dev'
+release = u'0.17.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.

diff --git a/include/openPMD/version.hpp b/include/openPMD/version.hpp
@@ -30,7 +30,7 @@
 #define OPENPMDAPI_VERSION_MAJOR 0
 #define OPENPMDAPI_VERSION_MINOR 17
 #define OPENPMDAPI_VERSION_PATCH 0
-#define OPENPMDAPI_VERSION_LABEL "dev"
+#define OPENPMDAPI_VERSION_LABEL ""
 /** @} */
 
 /** maximum supported version of the openPMD standard (read & write,

diff --git a/setup.py b/setup.py
@@ -181,7 +181,7 @@ def build_extension(self, ext):
 setup(
     name='openPMD-api',
     # note PEP-440 syntax: x.y.zaN but x.y.z.devN
-    version='0.17.0.dev',
+    version='0.17.0',
     author='Axel Huebl, Franz Poeschel, Fabian Koller, Junmin Gu',
     author_email='[email protected], [email protected]',
     maintainer='Axel Huebl',

diff --git a/test/SerialIOTest.cpp b/test/SerialIOTest.cpp
@@ -6575,7 +6575,7 @@ void adios2_bp5_no_steps(bool usesteps)
         IO.DefineAttribute("/openPMD", std::string("1.1.0"));
         IO.DefineAttribute("/openPMDextension", uint32_t(0));
         IO.DefineAttribute("/software", std::string("openPMD-api"));
-        IO.DefineAttribute("/softwareVersion", std::string("0.17.0-dev"));
+        IO.DefineAttribute("/softwareVersion", std::string("0.17.0"));
 
         IO.DefineAttribute("/data/0/dt", double(1));
         IO.DefineAttribute(