Tpetra parallel linear algebra  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
Tpetra_Vector_decl.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_DECL_HPP
11 #define TPETRA_VECTOR_DECL_HPP
12 
15 
16 #include "Tpetra_ConfigDefs.hpp"
17 #include "Tpetra_Vector_fwd.hpp"
19 
20 namespace Tpetra {
21 
40 template <class Scalar,
41  class LocalOrdinal,
42  class GlobalOrdinal,
43  class Node>
44 class Vector : public MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node> {
45  private:
47 
48  public:
50 
51 
54  typedef Scalar scalar_type;
66  typedef LocalOrdinal local_ordinal_type;
68  typedef GlobalOrdinal global_ordinal_type;
70  typedef typename Node::device_type device_type;
71 
73  typedef Node node_type;
74 
80  typedef typename base_type::dot_type dot_type;
81 
88  typedef typename base_type::mag_type mag_type;
89 
92 
95 
97  typedef typename base_type::map_type map_type;
98 
100 
102 
104  Vector();
105 
111  //
116  explicit Vector(const Teuchos::RCP<const map_type>& map,
117  const bool zeroOut = true);
118 
131  const Teuchos::DataAccess copyOrView);
132 
139  const Teuchos::RCP<const map_type>& map,
140  const local_ordinal_type rowOffset = 0);
141 
143  Vector(const Teuchos::RCP<const map_type>& map,
144  const Teuchos::ArrayView<const Scalar>& A);
145 
158  Vector(const Teuchos::RCP<const map_type>& map,
159  const dual_view_type& view);
160 
175  Vector(const Teuchos::RCP<const map_type>& map,
176  const dual_view_type& view,
177  const dual_view_type& origView);
178 
187  Vector(const Teuchos::RCP<const map_type>& map,
188  const wrapped_dual_view_type& d_view);
189 
196  const size_t j);
197 
207 
210 
218 
222 
232  virtual ~Vector() = default;
234 
236 
237 
239 
241  void replaceGlobalValue(const GlobalOrdinal globalRow, const Scalar& value);
242 
262  void
263  sumIntoGlobalValue(const GlobalOrdinal globalRow,
264  const Scalar& value,
265  const bool atomic = base_type::useAtomicUpdatesByDefault);
266 
268 
270  void replaceLocalValue(const LocalOrdinal myRow, const Scalar& value);
271 
289  void
290  sumIntoLocalValue(const LocalOrdinal myRow,
291  const Scalar& value,
292  const bool atomic = base_type::useAtomicUpdatesByDefault);
293 
295 
297 
298 
301  void get1dCopy(const Teuchos::ArrayView<Scalar>& A) const;
302 
305  Teuchos::ArrayRCP<Scalar> getDataNonConst() {
306  return getDataNonConst(0);
307  }
308 
311  Teuchos::ArrayRCP<const Scalar> getData() const {
312  return getData(0);
313  }
314 
315  Teuchos::RCP<const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> >
316  offsetView(const Teuchos::RCP<const map_type>& subMap,
317  const size_t offset) const;
318 
319  Teuchos::RCP<Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> >
320  offsetViewNonConst(const Teuchos::RCP<const map_type>& subMap,
321  const size_t offset);
323 
325 
326  using MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::dot; // overloading, not hiding
329 
330  using MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::norm1; // overloading, not hiding
332  mag_type norm1() const;
333 
334  using MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::norm2; // overloading, not hiding
336  mag_type norm2() const;
337 
340  mag_type normInf() const;
341 
344  Scalar meanValue() const;
345 
347 
349 
351  virtual std::string description() const;
352 
374  virtual void
375  describe(Teuchos::FancyOStream& out,
376  const Teuchos::EVerbosityLevel verbLevel =
377  Teuchos::Describable::verbLevel_default) const;
379 }; // class Vector
380 
383 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
384 Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>
385 createCopy(const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node>& src);
386 
392 template <class Scalar, class LocalOrdinal, class GlobalOrdinal, class Node>
393 Teuchos::RCP<Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> >
394 createVector(const Teuchos::RCP<const Map<LocalOrdinal, GlobalOrdinal, Node> >& map) {
396 }
397 
398 } // namespace Tpetra
399 
400 #endif // TPETRA_VECTOR_DECL_HPP
Vector()
Default constructor: makes a Vector with no rows or columns.
mag_type norm2() const
Return the two-norm of this Vector.
Teuchos::ArrayRCP< Scalar > getDataNonConst()
View of the local values of this vector.
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.
Vector & operator=(const Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &)=default
Copy assignment (shallow copy).
base_type::mag_type mag_type
Type of a norm result.
Node::device_type device_type
The Kokkos device type.
typename Kokkos::ArithTraits< impl_scalar_type >::mag_type mag_type
Type of a norm result.
base_type::impl_scalar_type impl_scalar_type
The type used internally in place of Scalar.
void get1dCopy(const Teuchos::ArrayView< Scalar > &A) const
Return multi-vector values in user-provided two-dimensional array (using Teuchos memory management cl...
One or more distributed dense vectors.
void sumIntoLocalValue(const LocalOrdinal myRow, const Scalar &value, const bool atomic=base_type::useAtomicUpdatesByDefault)
Add value to existing value, using local (row) index.
virtual std::string description() const
Return a one-line description of this object.
MultiVector< ST, LO, GO, NT > createCopy(const MultiVector< ST, LO, GO, NT > &src)
Return a deep copy of the given MultiVector.
dot_type dot(const Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &y) const
Return the dot product of this Vector and the input Vector x.
static const bool useAtomicUpdatesByDefault
Whether sumIntoLocalValue and sumIntoGlobalValue should use atomic updates by default.
GlobalOrdinal global_ordinal_type
This class&#39; third template parameter; the type of global indices.
base_type::wrapped_dual_view_type wrapped_dual_view_type
WrappedDualView specialization used by this class.
typename Kokkos::ArithTraits< Scalar >::val_type impl_scalar_type
The type used internally in place of Scalar.
Scalar scalar_type
This class&#39; first template parameter; the type of each entry in the Vector.
Declaration of the Tpetra::MultiVector class.
Teuchos::ArrayRCP< const Scalar > getData() const
Const view of the local values of this vector.
void sumIntoGlobalValue(const GlobalOrdinal globalRow, const Scalar &value, const bool atomic=base_type::useAtomicUpdatesByDefault)
Add value to existing value, using global (row) index.
void replaceLocalValue(const LocalOrdinal myRow, const Scalar &value)
Replace current value at the specified location with specified values.
Teuchos::RCP< Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > > createVector(const Teuchos::RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > &map)
Nonmember Vector &quot;constructor&quot;: Create a Vector from a given Map.
virtual ~Vector()=default
Destructor (virtual for memory safety of derived classes).
void replaceGlobalValue(const GlobalOrdinal globalRow, const Scalar &value)
Replace current value at the specified location with specified value.
LocalOrdinal local_ordinal_type
This class&#39; second template parameter; the type of local indices.
Kokkos::DualView< impl_scalar_type **, Kokkos::LayoutLeft, device_type > dual_view_type
Kokkos::DualView specialization used by this class.
Forward declaration of Tpetra::Vector.
A parallel distribution of indices over processes.
Node node_type
The Kokkos Node type.
typename Kokkos::Details::InnerProductSpaceTraits< impl_scalar_type >::dot_type dot_type
Type of an inner (&quot;dot&quot;) product result.
A distributed dense vector.
base_type::dual_view_type dual_view_type
Kokkos::DualView specialization used by this class.
Scalar meanValue() const
Compute mean (average) value of this Vector.
base_type::map_type map_type
The type of the Map specialization used by this class.
mag_type normInf() const
Return the infinity-norm of this Vector.
base_type::dot_type dot_type
Type of an inner (&quot;dot&quot;) product result.
mag_type norm1() const
Return the one-norm of this Vector.