Xpetra  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
Xpetra_Vector.hpp
Go to the documentation of this file.
1 // @HEADER
2 //
3 // ***********************************************************************
4 //
5 // Xpetra: A linear algebra interface package
6 // Copyright 2012 Sandia Corporation
7 //
8 // Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
9 // the U.S. Government retains certain rights in this software.
10 //
11 // Redistribution and use in source and binary forms, with or without
12 // modification, are permitted provided that the following conditions are
13 // met:
14 //
15 // 1. Redistributions of source code must retain the above copyright
16 // notice, this list of conditions and the following disclaimer.
17 //
18 // 2. Redistributions in binary form must reproduce the above copyright
19 // notice, this list of conditions and the following disclaimer in the
20 // documentation and/or other materials provided with the distribution.
21 //
22 // 3. Neither the name of the Corporation nor the names of the
23 // contributors may be used to endorse or promote products derived from
24 // this software without specific prior written permission.
25 //
26 // THIS SOFTWARE IS PROVIDED BY SANDIA CORPORATION "AS IS" AND ANY
27 // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
28 // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
29 // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL SANDIA CORPORATION OR THE
30 // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
31 // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
32 // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
33 // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
34 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
35 // NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
36 // SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
37 //
38 // Questions? Contact
39 // Jonathan Hu (jhu@sandia.gov)
40 // Andrey Prokopenko (aprokop@sandia.gov)
41 // Ray Tuminaro (rstumin@sandia.gov)
42 //
43 // ***********************************************************************
44 //
45 // @HEADER
46 #ifndef XPETRA_VECTOR_HPP
47 #define XPETRA_VECTOR_HPP
48 
49 /* this file is automatically generated - do not edit (see script/interfaces.py) */
50 
51 #include "Xpetra_ConfigDefs.hpp"
52 #include "Xpetra_MultiVector.hpp"
53 
54 namespace Xpetra {
55 
56 template <class Scalar,
57  class LocalOrdinal,
58  class GlobalOrdinal,
59  class Node = Tpetra::KokkosClassic::DefaultNode::DefaultNodeType>
60 class Vector
61  : public virtual MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node> {
62  public:
63  using scalar_type = Scalar;
64  using local_ordinal_type = LocalOrdinal;
65  using global_ordinal_type = GlobalOrdinal;
66  using node_type = Node;
67 
68  using MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::dot; // overloading, not hiding
77 
79 
80  template <class TargetDeviceType, class AccessType>
81  typename std::conditional<
82  std::is_same<
83  typename dual_view_type::t_dev_um::execution_space::memory_space,
84  typename TargetDeviceType::memory_space>::value,
85  typename dual_view_type::t_dev_um,
86  typename dual_view_type::t_host_um>::type
87  getLocalView(AccessType access_type) const {
88  return this->MultiVector<Scalar, LocalOrdinal, GlobalOrdinal, Node>::template getLocalView<TargetDeviceType>(access_type);
89  }
90 
92 
93 
95  virtual ~Vector() {}
96 
98 
100 
101 
103  virtual void replaceGlobalValue(GlobalOrdinal globalRow, const Scalar &value) = 0;
104 
106  virtual void sumIntoGlobalValue(GlobalOrdinal globalRow, const Scalar &value) = 0;
107 
109  virtual void replaceLocalValue(LocalOrdinal myRow, const Scalar &value) = 0;
110 
112  virtual void sumIntoLocalValue(LocalOrdinal myRow, const Scalar &value) = 0;
113 
115 
117 
118 
120  virtual Scalar dot(const Vector<Scalar, LocalOrdinal, GlobalOrdinal, Node> &a) const = 0;
121 
123  virtual typename Teuchos::ScalarTraits<Scalar>::magnitudeType norm1() const = 0;
124 
126  virtual typename Teuchos::ScalarTraits<Scalar>::magnitudeType norm2() const = 0;
127 
129  virtual typename Teuchos::ScalarTraits<Scalar>::magnitudeType normInf() const = 0;
130 
132  virtual Scalar meanValue() const = 0;
133 
135 
137 
138 
140  virtual std::string description() const = 0;
141 
143  virtual void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel = Teuchos::Describable::verbLevel_default) const = 0;
144 
146 
147 }; // Vector class
148 } // namespace Xpetra
149 
150 #define XPETRA_VECTOR_SHORT
151 #endif // XPETRA_VECTOR_HPP
virtual Teuchos::ScalarTraits< Scalar >::magnitudeType normInf() const =0
Compute Inf-norm of this Vector.
std::conditional< std::is_same< typename dual_view_type::t_dev_um::execution_space::memory_space, typename TargetDeviceType::memory_space >::value, typename dual_view_type::t_dev_um, typename dual_view_type::t_host_um >::type getLocalView(AccessType access_type) const
virtual void replaceGlobalValue(GlobalOrdinal globalRow, const Scalar &value)=0
Replace current value at the specified location with specified value.
virtual void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel=Teuchos::Describable::verbLevel_default) const =0
Print the object with some verbosity level to an FancyOStream object.
Kokkos::DualView< impl_scalar_type **, Kokkos::LayoutStride, typename node_type::device_type, Kokkos::MemoryUnmanaged > dual_view_type
virtual Scalar dot(const Vector< Scalar, LocalOrdinal, GlobalOrdinal, Node > &a) const =0
Computes dot product of this Vector against input Vector x.
virtual Scalar meanValue() const =0
Compute mean (average) value of this Vector.
virtual void sumIntoLocalValue(LocalOrdinal myRow, const Scalar &value)=0
Adds specified value to existing value at the specified location.
virtual std::string description() const =0
Return a simple one-line description of this object.
Xpetra::MultiVector< Scalar, LocalOrdinal, GlobalOrdinal, Node >::dual_view_type dual_view_type
virtual Teuchos::ScalarTraits< Scalar >::magnitudeType norm1() const =0
Return 1-norm of this Vector.
virtual void sumIntoGlobalValue(GlobalOrdinal globalRow, const Scalar &value)=0
Adds specified value to existing value at the specified location.
virtual Teuchos::ScalarTraits< Scalar >::magnitudeType norm2() const =0
Compute 2-norm of this Vector.
virtual void replaceLocalValue(LocalOrdinal myRow, const Scalar &value)=0
Replace current value at the specified location with specified values.
virtual ~Vector()
Destructor.