Layer to manage storage of attributes associated with file objects. More...

#include <Attributable.hpp>

Inheritance diagram for openPMD::AttributableInterface:

[legend]

Collaboration diagram for openPMD::AttributableInterface:

Classes
struct	MyPath
	String serialization to describe an Attributable. More...

Public Member Functions
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[])

Protected Types
enum	ReadMode { IgnoreExisting, OverrideExisting, FullyReread }

Protected Member Functions
	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 ()

Protected Attributes
internal::AttributableData *	m_attri = nullptr

Friends
template<typename T_elem >
class	BaseRecord

template<typename T , typename T_key , typename T_container >
class	Container

template<typename T >
struct	traits::GenerationPolicy

class	Iteration

class	Series

class	SeriesInterface

class	Writable

class	WriteIterations

Writable *	getWritable (AttributableInterface *)

Detailed Description

Layer to manage storage of attributes associated with file objects.

Mandatory and user-defined Attributes and their data for every object in the openPMD hierarchy are stored and managed through this class.

Member Enumeration Documentation

◆ ReadMode

enum openPMD::AttributableInterface::ReadMode

protected

Enumerator
IgnoreExisting	Don't read an attribute from the backend if it has been previously read.
OverrideExisting	Read all the attributes that the backend has to offer and override if it has been read previously.
FullyReread	Remove all attributes that have been read previously and read everything that the backend currently has to offer.

Member Function Documentation

◆ attributes()

std::vector< std::string > openPMD::AttributableInterface::attributes ( ) const

List all currently stored Attributes' keys.

Returns: Vector of keys (i.e. names) of all currently stored Attributes.

◆ comment()

std::string openPMD::AttributableInterface::comment ( ) const

Retrieve a user-supplied comment associated with the object.

Exceptions

no_such_attribute_error If no comment is currently stored.

Returns: String containing the user-supplied comment.

◆ containingIteration()

Iteration & openPMD::AttributableInterface::containingIteration ( ) const

protected

Returns the corresponding Iteration.

Return the openPMD::iteration that this Attributable is contained in. This walks up the linked parents until it finds the Iteration object. Throws an error otherwise, e.g., for Series objects.

◆ containsAttribute()

bool openPMD::AttributableInterface::containsAttribute ( std::string const & key ) const

Check whether am Attribute with a given key exists.

Parameters

key	Key (i.e. name) of the Attribute to find.

Returns: true if provided key was present, false otherwise.

◆ deleteAttribute()

bool openPMD::AttributableInterface::deleteAttribute ( std::string const & key )

Remove Attribute of provided value both logically and physically.

Parameters

key	Key (i.e. name) of the Attribute to remove.

Returns: true if provided key was present and removal succeeded, false otherwise.

◆ getAttribute()

Attribute openPMD::AttributableInterface::getAttribute ( std::string const & key ) const

Retrieve value of Attribute stored with provided key.

Exceptions

no_such_attribute_error If no Attribute is currently stored with the provided key.

Parameters

key	Key (i.e. name) of the Attribute to retrieve value for.

Returns: Stored Attribute in Variant form.

◆ myPath()

auto openPMD::AttributableInterface::myPath ( ) const

The path to this object within its containing Series.

Returns: A struct informing about the context of this Attributable.

◆ numAttributes()

size_t openPMD::AttributableInterface::numAttributes ( ) const

Count all currently stored Attributes.

Returns: Number of currently stored Attributes.

◆ readFloatingpoint()

template<typename T >

T openPMD::AttributableInterface::readFloatingpoint ( std::string const & key ) const

inlineprotected

Retrieve the value of a floating point Attribute of user-defined precision with ensured type-safety.

Note: Since the precision of certain Attributes is intentionally left unspecified in the openPMD standard, this provides a mechanism to retrieve those values without giving up type-safety.

See also: https://github.com/openPMD/openPMD-standard/blob/latest/STANDARD.md#conventions-throughout-these-documents

Note: If the supplied and stored floating point precision are not the same, the value is cast to the desired precision unconditionally.

Exceptions

no_such_attribute_error If no Attribute is currently stored with the provided key.

Template Parameters

T	Floating point type of user-defined precision to retrieve the value as.

Parameters

key	Key (i.e. name) of the floating-point Attribute to retrieve value for.

Returns: Value of stored Attribute as supplied floating point type.

◆ readVectorFloatingpoint()

template<typename T >

std::vector< T > openPMD::AttributableInterface::readVectorFloatingpoint ( std::string const & key ) const

inlineprotected

Retrieve a vector of values of a floating point Attributes of user-defined precision with ensured type-safety.

Note: Since the precision of certain Attributes is intentionally left unspecified in the openPMD standard, this provides a mechanism to retrieve those values without giving up type-safety.

See also: https://github.com/openPMD/openPMD-standard/blob/latest/STANDARD.md#conventions-throughout-these-documents

Note: If the supplied and stored floating point precision are not the same, the values are cast to the desired precision unconditionally.

Exceptions

no_such_attribute_error If no Attribute is currently stored with the provided key.

Template Parameters

T	Floating point type of user-defined precision to retrieve the values as.

Parameters

key	Key (i.e. name) of the floating-point Attribute to retrieve values for.

Returns: Vector of values of stored Attribute as supplied floating point type.

◆ seriesFlush()

void openPMD::AttributableInterface::seriesFlush ( )

Flush the corresponding Series object.

Writable connects all objects of an openPMD series through a linked list of parents. This method will walk up the parent list until it reaches an object that has no parent, which is the Series object, and flush()-es it.

◆ setAttribute()

template<typename T >

bool openPMD::AttributableInterface::setAttribute	(	std::string const &	key,
		T	value
	)

inline

Populate Attribute of provided name with provided value.

Note: If the provided Attribute already exists, the value is replaced. If it does not exist, a new Attribute is created.

Template Parameters

T	Type of the object to be stored. Only types contained in Datatype can be handled.

Parameters

key	Key (i.e. name) to identify and store an Attributes value by.
value	Value of Attribute stored with the provided key.

Returns: true if key was already present, false otherwise

◆ setComment()

AttributableInterface & openPMD::AttributableInterface::setComment ( std::string const & comment )

Populate Attribute corresponding to a comment with the user-supplied comment.

Parameters

comment String value to be stored as a comment.

Returns: Reference to modified Attributable.

The documentation for this class was generated from the following files:

/tmp/tmp.7iNmvGSbic/openPMD-api/include/openPMD/backend/Attributable.hpp
/tmp/tmp.7iNmvGSbic/openPMD-api/src/backend/Attributable.cpp

Classes

Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ ReadMode

Member Function Documentation

◆ attributes()

◆ comment()

◆ containingIteration()

◆ containsAttribute()

◆ deleteAttribute()

◆ getAttribute()

◆ myPath()

◆ numAttributes()

◆ readFloatingpoint()

◆ readVectorFloatingpoint()

◆ seriesFlush()

◆ setAttribute()

◆ setComment()