An RNTuple that is used to read data from storage.

An input ntuple provides data from storage as C++ objects. The ntuple model can be created from the data on storage or it can be imposed by the user. The latter case allows users to read into a specialized ntuple model that covers only a subset of the fields in the ntuple. The ntuple model is used when reading complete entries. Individual fields can be read as well by instantiating a tree view.

Definition at line 73 of file RNTuple.hxx.

Classes
class	RIterator

Public Member Functions
	RNTupleReader (std::unique_ptr< Detail::RPageSource > source)
	The model is generated from the ntuple metadata on storage. More...

	RNTupleReader (std::unique_ptr< RNTupleModel > model, std::unique_ptr< Detail::RPageSource > source)
	The user imposes an ntuple model, which must be compatible with the model found in the data on storage. More...

	~RNTupleReader ()

RIterator	begin ()

std::unique_ptr< RNTupleReader >	Clone ()

void	EnableMetrics ()

RIterator	end ()

const RNTupleDescriptor &	GetDescriptor () const

RNTupleGlobalRange	GetEntryRange ()

RNTupleModel *	GetModel ()

NTupleSize_t	GetNEntries () const

template<typename T >
RNTupleView< T >	GetView (std::string_view fieldName)
	Provides access to an individual field that can contain either a scalar value or a collection, e.g. More...

RNTupleViewCollection	GetViewCollection (std::string_view fieldName)

void	LoadEntry (NTupleSize_t index)
	Analogous to Fill(), fills the default entry of the model. More...

void	LoadEntry (NTupleSize_t index, REntry *entry)
	Fills a user provided entry after checking that the entry has been instantiated from the ntuple model. More...

void	PrintInfo (const ENTupleInfo what=ENTupleInfo::kSummary, std::ostream &output=std::cout)
	Prints a detailed summary of the ntuple, including a list of fields. More...

void	Show (NTupleSize_t index, const ENTupleFormat format=ENTupleFormat::kJSON, std::ostream &output=std::cout)
	Shows the values of the i-th entry/row, starting with 0 for the first entry. More...

Static Public Member Functions
static std::unique_ptr< RNTupleReader >	Open (std::string_view ntupleName, std::string_view storage)

static std::unique_ptr< RNTupleReader >	Open (std::unique_ptr< RNTupleModel > model, std::string_view ntupleName, std::string_view storage)

Private Member Functions
void	ConnectModel ()

Private Attributes
Detail::RNTupleMetrics	fMetrics

std::unique_ptr< RNTupleModel >	fModel
	Needs to be destructed before fSource. More...

std::unique_ptr< Detail::RPageSource >	fSource

#include <ROOT/RNTuple.hxx>

Constructor & Destructor Documentation

◆ RNTupleReader() [1/2]

ROOT::Experimental::RNTupleReader::RNTupleReader	(	std::unique_ptr< RNTupleModel >	model,
		std::unique_ptr< Detail::RPageSource >	source
	)

The user imposes an ntuple model, which must be compatible with the model found in the data on storage.

Definition at line 46 of file RNTuple.cxx.

◆ RNTupleReader() [2/2]

ROOT::Experimental::RNTupleReader::RNTupleReader ( std::unique_ptr< Detail::RPageSource > source )

explicit

The model is generated from the ntuple metadata on storage.

Definition at line 58 of file RNTuple.cxx.

◆ ~RNTupleReader()

ROOT::Experimental::RNTupleReader::~RNTupleReader ( )

Definition at line 69 of file RNTuple.cxx.

Member Function Documentation

◆ begin()

RIterator ROOT::Experimental::RNTupleReader::begin ( )

inline

Definition at line 151 of file RNTuple.hxx.

◆ Clone()

std::unique_ptr< RNTupleReader > ROOT::Experimental::RNTupleReader::Clone ( )

inline

Definition at line 111 of file RNTuple.hxx.

◆ ConnectModel()

void ROOT::Experimental::RNTupleReader::ConnectModel ( )

private

Definition at line 34 of file RNTuple.cxx.

◆ EnableMetrics()

void ROOT::Experimental::RNTupleReader::EnableMetrics ( )

inline

Definition at line 154 of file RNTuple.hxx.

◆ end()

RIterator ROOT::Experimental::RNTupleReader::end ( )

inline

Definition at line 152 of file RNTuple.hxx.

◆ GetDescriptor()

const RNTupleDescriptor & ROOT::Experimental::RNTupleReader::GetDescriptor ( ) const

inline

Definition at line 116 of file RNTuple.hxx.

◆ GetEntryRange()

