A column is a storage-backed array of a simple, fixed-size type, from which pages can be mapped into memory.
Definition at line 40 of file RColumn.hxx.
Static Public Member Functions | |
template<typename CppT > | |
static std::unique_ptr< RColumn > | Create (ROOT::ENTupleColumnType type, std::uint32_t columnIdx, std::uint16_t representationIdx) |
Private Member Functions | |
RColumn (ROOT::ENTupleColumnType type, std::uint32_t columnIndex, std::uint16_t representationIndex) | |
void | HandleWritePageIfFull () |
Used when trying to append to a full write page. | |
Private Attributes | |
std::unique_ptr< ROOT::Internal::RColumnElementBase > | fElement |
Used to pack and unpack pages on writing/reading. | |
ROOT::NTupleSize_t | fFirstElementIndex = 0 |
Global index of the first element in this column; usually == 0, unless it is a deferred column. | |
ROOT::Experimental::Internal::RPageStorage::ColumnHandle_t | fHandleSink |
ROOT::Experimental::Internal::RPageStorage::ColumnHandle_t | fHandleSource |
std::uint32_t | fIndex |
Columns belonging to the same field are distinguished by their order. | |
ROOT::NTupleSize_t | fInitialNElements = 1 |
The initial number of elements in a page. | |
std::size_t | fLastGoodTeamIdx = 0 |
Points into fTeam to the column that successfully returned the last page. | |
ROOT::NTupleSize_t | fNElements = 0 |
The number of elements written resp. available in the column. | |
ROOT::DescriptorId_t | fOnDiskId = ROOT::kInvalidDescriptorId |
The column id in the column descriptor, once connected to a sink or source. | |
ROOT::Experimental::Internal::RPageSink * | fPageSink = nullptr |
ROOT::Experimental::Internal::RPageSource * | fPageSource = nullptr |
ROOT::Internal::RPageRef | fReadPageRef |
The currently mapped page for reading. | |
std::uint16_t | fRepresentationIndex |
Fields can have multiple column representations, distinguished by representation index. | |
std::vector< RColumn * > | fTeam |
The column team is a set of columns that serve the same column index for different representation IDs. | |
ROOT::ENTupleColumnType | fType |
ROOT::Internal::RPage | fWritePage |
The page into which new elements are being written. | |
#include <ROOT/RColumn.hxx>
|
private |
ROOT::Internal::RColumn::~RColumn | ( | ) |
Definition at line 34 of file RColumn.cxx.
|
inline |
Definition at line 128 of file RColumn.hxx.
|
inline |
Definition at line 140 of file RColumn.hxx.
void ROOT::Internal::RColumn::CommitSuppressed | ( | ) |
Definition at line 82 of file RColumn.cxx.
void ROOT::Internal::RColumn::ConnectPageSink | ( | ROOT::DescriptorId_t | fieldId, |
ROOT::Experimental::Internal::RPageSink & | pageSink, | ||
ROOT::NTupleSize_t | firstElementIndex = 0U ) |
Connect the column to a page sink.
firstElementIndex
can be used to specify the first column element index with backing storage for this column. On read back, elements before firstElementIndex
will cause the zero page to be mapped.
Definition at line 42 of file RColumn.cxx.
void ROOT::Internal::RColumn::ConnectPageSource | ( | ROOT::DescriptorId_t | fieldId, |
ROOT::Experimental::Internal::RPageSource & | pageSource ) |
Connect the column to a page source.
Definition at line 59 of file RColumn.cxx.
|
inlinestatic |
Definition at line 109 of file RColumn.hxx.
void ROOT::Internal::RColumn::Flush | ( | ) |
Definition at line 71 of file RColumn.cxx.
|
inline |
Definition at line 343 of file RColumn.hxx.
|
inline |
Definition at line 275 of file RColumn.hxx.
|
inline |
For offset columns only, look at the two adjacent values that define a collection's coordinates.
Definition at line 285 of file RColumn.hxx.
|
inline |
Definition at line 309 of file RColumn.hxx.
|
inline |
Definition at line 341 of file RColumn.hxx.
|
inline |
Definition at line 356 of file RColumn.hxx.
|
inline |
Definition at line 267 of file RColumn.hxx.
|
inline |
Definition at line 360 of file RColumn.hxx.
|
inline |
Definition at line 359 of file RColumn.hxx.
|
inline |
Definition at line 353 of file RColumn.hxx.
|
inline |
Definition at line 340 of file RColumn.hxx.
|
inline |
Definition at line 355 of file RColumn.hxx.
|
inline |
Definition at line 358 of file RColumn.hxx.
|
inline |
Definition at line 357 of file RColumn.hxx.
|
inline |
Definition at line 354 of file RColumn.hxx.
|
inline |
Get the currently active cluster id.
Definition at line 320 of file RColumn.hxx.
|
inline |
Definition at line 342 of file RColumn.hxx.
|
inline |
Definition at line 348 of file RColumn.hxx.
|
inline |
Definition at line 363 of file RColumn.hxx.
|
inlineprivate |
Used when trying to append to a full write page.
If possible, expand the page. Otherwise, flush and reset to the minimal size.
Definition at line 81 of file RColumn.hxx.
|
inline |
Definition at line 229 of file RColumn.hxx.
|
inline |
Definition at line 236 of file RColumn.hxx.
|
inline |
Definition at line 331 of file RColumn.hxx.
|
inline |
Definition at line 330 of file RColumn.hxx.
|
inline |
Definition at line 243 of file RColumn.hxx.
|
inline |
Definition at line 255 of file RColumn.hxx.
void ROOT::Internal::RColumn::MergeTeams | ( | RColumn & | other | ) |
Definition at line 117 of file RColumn.cxx.
|
inline |
Definition at line 162 of file RColumn.hxx.
|
inline |
Definition at line 173 of file RColumn.hxx.
|
inline |
Definition at line 336 of file RColumn.hxx.
|
inline |
Definition at line 335 of file RColumn.hxx.
|
inline |
Definition at line 206 of file RColumn.hxx.
|
inline |
Definition at line 184 of file RColumn.hxx.
|
inline |
Definition at line 362 of file RColumn.hxx.
Definition at line 364 of file RColumn.hxx.
bool ROOT::Internal::RColumn::TryMapPage | ( | RNTupleLocalIndex | localIndex | ) |
Definition at line 102 of file RColumn.cxx.
bool ROOT::Internal::RColumn::TryMapPage | ( | ROOT::NTupleSize_t | globalIndex | ) |
Definition at line 87 of file RColumn.cxx.
|
private |
Used to pack and unpack pages on writing/reading.
Definition at line 68 of file RColumn.hxx.
|
private |
Global index of the first element in this column; usually == 0, unless it is a deferred column.
Definition at line 66 of file RColumn.hxx.
|
private |
Definition at line 50 of file RColumn.hxx.
|
private |
Definition at line 51 of file RColumn.hxx.
|
private |
Columns belonging to the same field are distinguished by their order.
E.g. for an std::string field, there is the offset column with index 0 and the character value column with index 1.
Definition at line 45 of file RColumn.hxx.
|
private |
The initial number of elements in a page.
Definition at line 58 of file RColumn.hxx.
|
private |
Points into fTeam to the column that successfully returned the last page.
Definition at line 75 of file RColumn.hxx.
|
private |
The number of elements written resp. available in the column.
Definition at line 60 of file RColumn.hxx.
|
private |
The column id in the column descriptor, once connected to a sink or source.
Definition at line 64 of file RColumn.hxx.
|
private |
Definition at line 48 of file RColumn.hxx.
|
private |
Definition at line 49 of file RColumn.hxx.
|
private |
The currently mapped page for reading.
Definition at line 62 of file RColumn.hxx.
|
private |
Fields can have multiple column representations, distinguished by representation index.
Definition at line 47 of file RColumn.hxx.
|
private |
The column team is a set of columns that serve the same column index for different representation IDs.
Initially, the team has only one member, the very column it belongs to. Through MergeTeams(), two columns can join forces. The team is used to react on suppressed columns: if the current team member has a suppressed column for a MapPage() call, it get the page from the active column in the corresponding cluster.
Definition at line 73 of file RColumn.hxx.
|
private |
Definition at line 42 of file RColumn.hxx.
|
private |
The page into which new elements are being written.
The page will initially be small (RNTupleWriteOptions::fInitialUnzippedPageSize, which corresponds to fInitialElements) and expand as needed and as memory for page buffers is still available (RNTupleWriteOptions::fPageBufferBudget) or the maximum page size is reached (RNTupleWriteOptions::fMaxUnzippedPageSize).
Definition at line 56 of file RColumn.hxx.