From: Daniel Garcia-Sanchez Date: Tue, 9 Oct 2018 14:37:55 +0000 (+0200) Subject: Improve the documentation X-Git-Tag: v9.1.0-rc1~453^2~33 X-Git-Url: https://gitweb.dealii.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ed031ad89e257756630b0906912b084d189ea462;p=dealii.git Improve the documentation Thread safety documentation Modify the hyperslab documentation --- diff --git a/include/deal.II/base/hdf5.h b/include/deal.II/base/hdf5.h index 6b4c4bb7a5..8787327df1 100644 --- a/include/deal.II/base/hdf5.h +++ b/include/deal.II/base/hdf5.h @@ -127,7 +127,8 @@ DEAL_II_NAMESPACE_OPEN * ## Write a hyperslab in parallel * Hyperslabs are portions of datasets. A hyperslab can be a contiguous * collection of points in a dataset, or it can be a regular pattern of points - * or blocks in a datataset. + * or blocks in a datataset. Hyperslabs are equivalent to python numpy and h5py + * [slices](http://docs.h5py.org/en/latest/high/dataset.html#reading-writing-data). * * See the Dataspaces @@ -300,6 +301,14 @@ DEAL_II_NAMESPACE_OPEN * 4 5 * @endcode * + * # HDF5 and thread safety + * By default HDF5 is not thread-safe. The HDF5 library can be configured to be + * thread-safe, see [the HDF5 + * documentation](https://support.hdfgroup.org/HDF5/faq/threadsafe.html). The + * thread-safe HDF5 version serializes the API but does not provide any level of + * concurrency. To achieve high parallel performance with HDF5, we advice to use + * HDF5 with MPI. + * * @author Daniel Garcia-Sanchez, 2018 */ namespace HDF5