openPMD-api
Dataset.hpp
1 /* Copyright 2017-2021 Fabian Koller, Franz Poeschel, Axel Huebl
2  *
3  * This file is part of openPMD-api.
4  *
5  * openPMD-api is free software: you can redistribute it and/or modify
6  * it under the terms of of either the GNU General Public License or
7  * the GNU Lesser General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * openPMD-api is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14  * GNU General Public License and the GNU Lesser General Public License
15  * for more details.
16  *
17  * You should have received a copy of the GNU General Public License
18  * and the GNU Lesser General Public License along with openPMD-api.
19  * If not, see <http://www.gnu.org/licenses/>.
20  */
21 #pragma once
22 
23 #include "openPMD/Datatype.hpp"
24 
25 #include <memory>
26 #include <type_traits>
27 #include <vector>
28 #include <string>
29 
30 
31 namespace openPMD
32 {
33 using Extent = std::vector< std::uint64_t >;
34 using Offset = std::vector< std::uint64_t >;
35 
36 class Dataset
37 {
38  friend class RecordComponent;
39 
40 public:
41  Dataset(Datatype, Extent, std::string options = "{}");
42 
49  Dataset( Extent );
50 
51  Dataset& extend(Extent newExtent);
52  Dataset& setChunkSize(Extent const&);
53  Dataset& setCompression(std::string const&, uint8_t const);
54  Dataset& setCustomTransform(std::string const&);
55 
56  Extent extent;
57  Datatype dtype;
58  uint8_t rank;
59  Extent chunkSize;
60  std::string compression;
61  std::string transform;
62  std::string options = "{}";
63 };
64 } // namespace openPMD
openPMD::Datatype
Datatype
Concrete datatype of an object available at runtime.
Definition: Datatype.hpp:45
openPMD
Public definitions of openPMD-api.
Definition: Date.cpp:29
openPMD::RecordComponent
Definition: RecordComponent.hpp:81
openPMD::Dataset
Definition: Dataset.hpp:36
openPMD::Dataset::options
std::string options
backend-dependent JSON configuration
Definition: Dataset.hpp:62