The on-storage metadata of an RNTuple.

Represents the on-disk (on storage) information about an RNTuple. The metadata consists of a header, a footer, and potentially multiple page lists. The header carries the RNTuple schema, i.e. the fields and the associated columns and their relationships. The footer carries information about one or several cluster groups and links to their page lists. For every cluster group, a page list envelope stores cluster summaries and page locations. For every cluster, it stores for every column the range of element indexes as well as a list of pages and page locations.

The descriptor provides machine-independent (de-)serialization of headers and footers, and it provides lookup routines for RNTuple objects (pages, clusters, ...). It is supposed to be usable by all RPageStorage implementations.

The serialization does not use standard ROOT streamers in order to not let it depend on libCore. The serialization uses the concept of envelopes and frames: header, footer, and page list envelopes have a preamble with a type ID and length. Substructures are serialized in frames and have a size and number of items (for list frames). This allows for forward and backward compatibility when the metadata evolves.

Definition at line 709 of file RNTupleDescriptor.hxx.

Classes
class	RClusterDescriptorIterable
	Loop over all the clusters of an RNTuple, ordered by first entry number. More...

class	RClusterGroupDescriptorIterable
	Used to loop over all the cluster groups of an RNTuple in order of entry ranges. More...

class	RColumnDescriptorIterable
	Used to loop over a field's associated columns. More...

struct	RCreateModelOptions
	Modifiers passed to CreateModel() More...

class	RExtraTypeInfoDescriptorIterable
	Used to loop over all the extra type info record of an RNTuple (in unspecified order) More...

class	RFieldDescriptorIterable
	Used to loop over a field's child fields. More...

class	RHeaderExtension
	Summarizes information about fields and the corresponding columns that were added after the header has been serialized. More...

Public Types
enum	EFeatureFlags { kFeatureFlag_NestedDeferredColumns = 0 , kFeatureFlag_COUNT , kFeatureFlag_Test = 137 }
	All known feature flags. More...

Public Member Functions
	RNTupleDescriptor ()

	RNTupleDescriptor (const RNTupleDescriptor &other)=delete

	RNTupleDescriptor (RNTupleDescriptor &&other)=default

RResult< void >	AddClusterGroupDetails (ROOT::DescriptorId_t clusterGroupId, std::vector< RClusterDescriptor > &clusterDescs)
	Methods to load and drop cluster group details (cluster IDs and page locations)

RNTupleDescriptor	Clone () const

std::unique_ptr< ROOT::RNTupleModel >	CreateModel (const RCreateModelOptions &options=RCreateModelOptions()) const
	Re-create the C++ model from the stored metadata.

RResult< void >	DropClusterGroupDetails (ROOT::DescriptorId_t clusterGroupId)

ROOT::DescriptorId_t	FindFieldId (std::string_view fieldName) const
	Searches for a top-level field.

ROOT::DescriptorId_t	FindFieldId (std::string_view fieldName, ROOT::DescriptorId_t parentId) const

ROOT::DescriptorId_t	FindLogicalColumnId (ROOT::DescriptorId_t fieldId, std::uint32_t columnIndex, std::uint16_t representationIndex) const

ROOT::DescriptorId_t	FindPhysicalColumnId (ROOT::DescriptorId_t fieldId, std::uint32_t columnIndex, std::uint16_t representationIndex) const

RClusterDescriptorIterable	GetActiveClusterIterable () const

ROOT::Experimental::RNTupleAttrSetDescriptorIterable	GetAttrSetIterable () const

const RClusterDescriptor &	GetClusterDescriptor (ROOT::DescriptorId_t clusterId) const

const RClusterGroupDescriptor &	GetClusterGroupDescriptor (ROOT::DescriptorId_t clusterGroupId) const

RClusterGroupDescriptorIterable	GetClusterGroupIterable () const

const RColumnDescriptor &	GetColumnDescriptor (ROOT::DescriptorId_t columnId) const

RColumnDescriptorIterable	GetColumnIterable () const

RColumnDescriptorIterable	GetColumnIterable (const RFieldDescriptor &fieldDesc) const

RColumnDescriptorIterable	GetColumnIterable (ROOT::DescriptorId_t fieldId) const

const std::string &	GetDescription () const

RExtraTypeInfoDescriptorIterable	GetExtraTypeInfoIterable () const

std::vector< std::uint64_t >	GetFeatureFlags () const

const RFieldDescriptor &	GetFieldDescriptor (ROOT::DescriptorId_t fieldId) const

RFieldDescriptorIterable	GetFieldIterable (const RFieldDescriptor &fieldDesc) const

RFieldDescriptorIterable	GetFieldIterable (const RFieldDescriptor &fieldDesc, const std::function< bool(ROOT::DescriptorId_t, ROOT::DescriptorId_t)> &comparator) const

