Tpetra parallel linear algebra  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Tpetra_Vector_def.hpp
Go to the documentation of this file.
1 // @HEADER
2 // *****************************************************************************
3 // Tpetra: Templated Linear Algebra Services Package
4 //
5 // Copyright 2008 NTESS and the Tpetra contributors.
6 // SPDX-License-Identifier: BSD-3-Clause
7 // *****************************************************************************
8 // @HEADER
9 
10 #ifndef TPETRA_VECTOR_DEF_HPP
11 #define TPETRA_VECTOR_DEF_HPP
12 
15 
16 #include "Tpetra_MultiVector.hpp"
17 #include "Tpetra_Details_gathervPrint.hpp"
18 #include "KokkosCompat_View.hpp"
19 #include "KokkosBlas1_nrm2w_squared.hpp"
20 #include "Teuchos_CommHelpers.hpp"
21 
22 namespace Tpetra {
23 
24 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
25 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
26  Vector()
27  : base_type() {}
28 
29 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
30 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
31  Vector(const Teuchos::RCP<const map_type>& map,
32  const bool zeroOut)
33  : base_type(map, 1, zeroOut) {}
34 
35 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
36 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
37  Vector(const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& source,
38  const Teuchos::DataAccess copyOrView)
39  : base_type(source, copyOrView) {}
40 
41 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
42 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
43  Vector(const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& source,
44  const Teuchos::RCP<const map_type>& map,
45  const local_ordinal_type rowOffset)
46  : base_type(source, map, rowOffset) {}
47 
48 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
49 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
50  Vector(const Teuchos::RCP<const map_type>& map,
51  const Teuchos::ArrayView<const Scalar>& values)
52  : base_type(map, values, values.size(), 1) {}
53 
54 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
55 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
56  Vector(const Teuchos::RCP<const map_type>& map,
57  const dual_view_type& view)
58  : base_type(map, view) {}
59 
60 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
61 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
62  Vector(const Teuchos::RCP<const map_type>& map,
63  const dual_view_type& view,
64  const dual_view_type& origView)
65  : base_type(map, view, origView) {}
66 
67 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
68 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
69  Vector(const Teuchos::RCP<const map_type>& map,
70  const wrapped_dual_view_type& view)
71  : base_type(map, view) {}
72 
73 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
74 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
75  Vector(const MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& X,
76  const size_t j)
77  : base_type(X, j) {}
78 
79 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
80 void Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
81  replaceGlobalValue(const GlobalOrdinal globalRow, const Scalar& value) {
82  this->base_type::replaceGlobalValue(globalRow, 0, value);
83 }
84 
85 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
86 void Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
87  sumIntoGlobalValue(const GlobalOrdinal globalRow,
88  const Scalar& value,
89  const bool atomic) {
90  this->base_type::sumIntoGlobalValue(globalRow, 0, value, atomic);
91 }
92 
93 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
94 void Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
95  replaceLocalValue(const LocalOrdinal myRow, const Scalar& value) {
96  this->base_type::replaceLocalValue(myRow, 0, value);
97 }
98 
99 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
100 void Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
101  sumIntoLocalValue(const LocalOrdinal globalRow,
102  const Scalar& value,
103  const bool atomic) {
104  this->base_type::sumIntoLocalValue(globalRow, 0, value, atomic);
105 }
106 
107 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
108 void Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
109  get1dCopy(const Teuchos::ArrayView<Scalar>& A) const {
110  const size_t lda = this->getLocalLength();
111  this->get1dCopy(A, lda);
112 }
113 
114 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
115 typename Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::dot_type
116 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
117  dot(const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& y) const {
118  dot_type result;
119  this->dot(y, Teuchos::arrayView(&result, 1));
120  return result;
121 }
122 
123 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
124 Scalar
125 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
126  meanValue() const {
127  Scalar mean;
128  this->meanValue(Teuchos::arrayView(&mean, 1));
129  return mean;
130 }
131 
132 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
133 typename Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::mag_type
134 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
135  norm1() const {
136  mag_type norm;
137  this->norm1(Teuchos::arrayView(&norm, 1));
138  return norm;
139 }
140 
141 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
142 typename Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::mag_type
143 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
144  norm2() const {
145  mag_type norm;
146  this->norm2(Teuchos::arrayView(&norm, 1));
147  return norm;
148 }
149 
150 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
151 typename Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::mag_type
152 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
153  normInf() const {
154  mag_type norm;
155  this->normInf(Teuchos::arrayView(&norm, 1));
156  return norm;
157 }
158 
159 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
160 std::string Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
161  description() const {
162  return this->descriptionImpl("Tpetra::Vector");
163 }
164 
165 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
166 void Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
167  describe(Teuchos::FancyOStream& out,
168  const Teuchos::EVerbosityLevel verbLevel) const {
169  this->describeImpl(out, "Tpetra::Vector", verbLevel);
170 }
171 
172 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
173 Teuchos::RCP<const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> >
174 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
175  offsetView(const Teuchos::RCP<const map_type>& subMap,
176  const size_t offset) const {
177  using Kokkos::ALL;
178  using Kokkos::subview;
179  using Teuchos::rcp;
180  typedef Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> V;
181 
182  const size_t newNumRows = subMap->getLocalNumElements();
183  const bool tooManyElts = newNumRows + offset > this->getOrigNumLocalRows();
184  if (tooManyElts) {
185  const int myRank = this->getMap()->getComm()->getRank();
186  TEUCHOS_TEST_FOR_EXCEPTION(
187  newNumRows + offset > this->getLocalLength(), std::runtime_error,
188  "Tpetra::Vector::offsetView(NonConst): Invalid input Map. The input "
189  "Map owns "
190  << newNumRows << " entries on process " << myRank << ". "
191  "offset = "
192  << offset << ". Yet, the Vector contains only "
193  << this->getOrigNumLocalRows() << " rows on this process.");
194  }
195 
196  // Need 'this->' to get view_ from parent class.
197  return rcp(new V(subMap, wrapped_dual_view_type(this->view_, Kokkos::pair<int, int>(offset, offset + newNumRows), ALL())));
198 }
199 
200 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
201 Teuchos::RCP<Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> >
202 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::
203  offsetViewNonConst(const Teuchos::RCP<const map_type>& subMap,
204  const size_t offset) {
205  typedef Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> V;
206  return Teuchos::rcp_const_cast<V>(this->offsetView(subMap, offset));
207 }
208 
209 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
210 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>
211 createCopy(const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& src) {
212  using vec_type = Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>;
213  // The 2-argument copy constructor with second argument =
214  // Teuchos::Copy does a deep copy of its input.
215  vec_type dst(src, Teuchos::Copy);
216 
217  // The Kokkos refactor version of Vector has view semantics, so
218  // returning the Vector directly, rather than through RCP, only
219  // does a shallow copy.
220  return dst;
221 }
222 
223 } // namespace Tpetra
224 
233 #define TPETRA_VECTOR_INSTANT(SCALAR, LO, GO, NODE) \
234  template class Vector<SCALAR, LO, GO, NODE>; \
235  template Vector<SCALAR, LO, GO, NODE> createCopy(const Vector<SCALAR, LO, GO, NODE>& src);
236 
237 #endif // TPETRA_VECTOR_DEF_HPP
Tpetra::Vector::Vector
Vector()
Default constructor: makes a Vector with no rows or columns.
Definition: Tpetra_Vector_def.hpp:26
Tpetra::Vector::norm2
mag_type norm2() const
Return the two-norm of this Vector.
Definition: Tpetra_Vector_def.hpp:144
Tpetra::Vector::describe
virtual void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel=Teuchos::Describable::verbLevel_default) const
Describe this object in a human-readable way to the given output stream.
Definition: Tpetra_Vector_def.hpp:167
Tpetra::Vector::mag_type
base_type::mag_type mag_type
Type of a norm result.
Definition: Tpetra_Vector_decl.hpp:88
Tpetra_Details_gathervPrint.hpp
Declaration of a function that prints strings from each process.
Tpetra::Vector::get1dCopy
void get1dCopy(const Teuchos::ArrayView< Scalar > &A) const
Return multi-vector values in user-provided two-dimensional array (using Teuchos memory management cl...
Definition: Tpetra_Vector_def.hpp:109
Tpetra::Vector::sumIntoLocalValue
void sumIntoLocalValue(const LocalOrdinal myRow, const Scalar &value, const bool atomic=base_type::useAtomicUpdatesByDefault)
Add value to existing value, using local (row) index.
Definition: Tpetra_Vector_def.hpp:101
Tpetra::Vector::description
virtual std::string description() const
Return a one-line description of this object.
Definition: Tpetra_Vector_def.hpp:161
Tpetra::createCopy
MultiVector< ST, LO, GO, NT > createCopy(const MultiVector< ST, LO, GO, NT > &src)
Return a deep copy of the given MultiVector.
Definition: Tpetra_MultiVector_def.hpp:4653
Tpetra::Vector::dot
dot_type dot(const Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &y) const
Return the dot product of this Vector and the input Vector x.
Definition: Tpetra_Vector_def.hpp:117
Tpetra::Vector::sumIntoGlobalValue
void sumIntoGlobalValue(const GlobalOrdinal globalRow, const Scalar &value, const bool atomic=base_type::useAtomicUpdatesByDefault)
Add value to existing value, using global (row) index.
Definition: Tpetra_Vector_def.hpp:87
Tpetra::Vector::replaceLocalValue
void replaceLocalValue(const LocalOrdinal myRow, const Scalar &value)
Replace current value at the specified location with specified values.
Definition: Tpetra_Vector_def.hpp:95
Tpetra::Vector::replaceGlobalValue
void replaceGlobalValue(const GlobalOrdinal globalRow, const Scalar &value)
Replace current value at the specified location with specified value.
Definition: Tpetra_Vector_def.hpp:81
Tpetra::Vector::local_ordinal_type
LocalOrdinal local_ordinal_type
This class&#39; second template parameter; the type of local indices.
Definition: Tpetra_Vector_decl.hpp:66
Tpetra::Vector
A distributed dense vector.
Definition: Tpetra_Vector_decl.hpp:44
Tpetra::Vector::dual_view_type
base_type::dual_view_type dual_view_type
Kokkos::DualView specialization used by this class.
Definition: Tpetra_Vector_decl.hpp:91
Tpetra::Vector::meanValue
Scalar meanValue() const
Compute mean (average) value of this Vector.
Definition: Tpetra_Vector_def.hpp:126
Tpetra::Vector::normInf
mag_type normInf() const
Return the infinity-norm of this Vector.
Definition: Tpetra_Vector_def.hpp:153
Tpetra::Vector::dot_type
base_type::dot_type dot_type
Type of an inner (&quot;dot&quot;) product result.
Definition: Tpetra_Vector_decl.hpp:80
Tpetra::Vector::norm1
mag_type norm1() const
Return the one-norm of this Vector.
Definition: Tpetra_Vector_def.hpp:135
Generated on Thu Oct 9 2025 07:11:08 for Tpetra parallel linear algebra by   doxygen 1.8.5