mirror of
https://github.com/triqs/dft_tools
synced 2024-12-26 22:33:48 +01:00
edd1ff4529
A first general restructuration of the doc according to the pattern [tour|tutorial|reference]. In the reference part, objects are documented per topic. In each topic, [definition|c++|python|hdf5] (not yet implemented)
52 lines
1.4 KiB
ReStructuredText
52 lines
1.4 KiB
ReStructuredText
.. highlight:: c
|
|
|
|
h5::array_stack: stacking arrays or scalars
|
|
================================================================
|
|
|
|
h5::array_stack writes a sequences of arrays of the same shape (or of scalars) into an hdf5 array with one more dimension, unlimited in the stacking direction.
|
|
|
|
It is typically used to store a Monte-Carlo data series for later analysis.
|
|
|
|
* If the base of the stack is an array of rank R, the resulting hdf5 array will be of rank R+1.
|
|
|
|
* If the base of the stack is a simple number (double, int, ...), R=0.
|
|
|
|
* The syntax is simple:
|
|
|
|
* The << operator piles up an array/scalar onto the stack.
|
|
* The ++ operator advances by one slice in the stack.
|
|
* The () operator returns a view on the current slice of the stack.
|
|
|
|
* The stack is bufferized in memory (`bufsize` parameter), so that the file access does not happen too often.
|
|
|
|
* NB: beware to complex numbers ---> REF TO COMPLEX
|
|
|
|
Reference
|
|
------------
|
|
|
|
Here is the :doxy:`full C++ documentation<triqs::arrays::array_stack>` for this class.
|
|
|
|
.. :
|
|
Breathe Documentation
|
|
--------------------------
|
|
|
|
.. doxygenclass:: triqs::arrays::array_stack
|
|
:project: arrays
|
|
:members:
|
|
|
|
|
|
|
|
Tutorial
|
|
-----------
|
|
|
|
A simple example with a stack of double:
|
|
|
|
.. triqs_example:: examples_code/h5_stack_ex_sca.cpp
|
|
|
|
A simple example with a stack of array of rank 2 :
|
|
|
|
.. triqs_example:: examples_code/h5_stack_ex.cpp
|
|
|
|
|
|
|