RFieldDescriptorIterable	GetFieldIterable (ROOT::DescriptorId_t fieldId) const

RFieldDescriptorIterable	GetFieldIterable (ROOT::DescriptorId_t fieldId, const std::function< bool(ROOT::DescriptorId_t, ROOT::DescriptorId_t)> &comparator) const

const RFieldDescriptor &	GetFieldZero () const

ROOT::NTupleSize_t R__DEPRECATED(6, 46, "This function is ill-conceived in the descriptor " "as not all cluster descriptors may be present. This interface is no longer publicly exposed.") GetNElements(ROOT ROOT::DescriptorId_t	GetFieldZeroId () const
	Returns the logical parent of all top-level RNTuple data fields.

std::uint64_t	GetGeneration () const

const RHeaderExtension *	GetHeaderExtension () const
	Return header extension information; if the descriptor does not have a header extension, return `nullptr`

std::size_t	GetNActiveClusters () const

const std::string &	GetName () const

std::size_t	GetNAttributeSets () const

std::size_t	GetNClusterGroups () const

std::size_t	GetNClusters () const

ROOT::NTupleSize_t	GetNEntries () const
	We know the number of entries from adding the cluster summaries.

std::size_t	GetNExtraTypeInfos () const

std::size_t	GetNFields () const

std::size_t	GetNLogicalColumns () const

std::size_t	GetNPhysicalColumns () const

std::uint64_t	GetOnDiskFooterSize () const

std::uint64_t	GetOnDiskHeaderSize () const

std::uint64_t	GetOnDiskHeaderXxHash3 () const

ROOT::DescriptorId_t R__DEPRECATED(6, 46, "This function is ill-defined in the descriptor " "as not all cluster descriptors may be present. This interface is no longer exposed.") FindClusterId(ROOT ROOT::DescriptorId_t R__DEPRECATED(6, 46, "This function is ill-defined in the descriptor " "as not all cluster descriptors may be present. This interface is no longer exposed.") FindNextClusterId(ROOT ROOT::DescriptorId_t R__DEPRECATED(6, 46, "This function is ill-defined in the descriptor " "as not all cluster descriptors may be present. This interface is no longer exposed.") FindPrevClusterId(ROOT std::string	GetQualifiedFieldName (ROOT::DescriptorId_t fieldId) const
	Walks up the parents of the field ID and returns a field name of the form a.b.c.d In case of invalid field ID, an empty string is returned.

RFieldDescriptorIterable	GetTopLevelFields () const

RFieldDescriptorIterable	GetTopLevelFields (const std::function< bool(ROOT::DescriptorId_t, ROOT::DescriptorId_t)> &comparator) const

std::string	GetTypeNameForComparison (const RFieldDescriptor &fieldDesc) const
	Adjust the type name of the passed RFieldDescriptor for comparison with another renormalized type name.

std::uint64_t	GetVersion () const

bool	HasFeature (unsigned int flag) const

void	IncGeneration ()

RNTupleDescriptor &	operator= (const RNTupleDescriptor &other)=delete

RNTupleDescriptor &	operator= (RNTupleDescriptor &&other)=default

bool	operator== (const RNTupleDescriptor &other) const

void	PrintInfo (std::ostream &output) const

RClusterDescriptorIterable	R__DEPRECATED (6, 46, "This function is unsafe to use because, in general, not all cluster " "metadata are available (there may be cluster groups with unloaded cluster group details). Use the " "'GetActiveClusterIterable()' method instead if you are aware of this limitation.") GetClusterIterable() const

Private Member Functions
RNTupleDescriptor	CloneSchema (bool shareStringPool) const
	Creates a descriptor containing only the schema information about this RNTuple, i.e.

bool	FieldTypeNamesMayNeedFixup () const
	ROOT v6.34, with spec versions before 1.0.0.1, did not properly renormalize the type name.

ROOT::DescriptorId_t	FindClusterId (ROOT::NTupleSize_t entryIdx) const

Private Attributes
std::vector< Experimental::RNTupleAttrSetDescriptor >	fAttributeSets
	List of AttributeSets linked to this RNTuple.

std::unordered_map< ROOT::DescriptorId_t, RClusterDescriptor >	fClusterDescriptors
	Potentially a subset of all the available clusters.

std::unordered_map< ROOT::DescriptorId_t, RClusterGroupDescriptor >	fClusterGroupDescriptors

std::unordered_map< ROOT::DescriptorId_t, RColumnDescriptor >	fColumnDescriptors

std::string	fDescription
	Free text from the user.

std::vector< RExtraTypeInfoDescriptor >	fExtraTypeInfoDescriptors

std::set< unsigned int >	fFeatureFlags

std::unordered_map< ROOT::DescriptorId_t, RFieldDescriptor >	fFieldDescriptors

ROOT::DescriptorId_t	fFieldZeroId = ROOT::kInvalidDescriptorId
	Set by the descriptor builder.

std::uint64_t	fGeneration = 0
	The generation of the descriptor.

std::unique_ptr< RHeaderExtension >	fHeaderExtension

std::string	fName
	The RNTuple name needs to be unique in a given storage location (file)

std::uint64_t	fNClusters = 0
	Updated by the descriptor builder when the cluster groups are added.

std::uint64_t	fNEntries = 0
	Updated by the descriptor builder when the cluster groups are added.

std::uint64_t	fNPhysicalColumns = 0
	Updated by the descriptor builder when columns are added.

std::uint64_t	fOnDiskFooterSize = 0
	Like fOnDiskHeaderSize, contains both cluster summaries and page locations.

std::uint64_t	fOnDiskHeaderSize = 0
	Set by the descriptor builder when deserialized.

std::uint64_t	fOnDiskHeaderXxHash3 = 0
	Set by the descriptor builder when deserialized.

std::vector< ROOT::DescriptorId_t >	fSortedClusterGroupIds
	References cluster groups sorted by entry range and thus allows for binary search.

std::shared_ptr< Internal::RStringPool >	fStringPool
	Storage for all the field strings. Shared among descriptor clones.

std::uint16_t	fVersionEpoch = 0
	Set by the descriptor builder when deserialized.

std::uint16_t	fVersionMajor = 0
	Set by the descriptor builder when deserialized.

std::uint16_t	fVersionMinor = 0
	Set by the descriptor builder when deserialized.

std::uint16_t	fVersionPatch = 0
	Set by the descriptor builder when deserialized.

Friends
class	Experimental::RNTupleAttrSetDescriptorIterable

RNTupleDescriptor	Internal::CloneDescriptorSchema (const RNTupleDescriptor &desc)

class	Internal::RNTupleDescriptorBuilder

#include <ROOT/RNTupleDescriptor.hxx>

Member Enumeration Documentation

◆ EFeatureFlags

enum ROOT::RNTupleDescriptor::EFeatureFlags

All known feature flags.

Note that the flag values represent the bit index, not the already-bitshifted integer.

Enumerator

kFeatureFlag_NestedDeferredColumns

Signals that the RNTuple contains at least one deferred column that is part of a collection and was extended (i.e.

it appears in the footer). This can happen when merging two RNTuples that have the same collection field backed by columns with different encoding, e.g. a vector<float> whose elements are represented by SplitReal32 in the first ntuple and by Real32 in the second. Added in version 1.1.0.0 of the binary format.

kFeatureFlag_COUNT

kFeatureFlag_Test

Reserved for forward-compatibility testing.

Definition at line 787 of file RNTupleDescriptor.hxx.

Constructor & Destructor Documentation

◆ RNTupleDescriptor() [1/3]

ROOT::RNTupleDescriptor::RNTupleDescriptor ( )

Definition at line 327 of file RNTupleDescriptor.cxx.

◆ RNTupleDescriptor() [2/3]

ROOT::RNTupleDescriptor::RNTupleDescriptor ( const RNTupleDescriptor & other )

delete

◆ RNTupleDescriptor() [3/3]

ROOT::RNTupleDescriptor::RNTupleDescriptor ( RNTupleDescriptor && other )

default

Member Function Documentation

◆ AddClusterGroupDetails()

ROOT::RResult< void > ROOT::RNTupleDescriptor::AddClusterGroupDetails	(	ROOT::DescriptorId_t	clusterGroupId,
		std::vector< RClusterDescriptor > &	clusterDescs )

Methods to load and drop cluster group details (cluster IDs and page locations)

Definition at line 653 of file RNTupleDescriptor.cxx.

◆ Clone()

ROOT::RNTupleDescriptor ROOT::RNTupleDescriptor::Clone ( ) const

Definition at line 809 of file RNTupleDescriptor.cxx.

◆ CloneSchema()

ROOT::RNTupleDescriptor ROOT::RNTupleDescriptor::CloneSchema ( bool shareStringPool ) const

private

Creates a descriptor containing only the schema information about this RNTuple, i.e.

all the information needed to create a new RNTuple with the same schema as this one but not necessarily the same clustering. This is used when merging two RNTuples.

Definition at line 764 of file RNTupleDescriptor.cxx.

◆ CreateModel()

std::unique_ptr< ROOT::RNTupleModel > ROOT::RNTupleDescriptor::CreateModel ( const RCreateModelOptions & options = RCreateModelOptions() ) const

Re-create the C++ model from the stored metadata.

Definition at line 695 of file RNTupleDescriptor.cxx.

◆ DropClusterGroupDetails()

ROOT::RResult< void > ROOT::RNTupleDescriptor::DropClusterGroupDetails ( ROOT::DescriptorId_t clusterGroupId )

Definition at line 681 of file RNTupleDescriptor.cxx.

◆ FieldTypeNamesMayNeedFixup()

bool ROOT::RNTupleDescriptor::FieldTypeNamesMayNeedFixup ( ) const

private

ROOT v6.34, with spec versions before 1.0.0.1, did not properly renormalize the type name.

This function returns true if this descriptor has a version prior to 1.0.0.1 and may therefore contain such fields. This is only valid to call after SetVersion() or SetVersionForWriting() has been called on this descriptor.

Definition at line 409 of file RNTupleDescriptor.cxx.

◆ FindClusterId()

ROOT::DescriptorId_t ROOT::RNTupleDescriptor::FindClusterId ( ROOT::NTupleSize_t entryIdx ) const

private

Definition at line 457 of file RNTupleDescriptor.cxx.

◆ FindFieldId() [1/2]

ROOT::DescriptorId_t ROOT::RNTupleDescriptor::FindFieldId ( std::string_view fieldName ) const

Searches for a top-level field.

Definition at line 426 of file RNTupleDescriptor.cxx.

◆ FindFieldId() [2/2]

ROOT::DescriptorId_t ROOT::RNTupleDescriptor::FindFieldId	(	std::string_view	fieldName,
		ROOT::DescriptorId_t	parentId ) const

Definition at line 378 of file RNTupleDescriptor.cxx.

◆ FindLogicalColumnId()

ROOT::DescriptorId_t ROOT::RNTupleDescriptor::FindLogicalColumnId	(	ROOT::DescriptorId_t	fieldId,
		std::uint32_t	columnIndex,
		std::uint16_t	representationIndex ) const

Definition at line 431 of file RNTupleDescriptor.cxx.

◆ FindPhysicalColumnId()

ROOT::DescriptorId_t ROOT::RNTupleDescriptor::FindPhysicalColumnId	(	ROOT::DescriptorId_t	fieldId,
		std::uint32_t	columnIndex,
		std::uint16_t	representationIndex ) const

Definition at line 446 of file RNTupleDescriptor.cxx.

◆ GetActiveClusterIterable()

ROOT::RNTupleDescriptor::RClusterDescriptorIterable ROOT::RNTupleDescriptor::GetActiveClusterIterable ( ) const

Definition at line 1550 of file RNTupleDescriptor.cxx.

◆ GetAttrSetIterable()

ROOT::Experimental::RNTupleAttrSetDescriptorIterable ROOT::RNTupleDescriptor::GetAttrSetIterable ( ) const

Definition at line 1560 of file RNTupleDescriptor.cxx.

◆ GetClusterDescriptor()

const RClusterDescriptor & ROOT::RNTupleDescriptor::GetClusterDescriptor ( ROOT::DescriptorId_t clusterId ) const

inline

Definition at line 876 of file RNTupleDescriptor.hxx.

◆ GetClusterGroupDescriptor()

const RClusterGroupDescriptor & ROOT::RNTupleDescriptor::GetClusterGroupDescriptor ( ROOT::DescriptorId_t clusterGroupId ) const

inline

Definition at line 872 of file RNTupleDescriptor.hxx.

◆ GetClusterGroupIterable()

ROOT::RNTupleDescriptor::RClusterGroupDescriptorIterable ROOT::RNTupleDescriptor::GetClusterGroupIterable ( ) const

Definition at line 1540 of file RNTupleDescriptor.cxx.

◆ GetColumnDescriptor()

const RColumnDescriptor & ROOT::RNTupleDescriptor::GetColumnDescriptor ( ROOT::DescriptorId_t columnId ) const

inline

Definition at line 868 of file RNTupleDescriptor.hxx.

◆ GetColumnIterable() [1/3]

ROOT::RNTupleDescriptor::RColumnDescriptorIterable ROOT::RNTupleDescriptor::GetColumnIterable ( ) const

Definition at line 1523 of file RNTupleDescriptor.cxx.

◆ GetColumnIterable() [2/3]

ROOT::RNTupleDescriptor::RColumnDescriptorIterable ROOT::RNTupleDescriptor::GetColumnIterable ( const RFieldDescriptor & fieldDesc ) const

Definition at line 1529 of file RNTupleDescriptor.cxx.

◆ GetColumnIterable() [3/3]

ROOT::RNTupleDescriptor::RColumnDescriptorIterable ROOT::RNTupleDescriptor::GetColumnIterable ( ROOT::DescriptorId_t fieldId ) const

Definition at line 1535 of file RNTupleDescriptor.cxx.

◆ GetDescription()

const std::string & ROOT::RNTupleDescriptor::GetDescription ( ) const

inline

Definition at line 913 of file RNTupleDescriptor.hxx.

◆ GetExtraTypeInfoIterable()

ROOT::RNTupleDescriptor::RExtraTypeInfoDescriptorIterable ROOT::RNTupleDescriptor::GetExtraTypeInfoIterable ( ) const

Definition at line 1555 of file RNTupleDescriptor.cxx.

◆ GetFeatureFlags()

std::vector< std::uint64_t > ROOT::RNTupleDescriptor::GetFeatureFlags ( ) const

Definition at line 630 of file RNTupleDescriptor.cxx.

◆ GetFieldDescriptor()

const RFieldDescriptor & ROOT::RNTupleDescriptor::GetFieldDescriptor ( ROOT::DescriptorId_t fieldId ) const

inline

Definition at line 864 of file RNTupleDescriptor.hxx.

◆ GetFieldIterable() [1/4]

ROOT::RNTupleDescriptor::RFieldDescriptorIterable ROOT::RNTupleDescriptor::GetFieldIterable ( const RFieldDescriptor & fieldDesc ) const

Definition at line 1487 of file RNTupleDescriptor.cxx.

◆ GetFieldIterable() [2/4]

ROOT::RNTupleDescriptor::RFieldDescriptorIterable ROOT::RNTupleDescriptor::GetFieldIterable	(	const RFieldDescriptor &	fieldDesc,
		const std::function< bool(ROOT::DescriptorId_t, ROOT::DescriptorId_t)> &	comparator ) const

Definition at line 1492 of file RNTupleDescriptor.cxx.

◆ GetFieldIterable() [3/4]

ROOT::RNTupleDescriptor::RFieldDescriptorIterable ROOT::RNTupleDescriptor::GetFieldIterable ( ROOT::DescriptorId_t fieldId ) const

Definition at line 1500 of file RNTupleDescriptor.cxx.

◆ GetFieldIterable() [4/4]

ROOT::RNTupleDescriptor::RFieldDescriptorIterable ROOT::RNTupleDescriptor::GetFieldIterable	(	ROOT::DescriptorId_t	fieldId,
		const std::function< bool(ROOT::DescriptorId_t, ROOT::DescriptorId_t)> &	comparator ) const

Definition at line 1505 of file RNTupleDescriptor.cxx.

◆ GetFieldZero()

const RFieldDescriptor & ROOT::RNTupleDescriptor::GetFieldZero ( ) const

inline

Definition at line 934 of file RNTupleDescriptor.hxx.

◆ GetFieldZeroId()

ROOT::NTupleSize_t R__DEPRECATED(6, 46, "This function is ill-conceived in the descriptor " "as not all cluster descriptors may be present. This interface is no longer publicly exposed.") GetNElements(ROOT ROOT::DescriptorId_t ROOT::RNTupleDescriptor::GetFieldZeroId ( ) const

inline

Returns the logical parent of all top-level RNTuple data fields.

Definition at line 933 of file RNTupleDescriptor.hxx.

◆ GetGeneration()

std::uint64_t ROOT::RNTupleDescriptor::GetGeneration ( ) const

inline

Definition at line 976 of file RNTupleDescriptor.hxx.

◆ GetHeaderExtension()

const RHeaderExtension * ROOT::RNTupleDescriptor::GetHeaderExtension ( ) const

inline

Return header extension information; if the descriptor does not have a header extension, return nullptr

Definition at line 969 of file RNTupleDescriptor.hxx.

◆ GetNActiveClusters()

std::size_t ROOT::RNTupleDescriptor::GetNActiveClusters ( ) const

inline

Definition at line 920 of file RNTupleDescriptor.hxx.

◆ GetName()

const std::string & ROOT::RNTupleDescriptor::GetName ( ) const

inline

Definition at line 912 of file RNTupleDescriptor.hxx.

◆ GetNAttributeSets()

std::size_t ROOT::RNTupleDescriptor::GetNAttributeSets ( ) const

inline

Definition at line 922 of file RNTupleDescriptor.hxx.

◆ GetNClusterGroups()

std::size_t ROOT::RNTupleDescriptor::GetNClusterGroups ( ) const

inline

Definition at line 918 of file RNTupleDescriptor.hxx.

◆ GetNClusters()

std::size_t ROOT::RNTupleDescriptor::GetNClusters ( ) const

inline

Definition at line 919 of file RNTupleDescriptor.hxx.

◆ GetNEntries()

ROOT::NTupleSize_t ROOT::RNTupleDescriptor::GetNEntries ( ) const

inline

We know the number of entries from adding the cluster summaries.

Definition at line 925 of file RNTupleDescriptor.hxx.

◆ GetNExtraTypeInfos()

std::size_t ROOT::RNTupleDescriptor::GetNExtraTypeInfos ( ) const

inline

Definition at line 921 of file RNTupleDescriptor.hxx.

◆ GetNFields()

std::size_t ROOT::RNTupleDescriptor::GetNFields ( ) const

inline

Definition at line 915 of file RNTupleDescriptor.hxx.

◆ GetNLogicalColumns()

std::size_t ROOT::RNTupleDescriptor::GetNLogicalColumns ( ) const

inline

Definition at line 916 of file RNTupleDescriptor.hxx.

◆ GetNPhysicalColumns()

std::size_t ROOT::RNTupleDescriptor::GetNPhysicalColumns ( ) const

inline

Definition at line 917 of file RNTupleDescriptor.hxx.

◆ GetOnDiskFooterSize()

std::uint64_t ROOT::RNTupleDescriptor::GetOnDiskFooterSize ( ) const

inline

Definition at line 856 of file RNTupleDescriptor.hxx.

◆ GetOnDiskHeaderSize()

std::uint64_t ROOT::RNTupleDescriptor::GetOnDiskHeaderSize ( ) const

inline

Definition at line 855 of file RNTupleDescriptor.hxx.

◆ GetOnDiskHeaderXxHash3()

std::uint64_t ROOT::RNTupleDescriptor::GetOnDiskHeaderXxHash3 ( ) const

inline

Definition at line 854 of file RNTupleDescriptor.hxx.

◆ GetQualifiedFieldName()

std::string ROOT::RNTupleDescriptor::GetQualifiedFieldName ( ROOT::DescriptorId_t fieldId ) const

Walks up the parents of the field ID and returns a field name of the form a.b.c.d In case of invalid field ID, an empty string is returned.

Definition at line 397 of file RNTupleDescriptor.cxx.

◆ GetTopLevelFields() [1/2]

ROOT::RNTupleDescriptor::RFieldDescriptorIterable ROOT::RNTupleDescriptor::GetTopLevelFields ( ) const

Definition at line 1512 of file RNTupleDescriptor.cxx.

◆ GetTopLevelFields() [2/2]

ROOT::RNTupleDescriptor::RFieldDescriptorIterable ROOT::RNTupleDescriptor::GetTopLevelFields ( const std::function< bool(ROOT::DescriptorId_t, ROOT::DescriptorId_t)> & comparator ) const

Definition at line 1517 of file RNTupleDescriptor.cxx.

◆ GetTypeNameForComparison()

std::string ROOT::RNTupleDescriptor::GetTypeNameForComparison ( const RFieldDescriptor & fieldDesc ) const

Adjust the type name of the passed RFieldDescriptor for comparison with another renormalized type name.

Definition at line 415 of file RNTupleDescriptor.cxx.

◆ GetVersion()

std::uint64_t ROOT::RNTupleDescriptor::GetVersion ( ) const

inline

See also: ROOT::RNTuple::GetCurrentVersion()

Definition at line 858 of file RNTupleDescriptor.hxx.

◆ HasFeature()

bool ROOT::RNTupleDescriptor::HasFeature ( unsigned int flag ) const

inline

Definition at line 965 of file RNTupleDescriptor.hxx.

◆ IncGeneration()

void ROOT::RNTupleDescriptor::IncGeneration ( )

inline

Definition at line 977 of file RNTupleDescriptor.hxx.

◆ operator=() [1/2]

RNTupleDescriptor & ROOT::RNTupleDescriptor::operator= ( const RNTupleDescriptor & other )

delete

◆ operator=() [2/2]

RNTupleDescriptor & ROOT::RNTupleDescriptor::operator= ( RNTupleDescriptor && other )

default

◆ operator==()

bool ROOT::RNTupleDescriptor::operator== ( const RNTupleDescriptor & other ) const

Definition at line 334 of file RNTupleDescriptor.cxx.

◆ PrintInfo()

void ROOT::RNTupleDescriptor::PrintInfo ( std::ostream & output ) const

Definition at line 78 of file RNTupleDescriptorFmt.cxx.

◆ R__DEPRECATED()

RClusterDescriptorIterable ROOT::RNTupleDescriptor::R__DEPRECATED	(	6	,
		46	,
		"This function is unsafe to use	because,
		in	general,
		not all cluster " "metadata are available(there may be cluster groups with unloaded cluster group details). Use the " " 'GetActiveClusterIterable()' method instead if you are aware of this limitation."	) const

Friends And Related Symbol Documentation

◆ Experimental::RNTupleAttrSetDescriptorIterable

friend class Experimental::RNTupleAttrSetDescriptorIterable

friend

Definition at line 809 of file RNTupleDescriptor.hxx.

◆ Internal::CloneDescriptorSchema

RNTupleDescriptor Internal::CloneDescriptorSchema ( const RNTupleDescriptor & desc )

friend

◆ Internal::RNTupleDescriptorBuilder

friend class Internal::RNTupleDescriptorBuilder

friend

Definition at line 710 of file RNTupleDescriptor.hxx.

Member Data Documentation

◆ fAttributeSets

std::vector<Experimental::RNTupleAttrSetDescriptor> ROOT::RNTupleDescriptor::fAttributeSets

private

List of AttributeSets linked to this RNTuple.

Definition at line 768 of file RNTupleDescriptor.hxx.

◆ fClusterDescriptors

std::unordered_map<ROOT::DescriptorId_t, RClusterDescriptor> ROOT::RNTupleDescriptor::fClusterDescriptors

private

Potentially a subset of all the available clusters.

Definition at line 766 of file RNTupleDescriptor.hxx.

◆ fClusterGroupDescriptors

std::unordered_map<ROOT::DescriptorId_t, RClusterGroupDescriptor> ROOT::RNTupleDescriptor::fClusterGroupDescriptors

private

Definition at line 760 of file RNTupleDescriptor.hxx.

◆ fColumnDescriptors

std::unordered_map<ROOT::DescriptorId_t, RColumnDescriptor> ROOT::RNTupleDescriptor::fColumnDescriptors

private

Definition at line 731 of file RNTupleDescriptor.hxx.

◆ fDescription

std::string ROOT::RNTupleDescriptor::fDescription

private

Free text from the user.

Definition at line 720 of file RNTupleDescriptor.hxx.

◆ fExtraTypeInfoDescriptors

std::vector<RExtraTypeInfoDescriptor> ROOT::RNTupleDescriptor::fExtraTypeInfoDescriptors

private

Definition at line 733 of file RNTupleDescriptor.hxx.

◆ fFeatureFlags

std::set<unsigned int> ROOT::RNTupleDescriptor::fFeatureFlags

private

Definition at line 729 of file RNTupleDescriptor.hxx.

◆ fFieldDescriptors

std::unordered_map<ROOT::DescriptorId_t, RFieldDescriptor> ROOT::RNTupleDescriptor::fFieldDescriptors

private

Definition at line 730 of file RNTupleDescriptor.hxx.

◆ fFieldZeroId

ROOT::DescriptorId_t ROOT::RNTupleDescriptor::fFieldZeroId = ROOT::kInvalidDescriptorId

private

Set by the descriptor builder.

Definition at line 722 of file RNTupleDescriptor.hxx.

◆ fGeneration

std::uint64_t ROOT::RNTupleDescriptor::fGeneration = 0

private

The generation of the descriptor.

Once constructed by an RNTupleDescriptorBuilder, the descriptor is mostly immutable except for the set of active page locations. During the lifetime of the descriptor, page location information for clusters can be added or removed. When this happens, the generation should be increased, so that users of the descriptor know that the information changed. The generation is increased, e.g., by the page source's exclusive lock guard around the descriptor. It is used, e.g., by the descriptor cache in RNTupleReader.

Definition at line 758 of file RNTupleDescriptor.hxx.

◆ fHeaderExtension

std::unique_ptr<RHeaderExtension> ROOT::RNTupleDescriptor::fHeaderExtension

private

Definition at line 734 of file RNTupleDescriptor.hxx.

◆ fName

std::string ROOT::RNTupleDescriptor::fName

private

The RNTuple name needs to be unique in a given storage location (file)

Definition at line 718 of file RNTupleDescriptor.hxx.

◆ fNClusters

std::uint64_t ROOT::RNTupleDescriptor::fNClusters = 0

private

Updated by the descriptor builder when the cluster groups are added.

Definition at line 749 of file RNTupleDescriptor.hxx.

◆ fNEntries

std::uint64_t ROOT::RNTupleDescriptor::fNEntries = 0

private

Updated by the descriptor builder when the cluster groups are added.

Definition at line 748 of file RNTupleDescriptor.hxx.

◆ fNPhysicalColumns

std::uint64_t ROOT::RNTupleDescriptor::fNPhysicalColumns = 0

private

Updated by the descriptor builder when columns are added.

Definition at line 724 of file RNTupleDescriptor.hxx.

◆ fOnDiskFooterSize

std::uint64_t ROOT::RNTupleDescriptor::fOnDiskFooterSize = 0

private

Like fOnDiskHeaderSize, contains both cluster summaries and page locations.

Definition at line 746 of file RNTupleDescriptor.hxx.

◆ fOnDiskHeaderSize

std::uint64_t ROOT::RNTupleDescriptor::fOnDiskHeaderSize = 0

private

Set by the descriptor builder when deserialized.

Definition at line 744 of file RNTupleDescriptor.hxx.

◆ fOnDiskHeaderXxHash3

std::uint64_t ROOT::RNTupleDescriptor::fOnDiskHeaderXxHash3 = 0

private

Set by the descriptor builder when deserialized.

Definition at line 745 of file RNTupleDescriptor.hxx.

◆ fSortedClusterGroupIds

std::vector<ROOT::DescriptorId_t> ROOT::RNTupleDescriptor::fSortedClusterGroupIds

private

References cluster groups sorted by entry range and thus allows for binary search.

Note that this list is empty during the descriptor building process and will only be created when the final descriptor is extracted from the builder.

Definition at line 764 of file RNTupleDescriptor.hxx.

◆ fStringPool

std::shared_ptr<Internal::RStringPool> ROOT::RNTupleDescriptor::fStringPool

private

Storage for all the field strings. Shared among descriptor clones.

Definition at line 727 of file RNTupleDescriptor.hxx.

◆ fVersionEpoch

std::uint16_t ROOT::RNTupleDescriptor::fVersionEpoch = 0

private

Set by the descriptor builder when deserialized.

Definition at line 739 of file RNTupleDescriptor.hxx.

◆ fVersionMajor

std::uint16_t ROOT::RNTupleDescriptor::fVersionMajor = 0

private

Set by the descriptor builder when deserialized.

Definition at line 740 of file RNTupleDescriptor.hxx.

◆ fVersionMinor

std::uint16_t ROOT::RNTupleDescriptor::fVersionMinor = 0

private

Set by the descriptor builder when deserialized.

Definition at line 741 of file RNTupleDescriptor.hxx.

◆ fVersionPatch

std::uint16_t ROOT::RNTupleDescriptor::fVersionPatch = 0

private

Set by the descriptor builder when deserialized.

Definition at line 742 of file RNTupleDescriptor.hxx.

Libraries for ROOT::RNTupleDescriptor:

[legend]

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

tree/ntuple/inc/ROOT/RNTupleDescriptor.hxx
tree/ntuple/src/RNTupleDescriptor.cxx
tree/ntuple/src/RNTupleDescriptorFmt.cxx

Classes

Public Types

Public Member Functions

Private Member Functions

Private Attributes

Friends

Member Enumeration Documentation

◆ EFeatureFlags

Constructor & Destructor Documentation

◆ RNTupleDescriptor() [1/3]

◆ RNTupleDescriptor() [2/3]

◆ RNTupleDescriptor() [3/3]

Member Function Documentation

◆ AddClusterGroupDetails()

◆ Clone()

◆ CloneSchema()

◆ CreateModel()

◆ DropClusterGroupDetails()

◆ FieldTypeNamesMayNeedFixup()

◆ FindClusterId()

◆ FindFieldId() [1/2]

◆ FindFieldId() [2/2]

◆ FindLogicalColumnId()

◆ FindPhysicalColumnId()

◆ GetActiveClusterIterable()

◆ GetAttrSetIterable()

◆ GetClusterDescriptor()

◆ GetClusterGroupDescriptor()

◆ GetClusterGroupIterable()

◆ GetColumnDescriptor()

◆ GetColumnIterable() [1/3]

◆ GetColumnIterable() [2/3]

◆ GetColumnIterable() [3/3]

◆ GetDescription()

◆ GetExtraTypeInfoIterable()

◆ GetFeatureFlags()

◆ GetFieldDescriptor()

◆ GetFieldIterable() [1/4]

◆ GetFieldIterable() [2/4]

◆ GetFieldIterable() [3/4]

◆ GetFieldIterable() [4/4]

◆ GetFieldZero()

◆ GetFieldZeroId()

◆ GetGeneration()

◆ GetHeaderExtension()

◆ GetNActiveClusters()

◆ GetName()

◆ GetNAttributeSets()

◆ GetNClusterGroups()

◆ GetNClusters()

◆ GetNEntries()

◆ GetNExtraTypeInfos()

◆ GetNFields()

◆ GetNLogicalColumns()

◆ GetNPhysicalColumns()

◆ GetOnDiskFooterSize()

◆ GetOnDiskHeaderSize()

◆ GetOnDiskHeaderXxHash3()

◆ GetQualifiedFieldName()

◆ GetTopLevelFields() [1/2]

◆ GetTopLevelFields() [2/2]

◆ GetTypeNameForComparison()

◆ GetVersion()

◆ HasFeature()

◆ IncGeneration()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ PrintInfo()

◆ R__DEPRECATED()

Friends And Related Symbol Documentation

◆ Experimental::RNTupleAttrSetDescriptorIterable

◆ Internal::CloneDescriptorSchema

◆ Internal::RNTupleDescriptorBuilder

Member Data Documentation

◆ fAttributeSets

◆ fClusterDescriptors

◆ fClusterGroupDescriptors

◆ fColumnDescriptors

◆ fDescription