VTK  9.3.1
vtkDIYUtilities.h
Go to the documentation of this file.
1 // SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
2 // SPDX-License-Identifier: BSD-3-Clause
13 #ifndef vtkDIYUtilities_h
14 #define vtkDIYUtilities_h
15 
16 #include "vtkObject.h"
17 #include "vtkParallelDIYModule.h" // for export macros
18 #include "vtkSmartPointer.h" // needed for vtkSmartPointer
19 
20 #include <map> // For Link
21 #include <set> // For Link
22 #include <vector> // For GetDataSets
23 
24 // clang-format off
25 #include "vtk_diy2.h" // needed for DIY
26 #include VTK_DIY2(diy/master.hpp)
27 #include VTK_DIY2(diy/mpi.hpp)
28 #include VTK_DIY2(diy/serialization.hpp)
29 #include VTK_DIY2(diy/types.hpp)
30 // clang-format on
31 
32 VTK_ABI_NAMESPACE_BEGIN
33 class vtkDataArray;
34 class vtkBoundingBox;
35 class vtkDataObject;
36 class vtkDataSet;
37 class vtkFieldData;
39 class vtkPoints;
40 class vtkStringArray;
41 
42 class VTKPARALLELDIY_EXPORT vtkDIYUtilities : public vtkObject
43 {
44 public:
45  vtkTypeMacro(vtkDIYUtilities, vtkObject);
46  void PrintSelf(ostream& os, vtkIndent indent) override;
47 
52  static void InitializeEnvironmentForDIY();
53 
59  static diy::mpi::communicator GetCommunicator(vtkMultiProcessController* controller);
60 
62 
65  static void Save(diy::BinaryBuffer& bb, vtkDataSet*);
66  static void Load(diy::BinaryBuffer& bb, vtkDataSet*&);
68 
70 
73  static void Save(diy::BinaryBuffer& bb, vtkFieldData*);
74  static void Load(diy::BinaryBuffer& bb, vtkFieldData*&);
76 
78 
81  static void Save(diy::BinaryBuffer& bb, vtkStringArray*);
82  static void Load(diy::BinaryBuffer& bb, vtkStringArray*&);
84 
86 
89  static void Save(diy::BinaryBuffer& bb, vtkDataArray*);
90  static void Load(diy::BinaryBuffer& bb, vtkDataArray*&);
92 
96  static void AllReduce(diy::mpi::communicator& comm, vtkBoundingBox& bbox);
97 
104  static diy::ContinuousBounds Convert(const vtkBoundingBox& bbox);
105 
112  static vtkBoundingBox Convert(const diy::ContinuousBounds& bds);
113 
118  static void Broadcast(
119  diy::mpi::communicator& comm, std::vector<vtkBoundingBox>& boxes, int source);
120 
122 
128  static std::vector<vtkSmartPointer<vtkPoints>> ExtractPoints(
129  const std::vector<vtkDataSet*>& datasets, bool use_cell_centers);
131 
135  static vtkBoundingBox GetLocalBounds(vtkDataObject* dobj);
136 
145  template <class DummyT>
146  static void Link(diy::Master& master, const diy::Assigner& assigner,
147  const std::vector<std::map<int, DummyT>>& linksMap);
148 
149  static void Link(
150  diy::Master& master, const diy::Assigner& assigner, const std::vector<std::set<int>>& linksMap);
151 
152 protected:
153  vtkDIYUtilities();
154  ~vtkDIYUtilities() override;
155 
156 private:
157  vtkDIYUtilities(const vtkDIYUtilities&) = delete;
158  void operator=(const vtkDIYUtilities&) = delete;
159 };
160 VTK_ABI_NAMESPACE_END
161 
162 namespace diy
163 {
164 template <>
166 {
167  static void save(BinaryBuffer& bb, vtkDataSet* const& p) { vtkDIYUtilities::Save(bb, p); }
168  static void load(BinaryBuffer& bb, vtkDataSet*& p) { vtkDIYUtilities::Load(bb, p); }
169 };
170 
171 template <>
173 {
174  static void save(BinaryBuffer& bb, vtkDataArray* const& da) { vtkDIYUtilities::Save(bb, da); }
175  static void load(BinaryBuffer& bb, vtkDataArray*& da) { vtkDIYUtilities::Load(bb, da); }
176 };
177 
178 template <>
180 {
181  static void save(BinaryBuffer& bb, vtkFieldData* const& fd) { vtkDIYUtilities::Save(bb, fd); }
182  static void load(BinaryBuffer& bb, vtkFieldData*& fd) { vtkDIYUtilities::Load(bb, fd); }
183 };
184 }
185 
186 VTK_ABI_NAMESPACE_BEGIN
187 // Implementation detail for Schwarz counter idiom.
188 class VTKPARALLELDIY_EXPORT vtkDIYUtilitiesCleanup
189 {
190 public:
193 
194 private:
196  void operator=(const vtkDIYUtilitiesCleanup&) = delete;
197 };
199 
200 VTK_ABI_NAMESPACE_END
201 #include "vtkDIYUtilities.txx" // for template implementations
202 
203 #endif
static void load(BinaryBuffer &bb, vtkFieldData *&fd)
static void save(BinaryBuffer &bb, vtkFieldData *const &fd)
abstract base class for most VTK objects
Definition: vtkObject.h:51
void PrintSelf(ostream &os, vtkIndent indent) override
Methods invoked by print to print information about the object including superclasses.
abstract class to specify dataset behavior
Definition: vtkDataSet.h:52
static void load(BinaryBuffer &bb, vtkDataArray *&da)
a vtkAbstractArray subclass for strings
static void load(BinaryBuffer &bb, vtkDataSet *&p)
static void save(BinaryBuffer &bb, vtkDataSet *const &p)
static void Load(diy::BinaryBuffer &bb, vtkDataSet *&)
Load/Save a vtkDataSet in a diy::BinaryBuffer.
static void save(BinaryBuffer &bb, vtkDataArray *const &da)
a simple class to control print indentation
Definition: vtkIndent.h:28
static void Save(diy::BinaryBuffer &bb, vtkDataSet *)
Load/Save a vtkDataSet in a diy::BinaryBuffer.
VTKACCELERATORSVTKMCORE_EXPORT vtkDataArray * Convert(const vtkm::cont::Field &input)
abstract superclass for arrays of numeric data
Definition: vtkDataArray.h:44
boost::graph_traits< vtkGraph * >::vertex_descriptor source(boost::graph_traits< vtkGraph * >::edge_descriptor e, vtkGraph *)
collection of helper functions for working with DIY
static vtkDIYUtilitiesCleanup vtkDIYUtilitiesCleanupInstance
general representation of visualization data
Definition: vtkDataObject.h:54
represent and manipulate 3D points
Definition: vtkPoints.h:28
Fast, simple class for representing and operating on 3D bounds.
represent and manipulate fields of data
Definition: vtkFieldData.h:51
Multiprocessing communication superclass.