CoDiPack  3.1.0
A Code Differentiation Package
SciComp TU Kaiserslautern
Loading...
Searching...
No Matches
indexManagerInterface.hpp
1/*
2 * CoDiPack, a Code Differentiation Package
3 *
4 * Copyright (C) 2015-2026 Chair for Scientific Computing (SciComp), University of Kaiserslautern-Landau
5 * Homepage: http://scicomp.rptu.de
6 * Contact: Prof. Nicolas R. Gauger (codi@scicomp.uni-kl.de)
7 *
8 * Lead developers: Max Sagebaum, Johannes Blühdorn (SciComp, University of Kaiserslautern-Landau)
9 *
10 * This file is part of CoDiPack (http://scicomp.rptu.de/software/codi).
11 *
12 * CoDiPack is free software: you can redistribute it and/or
13 * modify it under the terms of the GNU General Public License
14 * as published by the Free Software Foundation, either version 3 of the
15 * License, or (at your option) any later version.
16 *
17 * CoDiPack is distributed in the hope that it will be useful,
18 * but WITHOUT ANY WARRANTY; without even the implied warranty
19 * of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
20 *
21 * See the GNU General Public License for more details.
22 * You should have received a copy of the GNU
23 * General Public License along with CoDiPack.
24 * If not, see <http://www.gnu.org/licenses/>.
25 *
26 * For other licensing options please contact us.
27 *
28 * Authors:
29 * - SciComp, University of Kaiserslautern-Landau:
30 * - Max Sagebaum
31 * - Johannes Blühdorn
32 * - Former members:
33 * - Tim Albring
34 */
35#pragma once
36
37#include <vector>
38
39#include "../../config.h"
40#include "../../misc/macros.hpp"
41#include "../misc/tapeValues.hpp"
42
44namespace codi {
45
77 template<typename T_Index>
79 public:
80
81 using Index = CODI_DD(T_Index, int);
82 using ActiveTypeIndexData = CODI_DD(T_Index, int);
83
84 /*******************************************************************************/
86
87 static Index constexpr InactiveIndex = Index(0);
88 static Index constexpr InvalidIndex =
89 Index(-1);
90
91 /*******************************************************************************/
93
94 static bool constexpr CopyNeedsStatement =
96 static bool constexpr IsLinear =
98
101
103
106 template<typename Tape>
108
111
114 template<typename Tape>
116
117 template<typename Tape>
119 ActiveTypeIndexData const& rhs);
120
121 template<typename Tape>
124
125 void reset();
126
127 Index const& getIndex(ActiveTypeIndexData const& data);
129
130 void validateRhsIndex(ActiveTypeIndexData const& data) const;
131
132 /*******************************************************************************/
134
139 void addToTapeValues(TapeValues& values) const;
140
147 };
148
149 // clang-format off
151 template<typename Index>
153
155 template<typename Index>
157 // clang-format on
158}
#define CODI_DD(Type, Default)
Abbreviation for CODI_DECLARE_DEFAULT.
Definition macros.hpp:97
#define CODI_UNDEFINED_VALUE
Used in interface declarations for variables that have to be defined in the specializations.
Definition macros.hpp:123
CoDiPack - Code Differentiation Package.
Definition codi.hpp:97
Indices enable the mapping of primal values to their adjoint counterparts.
Definition indexManagerInterface.hpp:78
void initIndex(ActiveTypeIndexData &index)
Initialize the index data. Usually zero everything.
Index & getIndex(ActiveTypeIndexData &data)
Extract index from data stored in active type.
void updateLargestCreatedIndex(ActiveTypeIndexData const &index)
Update the largest generated index.
void freeIndex(ActiveTypeIndexData &index)
void reset()
Reset for a new recording.
static Index constexpr InactiveIndex
Definition indexManagerInterface.hpp:87
static Index constexpr InvalidIndex
Definition indexManagerInterface.hpp:88
T_Index ActiveTypeIndexData
Index data stored in the active type. Can be arbitrary.
Definition indexManagerInterface.hpp:82
T_Index Index
See IndexManagerInterface.
Definition indexManagerInterface.hpp:81
bool assignIndex(ActiveTypeIndexData &index)
Call on assignment of a primal value, e.g. on w for w = a + b.
void copyIndex(ActiveTypeIndexData &lhs, ActiveTypeIndexData const &rhs)
Call on copy of a primal value, e.g. w = a.
static bool constexpr NeedsStaticStorage
Definition indexManagerInterface.hpp:100
bool assignUnusedIndex(ActiveTypeIndexData &index)
Call on registering input values.
Index const & getIndex(ActiveTypeIndexData const &data)
Extract index from data stored in active type.
static bool constexpr CopyNeedsStatement
Definition indexManagerInterface.hpp:94
static bool constexpr IsLinear
Definition indexManagerInterface.hpp:96
void addToTapeValues(TapeValues &values) const
Add storage and other information to the tape values.
Index getLargestCreatedIndex() const
Returns the largest created index.
void validateRhsIndex(ActiveTypeIndexData const &data) const
Check if the rhs index is valid.
Tape information that can be printed in a pretty print format or a table format.
Definition tapeValues.hpp:75