All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
Xpetra_Map.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_MAP_HPP
47 #define XPETRA_MAP_HPP
48 
49 /* this file is automatically generated - do not edit (see script/interfaces.py) */
50 
51 #include "Xpetra_ConfigDefs.hpp"
52 #include <Kokkos_DefaultNode.hpp>
53 #include <Teuchos_Describable.hpp>
54 
55 #ifdef HAVE_XPETRA_EPETRA
56 #include "Epetra_config.h"
57 #endif
58 
59 #ifdef HAVE_XPETRA_KOKKOS_REFACTOR
60 #ifdef HAVE_XPETRA_TPETRA
61 #include <Tpetra_Map.hpp>
62 #endif
63 #endif
64 
65 namespace Xpetra {
66 
67  // TODO move this typedef to another place
68  // Node which is used for Epetra. This can be either the
69  // Serial node or OpenMP node (but not both)
70 #ifdef HAVE_XPETRA_EPETRA
71 # ifdef EPETRA_HAVE_OMP
73 # else
75 # endif
76 #else
77  // We can instantiate Xpetra::Tpetra objects for EpetraNode. So this has to be defined.
79 #endif
80 
85  };
86 
87  template <class LocalOrdinal = int,
88  class GlobalOrdinal = LocalOrdinal,
90  class Map
91  : public Teuchos::Describable
92  {
93  public:
94  typedef LocalOrdinal local_ordinal_type;
95  typedef GlobalOrdinal global_ordinal_type;
96  typedef Node node_type;
97 
99 
100 
102  virtual ~Map() { }
103 
105 
107 
108 
110  virtual global_size_t getGlobalNumElements() const = 0;
111 
113  virtual size_t getNodeNumElements() const = 0;
114 
116  virtual GlobalOrdinal getIndexBase() const = 0;
117 
119  virtual LocalOrdinal getMinLocalIndex() const = 0;
120 
122  virtual LocalOrdinal getMaxLocalIndex() const = 0;
123 
125  virtual GlobalOrdinal getMinGlobalIndex() const = 0;
126 
128  virtual GlobalOrdinal getMaxGlobalIndex() const = 0;
129 
131  virtual GlobalOrdinal getMinAllGlobalIndex() const = 0;
132 
134  virtual GlobalOrdinal getMaxAllGlobalIndex() const = 0;
135 
137  virtual LocalOrdinal getLocalElement(GlobalOrdinal globalIndex) const = 0;
138 
140  virtual GlobalOrdinal getGlobalElement(LocalOrdinal localIndex) const = 0;
141 
144 
146  virtual LookupStatus getRemoteIndexList(const Teuchos::ArrayView< const GlobalOrdinal > &GIDList, const Teuchos::ArrayView< int > &nodeIDList) const = 0;
147 
150 
152 
154 
155 
157  virtual bool isNodeLocalElement(LocalOrdinal localIndex) const = 0;
158 
160  virtual bool isNodeGlobalElement(GlobalOrdinal globalIndex) const = 0;
161 
163  virtual bool isContiguous() const = 0;
164 
166  virtual bool isDistributed() const = 0;
167 
169  virtual bool isCompatible(const Map< LocalOrdinal, GlobalOrdinal, Node > &map) const = 0;
170 
172  virtual bool isSameAs(const Map< LocalOrdinal, GlobalOrdinal, Node > &map) const = 0;
173 
175 
177 
178 
181 
182 #ifdef TPETRA_ENABLE_DEPRECATED_CODE
183  virtual Teuchos::RCP< Node > getNode() const = 0;
185 #endif // TPETRA_ENABLE_DEPRECATED_CODE
186 
188 
190 
191 
193  virtual std::string description() const = 0;
194 
197 
199 
201 
202 
205 
208 
210 
212 
213 
215  virtual UnderlyingLib lib() const = 0;
216 
217  // TODO: find a better solution for this hack
218  // The problem is that EpetraMap, TpetraMap and StridedMap all inherit Map. To have proper toEpetra() we
219  // need to understand the type of underlying matrix. But in src/Map we have no knowledge of StridedMaps, so
220  // we cannot check for it by casting. This function allows us to avoid the restriction, as StridedMap redefines
221  // it to return the base map.
222  virtual RCP<const Xpetra::Map<LocalOrdinal, GlobalOrdinal, Node> > getMap() const { return rcpFromRef(*this); }
223 
224 #ifdef HAVE_XPETRA_KOKKOS_REFACTOR
225 #ifdef HAVE_XPETRA_TPETRA
226  typedef typename Tpetra::Map<LocalOrdinal, GlobalOrdinal, Node>::local_map_type local_map_type;
228  virtual local_map_type getLocalMap () const = 0;
229 #endif
230 #endif
231 
233 
234  }; // Map class
235 
236 } // Xpetra namespace
237 
238 #define XPETRA_MAP_SHORT
239 #endif // XPETRA_MAP_HPP
virtual LookupStatus getRemoteIndexList(const Teuchos::ArrayView< const GlobalOrdinal > &GIDList, const Teuchos::ArrayView< int > &nodeIDList, const Teuchos::ArrayView< LocalOrdinal > &LIDList) const =0
Return the process ranks and corresponding local indices for the given global indices.
virtual Teuchos::ArrayView< const GlobalOrdinal > getNodeElementList() const =0
Return a view of the global indices owned by this process.
LocalOrdinal local_ordinal_type
Definition: Xpetra_Map.hpp:94
virtual Teuchos::RCP< const Teuchos::Comm< int > > getComm() const =0
Get this Map&#39;s Comm object.
virtual RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > replaceCommWithSubset(const Teuchos::RCP< const Teuchos::Comm< int > > &newComm) const =0
Replace this Map&#39;s communicator with a subset communicator.
virtual bool isDistributed() const =0
Whether this Map is globally distributed or locally replicated.
virtual LocalOrdinal getMinLocalIndex() const =0
The minimum local index.
GlobalOrdinal global_ordinal_type
Definition: Xpetra_Map.hpp:95
virtual bool isCompatible(const Map< LocalOrdinal, GlobalOrdinal, Node > &map) const =0
True if and only if map is compatible with this Map.
Node node_type
Definition: Xpetra_Map.hpp:96
virtual GlobalOrdinal getMinAllGlobalIndex() const =0
The minimum global index over all processes in the communicator.
virtual size_t getNodeNumElements() const =0
The number of elements belonging to the calling process.
virtual LocalOrdinal getLocalElement(GlobalOrdinal globalIndex) const =0
The local index corresponding to the given global index.
virtual GlobalOrdinal getMinGlobalIndex() const =0
The minimum global index owned by the calling process.
Kokkos::Compat::KokkosSerialWrapperNode EpetraNode
Definition: Xpetra_Map.hpp:74
virtual GlobalOrdinal getIndexBase() const =0
The index base for this Map.
virtual ~Map()
Destructor.
Definition: Xpetra_Map.hpp:102
virtual RCP< const Map< LocalOrdinal, GlobalOrdinal, Node > > removeEmptyProcesses() const =0
Return a new Map with processes with zero elements removed.
virtual bool isNodeGlobalElement(GlobalOrdinal globalIndex) const =0
Whether the given global index is valid for this Map on this process.
virtual RCP< const Xpetra::Map< LocalOrdinal, GlobalOrdinal, Node > > getMap() const
Definition: Xpetra_Map.hpp:222
virtual GlobalOrdinal getMaxGlobalIndex() const =0
The maximum global index owned by the calling process.
virtual GlobalOrdinal getMaxAllGlobalIndex() const =0
The maximum global index over all processes in the communicator.
virtual GlobalOrdinal getGlobalElement(LocalOrdinal localIndex) const =0
The global index corresponding to the given local index.
virtual LocalOrdinal getMaxLocalIndex() const =0
The maximum local index on the calling process.
size_t global_size_t
Global size_t object.
static const EVerbosityLevel verbLevel_default
virtual bool isSameAs(const Map< LocalOrdinal, GlobalOrdinal, Node > &map) const =0
True if and only if map is identical to this Map.
virtual bool isNodeLocalElement(LocalOrdinal localIndex) const =0
Whether the given local index is valid for this Map on this process.
virtual global_size_t getGlobalNumElements() const =0
The number of elements in this Map.
virtual void describe(Teuchos::FancyOStream &out, const Teuchos::EVerbosityLevel verbLevel=Teuchos::Describable::verbLevel_default) const =0
Print this object with the given verbosity level to the given Teuchos::FancyOStream.
virtual bool isContiguous() const =0
True if this Map is distributed contiguously, else false.
virtual UnderlyingLib lib() const =0
Get the library used by this object (Tpetra or Epetra?)
virtual std::string description() const =0
Return a simple one-line description of this object.