VTK-m  2.0
InitToCombinedSortOrderArraysWorklet.h
Go to the documentation of this file.
1 //============================================================================
2 // Copyright (c) Kitware, Inc.
3 // All rights reserved.
4 // See LICENSE.txt for details.
5 // This software is distributed WITHOUT ANY WARRANTY; without even
6 // the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
7 // PURPOSE. See the above copyright notice for more information.
8 //
9 // Copyright 2014 National Technology & Engineering Solutions of Sandia, LLC (NTESS).
10 // Copyright 2014 UT-Battelle, LLC.
11 // Copyright 2014 Los Alamos National Security.
12 //
13 // Under the terms of Contract DE-NA0003525 with NTESS,
14 // the U.S. Government retains certain rights in this software.
15 //
16 // Under the terms of Contract DE-AC52-06NA25396 with Los Alamos National
17 // Laboratory (LANL), the U.S. Government retains certain rights in
18 // this software.
19 //============================================================================
20 // Copyright (c) 2018, The Regents of the University of California, through
21 // Lawrence Berkeley National Laboratory (subject to receipt of any required approvals
22 // from the U.S. Dept. of Energy). All rights reserved.
23 //
24 // Redistribution and use in source and binary forms, with or without modification,
25 // are permitted provided that the following conditions are met:
26 //
27 // (1) Redistributions of source code must retain the above copyright notice, this
28 // list of conditions and the following disclaimer.
29 //
30 // (2) Redistributions in binary form must reproduce the above copyright notice,
31 // this list of conditions and the following disclaimer in the documentation
32 // and/or other materials provided with the distribution.
33 //
34 // (3) Neither the name of the University of California, Lawrence Berkeley National
35 // Laboratory, U.S. Dept. of Energy nor the names of its contributors may be
36 // used to endorse or promote products derived from this software without
37 // specific prior written permission.
38 //
39 // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
40 // ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
41 // WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
42 // IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
43 // INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
44 // BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
45 // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
46 // LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
47 // OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
48 // OF THE POSSIBILITY OF SUCH DAMAGE.
49 //
50 //=============================================================================
51 //
52 // This code is an extension of the algorithm presented in the paper:
53 // Parallel Peak Pruning for Scalable SMP Contour Tree Computation.
54 // Hamish Carr, Gunther Weber, Christopher Sewell, and James Ahrens.
55 // Proceedings of the IEEE Symposium on Large Data Analysis and Visualization
56 // (LDAV), October 2016, Baltimore, Maryland.
57 //
58 // The PPP2 algorithm and software were jointly developed by
59 // Hamish Carr (University of Leeds), Gunther H. Weber (LBNL), and
60 // Oliver Ruebel (LBNL)
61 //==============================================================================
62 
63 #ifndef vtk_m_worklet_contourtree_augmented_contourtree_mesh_inc_init_to_combined_sort_order_arrays_worklet_h
64 #define vtk_m_worklet_contourtree_augmented_contourtree_mesh_inc_init_to_combined_sort_order_arrays_worklet_h
65 
68 
69 namespace vtkm
70 {
71 namespace worklet
72 {
73 namespace contourtree_augmented
74 {
75 namespace mesh_dem_contourtree_mesh_inc
76 {
77 
78 
80 {
81 public:
82  typedef void ControlSignature(
83  FieldIn overallSortIndex, // (input) overallSortIndex
84  FieldIn overallSortOrder, // (input) overallSortOrder
85  WholeArrayOut thisToCombinedSortOrder, // (output) thisToCombinedSortOrder
86  WholeArrayOut otherToCombinedSortOrder // (output) otherToCombinedSortOrder
87  );
88  typedef void ExecutionSignature(_1, _2, _3, _4);
89  typedef _1 InputDomain;
90 
91  // Default Constructor
94 
95  template <typename OutFieldPortalType>
96  VTKM_EXEC void operator()(const vtkm::Id& overallSortIndexVal,
97  const vtkm::Id& overallSortOrderVal,
98  const OutFieldPortalType& thisToCombinedSortOrderPortal,
99  const OutFieldPortalType& otherToCombinedSortOrderPortal) const
100  {
101  if (IsThis(overallSortOrderVal))
102  {
103  thisToCombinedSortOrderPortal.Set(MaskedIndex(overallSortOrderVal), overallSortIndexVal);
104  }
105  else
106  {
107  otherToCombinedSortOrderPortal.Set(MaskedIndex(overallSortOrderVal), overallSortIndexVal);
108  }
109 
110  // In serial this worklet implements the following operation
111  // for (indexVector::size_type i = 0; i < overallSortOrder.size(); ++i)
112  // {
113  // if (CombinedIndexVector::IsThis(overallSortOrder[i]))
114  // thisToCombinedSortOrder[MaskedIndex(overallSortOrder[MaskedIndex(i)])] = overallSortIndex[i];
115  // else
116  // otherToCombinedSortOrder[MaskedIndex(overallSortOrder[MaskedIndex(i)])] = overallSortIndex[i];
117  // }
118  }
119 
120 }; // InitToCombinedSortOrderArraysWorklet
121 
122 
123 } // namespace mesh_dem_contourtree_mesh_inc
124 } // namespace contourtree_augmented
125 } // namespace worklet
126 } // namespace vtkm
127 
128 #endif
VTKM_EXEC
#define VTKM_EXEC
Definition: ExportMacros.h:51
vtkm
Groups connected points that have the same field value.
Definition: Atomic.h:19
vtkm::worklet::contourtree_augmented::mesh_dem_contourtree_mesh_inc::InitToCombinedSortOrderArraysWorklet::operator()
VTKM_EXEC void operator()(const vtkm::Id &overallSortIndexVal, const vtkm::Id &overallSortOrderVal, const OutFieldPortalType &thisToCombinedSortOrderPortal, const OutFieldPortalType &otherToCombinedSortOrderPortal) const
Definition: InitToCombinedSortOrderArraysWorklet.h:96
WorkletMapField.h
VTKM_EXEC_CONT
#define VTKM_EXEC_CONT
Definition: ExportMacros.h:52
vtkm::worklet::contourtree_augmented::mesh_dem_contourtree_mesh_inc::InitToCombinedSortOrderArraysWorklet::InputDomain
_1 InputDomain
Definition: InitToCombinedSortOrderArraysWorklet.h:89
vtkm::worklet::contourtree_augmented::MaskedIndex
VTKM_EXEC_CONT vtkm::Id MaskedIndex(vtkm::Id flaggedIndex)
Definition: filter/scalar_topology/worklet/contourtree_augmented/Types.h:127
vtkm::Id
vtkm::Int32 Id
Represents an ID (index into arrays).
Definition: Types.h:191
vtkm::worklet::contourtree_augmented::mesh_dem_contourtree_mesh_inc::InitToCombinedSortOrderArraysWorklet::ControlSignature
void ControlSignature(FieldIn overallSortIndex, FieldIn overallSortOrder, WholeArrayOut thisToCombinedSortOrder, WholeArrayOut otherToCombinedSortOrder)
Definition: InitToCombinedSortOrderArraysWorklet.h:82
vtkm::worklet::WorkletMapField::FieldIn
A control signature tag for input fields.
Definition: WorkletMapField.h:49
Types.h
vtkm::worklet::contourtree_augmented::mesh_dem_contourtree_mesh_inc::InitToCombinedSortOrderArraysWorklet
Definition: InitToCombinedSortOrderArraysWorklet.h:79
vtkm::worklet::contourtree_augmented::IsThis
VTKM_EXEC_CONT bool IsThis(vtkm::Id flaggedIndex)
Used in the context of CombinedVector class used in ContourTreeMesh to merge the mesh of contour tree...
Definition: filter/scalar_topology/worklet/contourtree_augmented/Types.h:134
vtkm::worklet::contourtree_augmented::mesh_dem_contourtree_mesh_inc::InitToCombinedSortOrderArraysWorklet::InitToCombinedSortOrderArraysWorklet
VTKM_EXEC_CONT InitToCombinedSortOrderArraysWorklet()
Definition: InitToCombinedSortOrderArraysWorklet.h:93
vtkm::worklet::contourtree_augmented::mesh_dem_contourtree_mesh_inc::InitToCombinedSortOrderArraysWorklet::ExecutionSignature
void ExecutionSignature(_1, _2, _3, _4)
Definition: InitToCombinedSortOrderArraysWorklet.h:88
vtkm::worklet::WorkletMapField
Base class for worklets that do a simple mapping of field arrays.
Definition: WorkletMapField.h:38