ATLAS Offline Software
Loading...
Searching...
No Matches
ColumnVectorWrapper.h
Go to the documentation of this file.
1/*
2 Copyright (C) 2002-2025 CERN for the benefit of the ATLAS collaboration
3*/
4
6
7
8#ifndef COLUMNAR_TOOL_WRAPPER_COLUMN_VECTOR_WRAPPER_H
9#define COLUMNAR_TOOL_WRAPPER_COLUMN_VECTOR_WRAPPER_H
10
12
13#include <span>
14#include <string>
15#include <typeinfo>
16#include <unordered_map>
17#include <vector>
18
19namespace columnar
20{
21 class IColumnarTool;
22
23
30
32 {
44 std::string debugName;
45
46
48 const std::type_info *type = nullptr;
49
50
52 bool isOptional = true;
53
54
59 bool readOnly = true;
60
61
69 bool isOffset = false;
70
71
77 unsigned arraySize = 1u;
78
79
86 std::size_t offsetIndex = 0u;
87
88
91
93 std::string offsetName;
94
96 std::string soleLinkTargetName;
97
99 bool isVariantLink = false;
100
102 std::vector<std::string> variantLinkTargetNames;
103
106
108 std::vector<unsigned> fixedDimensions;
109 };
110
111
112
119
121 {
124 public:
125
127 static constexpr std::size_t nullIndex = 0u;
128
130 static constexpr std::size_t sizeIndex = 1u;
131
133 static constexpr std::size_t unsetIndex = static_cast<std::size_t>(-1);
134
136 static constexpr std::size_t numFixedColumns = 2u;
137
140
141
143 [[nodiscard]] std::size_t addColumn (const ColumnInfo& columnInfo);
144
146 void setOffsetColumn (std::size_t columnIndex, std::size_t offsetIndex);
147
148
150 [[nodiscard]] std::size_t numColumns () const noexcept {
151 return m_elements.size(); }
152
154 [[nodiscard]] const ColumnVectorElementHeader&
155 getColumn (std::size_t index) const {
156 return m_elements.at (index); }
157
159 [[nodiscard]] std::size_t
160 getColumnIndex (const std::string& name) const noexcept {
161 auto iter = m_nameToIndex.find(name);
162 return (iter != m_nameToIndex.end()) ? iter->second : nullIndex; }
163
165 [[nodiscard]] std::unordered_map<std::string, ColumnInfo> getAllColumnInfo() const;
166
167
169 void checkSelf () const;
170
172 void checkData (std::span<const void*const> data) const;
173
174
177 private:
178
180 std::vector<ColumnVectorElementHeader> m_elements;
181
183 std::unordered_map<std::string, std::size_t> m_nameToIndex;
184 };
185
186
187
192
194 {
197 public:
198
200 explicit ColumnVectorData (const ColumnVectorHeader *val_header);
201
202
204 template<typename CT>
205 void setColumn (std::size_t columnIndex, std::size_t size, CT* dataPtr) {
206 auto voidPtr = reinterpret_cast<const void*>(const_cast<const CT*>(dataPtr));
207 setColumnVoid (columnIndex, size, voidPtr, typeid (std::decay_t<CT>), std::is_const_v<CT>);
208 }
209 void setColumnVoid (std::size_t columnIndex, std::size_t size, const void *dataPtr, const std::type_info& type, bool isConst);
210
211
213 template<typename CT>
214 [[nodiscard]] std::pair<std::size_t,CT*>
215 getColumn (std::size_t columnIndex)
216 {
217 auto [size, ptr] = getColumnVoid (columnIndex, &typeid (std::decay_t<CT>), std::is_const_v<CT>);
218 if constexpr (std::is_const_v<CT>)
219 return std::make_pair (size, static_cast<CT*>(ptr));
220 else
221 return std::make_pair (size, static_cast<CT*>(const_cast<void*>(ptr)));
222 }
223 [[nodiscard]] std::pair<std::size_t,const void*>
224 getColumnVoid (std::size_t columnIndex, const std::type_info *type, bool isConst) const;
225
226
228 void checkData () const {
229 m_header->checkData (m_data);
230 }
231
234 void callNoCheck (const IColumnarTool& tool);
235
236
239 private:
240
241 const ColumnVectorHeader *m_header = nullptr;
242 std::vector<void*> m_data;
243 std::vector<std::size_t> m_dataSize;
244 };
245}
246
247#endif
char data[hepevt_bytes_allocation_ATLAS]
Definition HepEvt.cxx:11
std::pair< std::size_t, const void * > getColumnVoid(std::size_t columnIndex, const std::type_info *type, bool isConst) const
void setColumnVoid(std::size_t columnIndex, std::size_t size, const void *dataPtr, const std::type_info &type, bool isConst)
const ColumnVectorHeader * m_header
void checkData() const
do a basic check of the data vector
void callNoCheck(const IColumnarTool &tool)
call the tool with the assembled data, without performing any checks on the data
void setColumn(std::size_t columnIndex, std::size_t size, CT *dataPtr)
set the data for the given column
std::pair< std::size_t, CT * > getColumn(std::size_t columnIndex)
get the data for the given column
std::vector< std::size_t > m_dataSize
ColumnVectorData(const ColumnVectorHeader *val_header)
standard constructor
the header information for the entire columnar data vector
std::size_t addColumn(const ColumnInfo &columnInfo)
add a column for the given ColumnInfo, returning its index
void setOffsetColumn(std::size_t columnIndex, std::size_t offsetIndex)
set the index of the offset column for the given column
static constexpr std::size_t nullIndex
the index used for an invalid index (always has to be 0)
void checkData(std::span< const void *const > data) const
do a basic check of the data vector
static constexpr std::size_t numFixedColumns
the number of fix elements in the columnar data vector
void checkSelf() const
check the self-consistency of the header
std::unordered_map< std::string, std::size_t > m_nameToIndex
map from column name to index for deduplication
static constexpr std::size_t unsetIndex
the number used for an unset but non-null index
std::size_t getColumnIndex(const std::string &name) const noexcept
get the column index for the given name, or nullIndex if not found
std::vector< ColumnVectorElementHeader > m_elements
the elements in the columnar data vector
std::size_t numColumns() const noexcept
the number of columns in the columnar data vector
const ColumnVectorElementHeader & getColumn(std::size_t index) const
get the column for the given index
ColumnVectorHeader()
standard contructor
std::unordered_map< std::string, ColumnInfo > getAllColumnInfo() const
get all columns as a map of ColumnInfo for use with IColumnData::connect
static constexpr std::size_t sizeIndex
the index used for the column size column
an interface for tools that operate on columnar data
ColumnAccessMode
an enum for the different access modes for a column
Definition ColumnInfo.h:19
@ input
an input column
Definition ColumnInfo.h:21
Definition index.py:1
a struct that contains meta-information about each column that's needed to interface the column with ...
Definition ColumnInfo.h:35
the header information for a single element in the columnar data vector
std::vector< unsigned > fixedDimensions
the fixed dimensions (if any)
bool isVariantLink
whether this is a variant link column
std::string soleLinkTargetName
for simple link columns: the target container name
bool isOffset
whether this is an offset column
unsigned arraySize
the total size of all inner array dimensions
bool readOnly
whether this column will only be used for read access
ColumnAccessMode accessMode
the access mode for the column
std::string keyColumnForVariantLink
if this is a key column for a variant link, the name of the link column
std::string offsetName
the name of the offset column (or empty for none)
std::size_t offsetIndex
the index of the offset column (or nullIndex for none)
const std::type_info * type
the type to use for the column
bool isOptional
whether this column is optional
std::string debugName
the name of the column to use in messages
std::vector< std::string > variantLinkTargetNames
for variant link key columns: the target container names