Xpetra  Version of the Day
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
Xpetra_StridedMapFactory_def.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 
47 // WARNING: This code is experimental. Backwards compatibility should not be expected.
48 
49 #ifndef XPETRA_STRIDEDMAPFACTORY_DEF_HPP
50 #define XPETRA_STRIDEDMAPFACTORY_DEF_HPP
51 
53 
54 #include "Xpetra_Exceptions.hpp"
55 
56 // This factory creates Xpetra::Map. User have to specify the exact class of
57 // object that he want to create (ie: a Xpetra::TpetraMap or a Xpetra::EpetraMap).
58 
59 
60 
61 namespace Xpetra {
62 
63 
64 
65 template<class LocalOrdinal, class GlobalOrdinal, class Node>
68 {
69 }
70 
71 
72 
73 
74 template<class LocalOrdinal, class GlobalOrdinal, class Node>
75 RCP<Xpetra::StridedMap<LocalOrdinal, GlobalOrdinal, Node>>
78  global_size_t numGlobalElements,
79  GlobalOrdinal indexBase,
80  std::vector<size_t>& stridingInfo,
81  const Teuchos::RCP<const Teuchos::Comm<int>>& comm,
82  LocalOrdinal stridedBlockId,
83  GlobalOrdinal offset,
84  LocalGlobal lg)
85 {
86  return rcp(new Xpetra::StridedMap<LocalOrdinal, GlobalOrdinal, Node>(lib, numGlobalElements, indexBase, stridingInfo, comm, stridedBlockId, offset, lg));
87 }
88 
89 
90 
91 
92 template<class LocalOrdinal, class GlobalOrdinal, class Node>
93 RCP<Xpetra::StridedMap<LocalOrdinal,GlobalOrdinal,Node>>
96  global_size_t numGlobalElements,
97  size_t numLocalElements,
98  GlobalOrdinal indexBase,
99  std::vector<size_t>& stridingInfo,
100  const Teuchos::RCP<const Teuchos::Comm<int>>& comm,
101  LocalOrdinal stridedBlockId,
102  GlobalOrdinal offset)
103 {
104  return rcp(new StridedMap(lib, numGlobalElements, numLocalElements, indexBase, stridingInfo, comm, stridedBlockId, offset));
105 }
106 
107 
108 template<class LocalOrdinal, class GlobalOrdinal, class Node>
109 RCP<Xpetra::StridedMap<LocalOrdinal,GlobalOrdinal,Node>>
111 Build(const RCP<const Map>& map,
112  std::vector<size_t>& stridingInfo,
113  LocalOrdinal stridedBlockId,
114  GlobalOrdinal offset)
115 {
116  return rcp(new StridedMap(map, stridingInfo, map->getIndexBase(), stridedBlockId, offset));
117 }
118 
119 
120 template<class LocalOrdinal, class GlobalOrdinal, class Node>
121 RCP<Xpetra::StridedMap<LocalOrdinal,GlobalOrdinal,Node>>
123 Build(const RCP<const StridedMap>& map, LocalOrdinal stridedBlockId)
124 {
125  TEUCHOS_TEST_FOR_EXCEPTION(stridedBlockId < 0,
127  "Xpetra::StridedMapFactory::Build: constructor expects stridedBlockId > -1.");
128 
129  TEUCHOS_TEST_FOR_EXCEPTION(map->getStridedBlockId() != -1,
131  "Xpetra::StridedMapFactory::Build: constructor expects a full map (stridedBlockId == -1).");
132 
133  std::vector<size_t> stridingInfo = map->getStridingData();
134 
135  Teuchos::ArrayView<const GlobalOrdinal> dofGids = map->getNodeElementList();
136  // std::sort(dofGids.begin(),dofGids.end()); // TODO: do we need this?
137 
138  // determine nStridedOffset
139  size_t nStridedOffset = 0;
140  for(int j = 0; j < map->getStridedBlockId(); j++)
141  {
142  nStridedOffset += stridingInfo[ j ];
143  }
144 
145  size_t numMyBlockDofs = (stridingInfo[ stridedBlockId ] * map->getNodeNumElements()) / map->getFixedBlockSize();
146 
147  std::vector<GlobalOrdinal> subBlockDofGids(numMyBlockDofs);
148 
149  // TODO fill vector with dofs
150  LocalOrdinal ind = 0;
151  for(typename Teuchos::ArrayView<const GlobalOrdinal>::iterator it = dofGids.begin(); it != dofGids.end(); ++it)
152  {
153  if(map->GID2StridingBlockId(*it) == Teuchos::as<size_t>(stridedBlockId))
154  {
155  subBlockDofGids[ ind++ ] = *it;
156  }
157  }
158 
159  const Teuchos::ArrayView<const GlobalOrdinal> subBlockDofGids_view(&subBlockDofGids[ 0 ], subBlockDofGids.size());
160 
161  return rcp(new StridedMap(map->lib(),
162  Teuchos::OrdinalTraits<global_size_t>::invalid(),
163  subBlockDofGids_view,
164  map->getIndexBase(),
165  stridingInfo,
166  map->getComm(),
167  stridedBlockId));
168 }
169 
170 
171 template<class LocalOrdinal, class GlobalOrdinal, class Node>
172 RCP<Xpetra::StridedMap<LocalOrdinal,GlobalOrdinal,Node>>
174 Build(const StridedMap& map)
175 {
176  XPETRA_MONITOR("MapFactory::Build");
177 
178  LocalOrdinal N = map.getNodeNumElements();
179  Teuchos::ArrayView<const GlobalOrdinal> oldElements = map.getNodeElementList();
180  Teuchos::Array<GlobalOrdinal> newElements(map.getNodeNumElements());
181 
182  for(LocalOrdinal i = 0; i < N; i++)
183  {
184  newElements[ i ] = oldElements[ i ];
185  }
186 
187  std::vector<size_t> strData = map.getStridingData();
188  return rcp(new StridedMap(map.lib(), map.getGlobalNumElements(), newElements, map.getIndexBase(), strData, map.getComm(), map.getStridedBlockId()));
189 
190  // XPETRA_FACTORY_END;
191 }
192 
193 
194 
195 
196 template<class LocalOrdinal, class GlobalOrdinal, class Node>
197 RCP<Xpetra::StridedMap<LocalOrdinal,GlobalOrdinal,Node>>
200  global_size_t numGlobalElements,
201  const Teuchos::ArrayView<const GlobalOrdinal>& elementList,
202  GlobalOrdinal indexBase,
203  std::vector<size_t>& stridingInfo,
204  const Teuchos::RCP<const Teuchos::Comm<int>>& comm,
205  LocalOrdinal stridedBlockId, // FIXME (mfh 03 Sep 2014) This breaks if LocalOrdinal is unsigned
206  GlobalOrdinal /* offset */)
207 {
208  return rcp(new StridedMap(lib, numGlobalElements, elementList, indexBase, stridingInfo, comm, stridedBlockId));
209 }
210 
211 
212 
213 } // namespace Xpetra
214 
215 
216 
217 #endif // __XPETRA_STRIDEDMAPFACTORY_DEF_HPP__
218 
219 // TODO: removed unused methods
LocalOrdinal getStridedBlockId() const
Teuchos::ArrayView< const GlobalOrdinal > getNodeElementList() const
Return a list of the global indices owned by this node.
Exception throws to report errors in the internal logical of the program.
Teuchos::RCP< const Teuchos::Comm< int > > getComm() const
Get the Comm object for this Map.
size_t getNodeNumElements() const
Returns the number of elements belonging to the calling node.
size_t global_size_t
Global size_t object.
GlobalOrdinal getIndexBase() const
Returns the index base for this Map.
global_size_t getGlobalNumElements() const
Returns the number of elements in this Map.
std::vector< size_t > getStridingData() const
UnderlyingLib lib() const
Get the library used by this object (Tpetra or Epetra?)
StridedMapFactory()
Private constructor. This is a static class.
#define XPETRA_MONITOR(funcName)
static RCP< Xpetra::StridedMap< LocalOrdinal, GlobalOrdinal, Node > > Build(UnderlyingLib lib, global_size_t numGlobalElements, GlobalOrdinal indexBase, std::vector< size_t > &stridingInfo, const Teuchos::RCP< const Teuchos::Comm< int >> &comm, LocalOrdinal stridedBlockId=-1, GlobalOrdinal offset=0, LocalGlobal lg=Xpetra::GloballyDistributed)
Map constructor with Xpetra-defined contiguous uniform distribution.
Class that stores a strided map.