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::vector<std::string> linkTargetNames;
97
100
102 std::vector<unsigned> fixedDimensions;
103 };
104
105
106
113
115 {
118 public:
119
121 static constexpr std::size_t nullIndex = 0u;
122
124 static constexpr std::size_t sizeIndex = 1u;
125
127 static constexpr std::size_t unsetIndex = static_cast<std::size_t>(-1);
128
130 static constexpr std::size_t numFixedColumns = 2u;
131
134
135
137 [[nodiscard]] std::size_t addColumn (const ColumnInfo& columnInfo);
138
140 void setOffsetColumn (std::size_t columnIndex, std::size_t offsetIndex);
141
142
144 [[nodiscard]] std::size_t numColumns () const noexcept {
145 return m_elements.size(); }
146
148 [[nodiscard]] const ColumnVectorElementHeader&
149 getColumn (std::size_t index) const {
150 return m_elements.at (index); }
151
153 [[nodiscard]] std::size_t
154 getColumnIndex (const std::string& name) const noexcept {
155 auto iter = m_nameToIndex.find(name);
156 return (iter != m_nameToIndex.end()) ? iter->second : nullIndex; }
157
159 [[nodiscard]] std::unordered_map<std::string, ColumnInfo> getAllColumnInfo() const;
160
161
163 void checkSelf () const;
164
166 void checkData (std::span<const void*const> data) const;
167
168
171 private:
172
174 std::vector<ColumnVectorElementHeader> m_elements;
175
177 std::unordered_map<std::string, std::size_t> m_nameToIndex;
178 };
179
180
181
186
188 {
191 public:
192
194 explicit ColumnVectorData (const ColumnVectorHeader *val_header);
195
196
198 template<typename CT>
199 void setColumn (std::size_t columnIndex, std::size_t size, CT* dataPtr) {
200 auto voidPtr = reinterpret_cast<const void*>(const_cast<const CT*>(dataPtr));
201 setColumnVoid (columnIndex, size, voidPtr, typeid (std::decay_t<CT>), std::is_const_v<CT>);
202 }
203 void setColumnVoid (std::size_t columnIndex, std::size_t size, const void *dataPtr, const std::type_info& type, bool isConst);
204
205
207 template<typename CT>
208 [[nodiscard]] std::pair<std::size_t,CT*>
209 getColumn (std::size_t columnIndex)
210 {
211 auto [size, ptr] = getColumnVoid (columnIndex, &typeid (std::decay_t<CT>), std::is_const_v<CT>);
212 if constexpr (std::is_const_v<CT>)
213 return std::make_pair (size, static_cast<CT*>(ptr));
214 else
215 return std::make_pair (size, static_cast<CT*>(const_cast<void*>(ptr)));
216 }
217 [[nodiscard]] std::pair<std::size_t,const void*>
218 getColumnVoid (std::size_t columnIndex, const std::type_info *type, bool isConst);
219
220
222 void checkData () const {
223 m_header->checkData (m_data);
224 }
225
228 void callNoCheck (const IColumnarTool& tool);
229
230
233 private:
234
235 const ColumnVectorHeader *m_header = nullptr;
236 std::vector<void*> m_data;
237 std::vector<std::size_t> m_dataSize;
238 };
239}
240
241#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)
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 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 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)
std::vector< std::string > linkTargetNames
for link columns: the target container names
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::string variantLinkKeyColumn
if this is a variant link column, the name of the key column