RNTupleGlobalRange ROOT::Experimental::RNTupleReader::GetEntryRange ( )

inline

Definition at line 136 of file RNTuple.hxx.

◆ GetModel()

RNTupleModel * ROOT::Experimental::RNTupleReader::GetModel ( )

inline

Definition at line 114 of file RNTuple.hxx.

◆ GetNEntries()

NTupleSize_t ROOT::Experimental::RNTupleReader::GetNEntries ( ) const

inline

Definition at line 115 of file RNTuple.hxx.

◆ GetView()

template<typename T >

RNTupleView< T > ROOT::Experimental::RNTupleReader::GetView ( std::string_view fieldName )

inline

Provides access to an individual field that can contain either a scalar value or a collection, e.g.

GetView<double>("particles.pt") or GetView<std::vector<double>>("particle"). It can as well be the index field of a collection itself, like GetView<NTupleSize_t>("particle")

Definition at line 142 of file RNTuple.hxx.

◆ GetViewCollection()

RNTupleViewCollection ROOT::Experimental::RNTupleReader::GetViewCollection ( std::string_view fieldName )

inline

Definition at line 146 of file RNTuple.hxx.

◆ LoadEntry() [1/2]

void ROOT::Experimental::RNTupleReader::LoadEntry ( NTupleSize_t index )

inline

Analogous to Fill(), fills the default entry of the model.

Returns false at the end of the ntuple. On I/O errors, raises an expection.

Definition at line 128 of file RNTuple.hxx.

◆ LoadEntry() [2/2]

void ROOT::Experimental::RNTupleReader::LoadEntry	(	NTupleSize_t	index,
		REntry *	entry
	)

inline

Fills a user provided entry after checking that the entry has been instantiated from the ntuple model.

Definition at line 130 of file RNTuple.hxx.

◆ Open() [1/2]

std::unique_ptr< ROOT::Experimental::RNTupleReader > ROOT::Experimental::RNTupleReader::Open	(	std::string_view	ntupleName,
		std::string_view	storage
	)

static

Definition at line 81 of file RNTuple.cxx.

◆ Open() [2/2]

std::unique_ptr< ROOT::Experimental::RNTupleReader > ROOT::Experimental::RNTupleReader::Open	(	std::unique_ptr< RNTupleModel >	model,
		std::string_view	ntupleName,
		std::string_view	storage
	)

static

Definition at line 73 of file RNTuple.cxx.

◆ PrintInfo()

void ROOT::Experimental::RNTupleReader::PrintInfo	(	const ENTupleInfo	what = `ENTupleInfo::kSummary`,
		std::ostream &	output = `std::cout`
	)

Prints a detailed summary of the ntuple, including a list of fields.

Definition at line 88 of file RNTuple.cxx.

◆ Show()

void ROOT::Experimental::RNTupleReader::Show	(	NTupleSize_t	index,
		const ENTupleFormat	format = `ENTupleFormat::kJSON`,
		std::ostream &	output = `std::cout`
	)

Shows the values of the i-th entry/row, starting with 0 for the first entry.

By default, prints the output in JSON format. Uses the visitor pattern to traverse through each field of the given entry.

Definition at line 143 of file RNTuple.cxx.

Member Data Documentation

◆ fMetrics

Detail::RNTupleMetrics ROOT::Experimental::RNTupleReader::fMetrics

private

Definition at line 78 of file RNTuple.hxx.

◆ fModel

std::unique_ptr<RNTupleModel> ROOT::Experimental::RNTupleReader::fModel

private

Needs to be destructed before fSource.

Definition at line 77 of file RNTuple.hxx.

◆ fSource

std::unique_ptr<Detail::RPageSource> ROOT::Experimental::RNTupleReader::fSource

private

Definition at line 75 of file RNTuple.hxx.

Libraries for ROOT::Experimental::RNTupleReader:

[legend]

Classes

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Constructor & Destructor Documentation

◆ RNTupleReader() [1/2]

◆ RNTupleReader() [2/2]

◆ ~RNTupleReader()

Member Function Documentation

◆ begin()

◆ Clone()

◆ ConnectModel()

◆ EnableMetrics()

◆ end()

◆ GetDescriptor()

◆ GetEntryRange()

◆ GetModel()

◆ GetNEntries()

◆ GetView()

◆ GetViewCollection()

◆ LoadEntry() [1/2]

◆ LoadEntry() [2/2]

◆ Open() [1/2]

◆ Open() [2/2]

◆ PrintInfo()

◆ Show()

Member Data Documentation

◆ fMetrics

◆ fModel

◆ fSource