Skip to content

Commit 76d4e2d

Browse files
committed
[Draft] Remove Work-Arounds for ADIOS2<2.7.0
1 parent cd7fcc4 commit 76d4e2d

2 files changed

Lines changed: 5 additions & 0 deletions

File tree

docs/source/backends/adios2.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ Steps
2222

2323
ADIOS2 is optimized towards organizing the process of reading/writing data into IO steps.
2424
In order to activate steps, it is imperative to use the :ref:`Streaming API <usage-streaming>` (which can be used for either file-based or streaming-based workflows).
25+
@franzpoeschel: let's remove these work-arounds :-)
2526
With ADIOS2 release 2.6.0 containing a bug (fixed in development versions, see `PR #2348 <https://github.com/ornladios/ADIOS2/pull/2348>`_) that disallows random-accessing steps in file-based engines, step-based processing must currently be opted in to via use of the :ref:`JSON parameter<backendconfig>` ``adios2.engine.usesteps = true`` when using a file-based engine such as BP3 or BP4.
2627
With these ADIOS2 releases, files written in such a way may only be read using the streaming API.
2728
Upon reading a file, the ADIOS2 backend will automatically recognize whether it has been written with or without steps, ignoring the JSON option mentioned above.

include/openPMD/IO/ADIOS/ADIOS2IOHandler.hpp

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1245,6 +1245,8 @@ namespace detail
12451245
* is opt-in for now.
12461246
* 2) Reading with the Streaming API any file that has been written
12471247
* without steps.
1248+
*
1249+
* @todo [franzpoeschel] let's remove these work-arounds :-)
12481250
*/
12491251
NoStream,
12501252
/**
@@ -1260,6 +1262,8 @@ namespace detail
12601262
* and attributes in the file will be shown.
12611263
* Hence, streamStatus == Parsing means that the first step has yet
12621264
* to be opened.
1265+
*
1266+
* @todo [franzpoeschel] let's remove these work-arounds :-)
12631267
*/
12641268
Parsing,
12651269
/**

0 commit comments

Comments
 (0)