openPMD-api
|
Root level of the openPMD hierarchy. More...
#include <Series.hpp>
Public Member Functions | |
Series (std::string const &filepath, Access at, MPI_Comm comm, std::string const &options="{}") | |
Series (std::string const &filepath, Access at, std::string const &options="{}") | |
Construct a new Series. More... | |
operator bool () const | |
Is this a usable Series object? More... | |
ReadIterations | readIterations () |
Entry point to the reading end of the streaming API. More... | |
WriteIterations | writeIterations () |
Entry point to the writing end of the streaming API. More... | |
![]() | |
std::string | openPMD () const |
SeriesInterface & | setOpenPMD (std::string const &openPMD) |
Set the version of the enforced openPMD standard. More... | |
uint32_t | openPMDextension () const |
SeriesInterface & | setOpenPMDextension (uint32_t openPMDextension) |
Set a 32-bit mask of applied extensions to the openPMD standard. More... | |
std::string | basePath () const |
SeriesInterface & | setBasePath (std::string const &basePath) |
Set the common prefix for all data sets and sub-groups of a specific iteration. More... | |
std::string | meshesPath () const |
SeriesInterface & | setMeshesPath (std::string const &meshesPath) |
Set the path to mesh records, relative(!) to basePath . More... | |
std::string | particlesPath () const |
SeriesInterface & | setParticlesPath (std::string const &particlesPath) |
Set the path to groups for each particle species, relative(!) to basePath . More... | |
std::string | author () const |
SeriesInterface & | setAuthor (std::string const &author) |
Indicate the author and contact for the information in the file. More... | |
std::string | software () const |
SeriesInterface & | setSoftware (std::string const &newName, std::string const &newVersion=std::string("unspecified")) |
Indicate the software/code/simulation that created the file. More... | |
std::string | softwareVersion () const |
SeriesInterface & | setSoftwareVersion (std::string const &softwareVersion) |
Indicate the version of the software/code/simulation that created the file. More... | |
std::string | date () const |
SeriesInterface & | setDate (std::string const &date) |
Indicate the date of creation. More... | |
std::string | softwareDependencies () const |
SeriesInterface & | setSoftwareDependencies (std::string const &newSoftwareDependencies) |
Indicate dependencies of software that were used to create the file. More... | |
std::string | machine () const |
SeriesInterface & | setMachine (std::string const &newMachine) |
Indicate the machine or relevant hardware that created the file. More... | |
IterationEncoding | iterationEncoding () const |
SeriesInterface & | setIterationEncoding (IterationEncoding iterationEncoding) |
Set the encoding style for multiple iterations in this series. More... | |
std::string | iterationFormat () const |
SeriesInterface & | setIterationFormat (std::string const &iterationFormat) |
Set a pattern describing how to access single iterations in the raw file. More... | |
std::string | name () const |
SeriesInterface & | setName (std::string const &name) |
Set the pattern for file names. More... | |
std::string | backend () const |
The currently used backend. More... | |
void | flush () |
Execute all required remaining IO operations to write or read data. | |
![]() | |
Attribute | getAttribute (std::string const &key) const |
Retrieve value of Attribute stored with provided key. More... | |
bool | deleteAttribute (std::string const &key) |
Remove Attribute of provided value both logically and physically. More... | |
std::vector< std::string > | attributes () const |
List all currently stored Attributes' keys. More... | |
size_t | numAttributes () const |
Count all currently stored Attributes. More... | |
bool | containsAttribute (std::string const &key) const |
Check whether am Attribute with a given key exists. More... | |
std::string | comment () const |
Retrieve a user-supplied comment associated with the object. More... | |
AttributableInterface & | setComment (std::string const &comment) |
Populate Attribute corresponding to a comment with the user-supplied comment. More... | |
void | seriesFlush () |
Flush the corresponding Series object. More... | |
MyPath | myPath () const |
The path to this object within its containing Series. More... | |
template<typename T > | |
bool | setAttribute (std::string const &key, T value) |
Populate Attribute of provided name with provided value. More... | |
bool | setAttribute (std::string const &key, char const value[]) |
Public Attributes | |
Container< Iteration, uint64_t > | iterations |
Additional Inherited Members | |
![]() | |
enum | ReadMode { IgnoreExisting, OverrideExisting, FullyReread } |
![]() | |
SeriesInterface (internal::SeriesData *, internal::AttributableData *) | |
![]() | |
AttributableInterface (internal::AttributableData *) | |
template<typename T > | |
AttributableInterface (T *attri) | |
const internal::SeriesInternal & | retrieveSeries () const |
internal::SeriesInternal & | retrieveSeries () |
void | seriesFlush (FlushLevel) |
void | flushAttributes () |
void | readAttributes (ReadMode) |
template<typename T > | |
T | readFloatingpoint (std::string const &key) const |
Retrieve the value of a floating point Attribute of user-defined precision with ensured type-safety. More... | |
template<typename T > | |
std::vector< T > | readVectorFloatingpoint (std::string const &key) const |
Retrieve a vector of values of a floating point Attributes of user-defined precision with ensured type-safety. More... | |
AbstractIOHandler * | IOHandler () |
const AbstractIOHandler * | IOHandler () const |
Writable *& | parent () |
const Writable * | parent () const |
Writable & | writable () |
const Writable & | writable () const |
internal::AttributableData & | get () |
const internal::AttributableData & | get () const |
bool | dirty () const |
bool & | dirty () |
bool | written () const |
bool & | written () |
const Iteration & | containingIteration () const |
Returns the corresponding Iteration. More... | |
Iteration & | containingIteration () |
![]() | |
internal::AttributableData * | m_attri = nullptr |
Root level of the openPMD hierarchy.
Entry point and common link between all iterations of particle and mesh data.
An instance can be created either directly via the given constructors or via the SeriesBuilder class.
openPMD::Series::Series | ( | std::string const & | filepath, |
Access | at, | ||
std::string const & | options = "{}" |
||
) |
Construct a new Series.
filepath | The backend will be determined by the filepath extension. |
at | Access mode. |
options | Advanced backend configuration via JSON. May be specified as a JSON-formatted string directly, or as a path to a JSON textfile, prepended by an at sign '@'. |
openPMD::Series::operator bool | ( | ) | const |
ReadIterations openPMD::Series::readIterations | ( | ) |
Entry point to the reading end of the streaming API.
Creates and returns an instance of the ReadIterations class which can be used for iterating over the openPMD iterations in a C++11-style for loop. Look for the ReadIterations class for further documentation.
WriteIterations openPMD::Series::writeIterations | ( | ) |
Entry point to the writing end of the streaming API.
Creates and returns an instance of the WriteIterations class which is a restricted container of iterations which takes care of streaming semantics. The created object is stored as member of the Series object, hence this method may be called as many times as a user wishes. Look for the WriteIterations class for further documentation.