dataset_creation.hpp

Go to the documentation of this file.

//
// (c) Copyright 2017 DESY,ESS
//
// This file is part of h5cpp.
//
// This library is free software; you can redistribute it and/or modify it
// under the terms of the GNU Lesser General Public License as published
// by the Free Software Foundation; either version 2.1 of the License, or
// (at your option) any later version.
//
// This library is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty ofMERCHANTABILITY
// or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
// License for more details.
//
// You should have received a copy of the GNU Lesser General Public License
// along with this library; if not, write to the
// Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor
// Boston, MA  02110-1301 USA
// ===========================================================================
//
// Authors:
//   Eugen Wintersberger <eugen.wintersberger@desy.de>
//   Martin Shetty <martin.shetty@esss.se>
// Created on: Aug 21, 2017
//
#pragma once
 
#include <iostream>
#include <h5cpp/property/object_creation.hpp>
#include <h5cpp/core/types.hpp>
#include <h5cpp/datatype/datatype.hpp>
#include <h5cpp/datatype/type_trait.hpp>
#include <h5cpp/core/windows.hpp>
#include <h5cpp/error/error.hpp>
 
namespace hdf5 {
namespace property {
 
enum class DatasetFillValueStatus : std::underlying_type<H5D_fill_value_t>::type {
  Undefined = H5D_FILL_VALUE_UNDEFINED,
  Default = H5D_FILL_VALUE_DEFAULT,
  UserDefined = H5D_FILL_VALUE_USER_DEFINED
};
 
DLL_EXPORT std::ostream &operator<<(std::ostream &stream, const DatasetFillValueStatus &status);
 
enum class DatasetFillTime : std::underlying_type<H5D_fill_time_t>::type {
  IfSet = H5D_FILL_TIME_IFSET,
  Alloc = H5D_FILL_TIME_ALLOC,
  Never = H5D_FILL_TIME_NEVER
};
 
DLL_EXPORT std::ostream &operator<<(std::ostream &stream, const DatasetFillTime &time);
 
enum class DatasetAllocTime : std::underlying_type<H5D_alloc_time_t>::type {
      Default = H5D_ALLOC_TIME_DEFAULT,
 
      Early = H5D_ALLOC_TIME_EARLY,
 
      Incr = H5D_ALLOC_TIME_INCR,
 
      Late = H5D_ALLOC_TIME_LATE
};
 
DLL_EXPORT std::ostream &operator<<(std::ostream &stream, const DatasetAllocTime &time);
 
enum class DatasetLayout : std::underlying_type<H5D_layout_t>::type {
  Compact = H5D_COMPACT,
  Contiguous = H5D_CONTIGUOUS,
  Chunked = H5D_CHUNKED,
#if (defined(_DOXYGEN_) || H5_VERSION_GE(1,10,0))
  Virtual = H5D_VIRTUAL
#endif
};
 
DLL_EXPORT std::ostream &operator<<(std::ostream &stream, const DatasetLayout &layout);
 
class DLL_EXPORT DatasetCreationList : public ObjectCreationList {
 public:
  DatasetCreationList();
  DatasetCreationList(const DatasetCreationList &) = default;
 
  ~DatasetCreationList() override;
 
  explicit DatasetCreationList(ObjectHandle &&handle);
 
  void layout(DatasetLayout layout) const;
 
  DatasetLayout layout() const;
 
  void chunk(const hdf5::Dimensions &chunk_dims) const;
 
  hdf5::Dimensions chunk() const;
 
  template<typename T>
  void fill_value(const T &value,
                  const datatype::Datatype &type = datatype::TypeTrait<T>::create()) const;
 
  template<typename T>
  T fill_value(const datatype::Datatype &type = datatype::TypeTrait<T>::create()) const;
 
  DatasetFillValueStatus fill_value_status() const;
 
  void fill_time(DatasetFillTime time) const;
 
  DatasetFillTime fill_time() const;
 
  void allocation_time(DatasetAllocTime time) const;
 
  DatasetAllocTime allocation_time() const;
 
  unsigned int nfilters() const;
};
 
template<typename T>
void DatasetCreationList::fill_value(const T &value, const datatype::Datatype &type) const {
  if (H5Pset_fill_value(static_cast<hid_t>(*this),
                        static_cast<hid_t>(type), &value) < 0) {
    error::Singleton::instance().throw_with_stack("Failure to set fill value for dataset!");
  }
}
 
template<typename T>
T DatasetCreationList::fill_value(const datatype::Datatype &type) const {
  T value;
  if (H5Pget_fill_value(static_cast<hid_t>(*this), static_cast<hid_t>(type), &value) < 0) {
    error::Singleton::instance().throw_with_stack("Failure retrieving the fill value for a dataset!");
  }
  return value;
}
 
} // namespace property
} // namespace hdf5