vtk-m2/vtkm/worklet/SurfaceNormals.h
Allison Vacanti 5db762ee71 Refactor topology mappings to clarify meaning.
The `From` and `To` nomenclature for topology mapping has been confusing for
both users and developers, especially at lower levels where the intention of
mapping attributes from one element to another is easily conflated with the
concept of mapping indices (which maps in the exact opposite direction).

These identifiers have been renamed to `VisitTopology` and `IncidentTopology`
to clarify the direction of the mapping. The order in which these template
parameters are specified for `WorkletMapTopology` have also been reversed,
since eventually there may be more than one `IncidentTopology`, and having
`IncidentTopology` at the end will allow us to replace it with a variadic
template parameter pack in the future.

Other implementation details supporting these worklets, include `Fetch` tags,
`Connectivity` classes, and methods on the various `CellSet` classes (such as
`PrepareForInput` have also reversed their template arguments. These will need
to be cautiously updated.

The convenience implementations of `WorkletMapTopology` have been renamed for
clarity as follows:

```
WorkletMapPointToCell --> WorkletVisitCellsWithPoints
WorkletMapCellToPoint --> WorkletVisitPointsWithCells
```

The `ControlSignature` tags have been renamed as follows:

```
FieldInTo --> FieldInVisit
FieldInFrom --> FieldInMap
FromCount --> IncidentElementCount
FromIndices --> IncidentElementIndices
```
2019-08-06 11:27:26 -04:00

209 lines
6.2 KiB
C++

//============================================================================
// Copyright (c) Kitware, Inc.
// All rights reserved.
// See LICENSE.txt for details.
//
// This software is distributed WITHOUT ANY WARRANTY; without even
// the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
// PURPOSE. See the above copyright notice for more information.
//============================================================================
#ifndef vtk_m_worklet_SurfaceNormals_h
#define vtk_m_worklet_SurfaceNormals_h
#include <vtkm/worklet/DispatcherMapTopology.h>
#include <vtkm/worklet/WorkletMapTopology.h>
#include <vtkm/CellTraits.h>
#include <vtkm/TypeTraits.h>
#include <vtkm/VectorAnalysis.h>
#include <vtkm/cont/VariantArrayHandle.h>
namespace vtkm
{
namespace worklet
{
namespace detail
{
struct PassThrough
{
template <typename T>
VTKM_EXEC vtkm::Vec<T, 3> operator()(const vtkm::Vec<T, 3>& in) const
{
return in;
}
};
struct Normal
{
template <typename T>
VTKM_EXEC vtkm::Vec<T, 3> operator()(const vtkm::Vec<T, 3>& in) const
{
return vtkm::Normal(in);
}
};
} // detail
class FacetedSurfaceNormals
{
public:
template <typename NormalFnctr = detail::Normal>
class Worklet : public vtkm::worklet::WorkletVisitCellsWithPoints
{
public:
using ControlSignature = void(CellSetIn cellset, FieldInPoint points, FieldOutCell normals);
using ExecutionSignature = void(CellShape, _2, _3);
using InputDomain = _1;
template <typename CellShapeTag, typename PointsVecType, typename T>
VTKM_EXEC void operator()(CellShapeTag,
const PointsVecType& points,
vtkm::Vec<T, 3>& normal) const
{
using CTraits = vtkm::CellTraits<CellShapeTag>;
const auto tag = typename CTraits::TopologicalDimensionsTag();
this->Compute(tag, points, normal);
}
template <vtkm::IdComponent Dim, typename PointsVecType, typename T>
VTKM_EXEC void Compute(vtkm::CellTopologicalDimensionsTag<Dim>,
const PointsVecType&,
vtkm::Vec<T, 3>& normal) const
{
normal = vtkm::TypeTraits<vtkm::Vec<T, 3>>::ZeroInitialization();
}
template <typename PointsVecType, typename T>
VTKM_EXEC void Compute(vtkm::CellTopologicalDimensionsTag<2>,
const PointsVecType& points,
vtkm::Vec<T, 3>& normal) const
{
normal = this->Normal(vtkm::Cross(points[2] - points[1], points[0] - points[1]));
}
template <typename PointsVecType, typename T>
VTKM_EXEC void operator()(vtkm::CellShapeTagGeneric shape,
const PointsVecType& points,
vtkm::Vec<T, 3>& normal) const
{
switch (shape.Id)
{
vtkmGenericCellShapeMacro(this->operator()(CellShapeTag(), points, normal));
default:
this->RaiseError("unknown cell type");
break;
}
}
private:
NormalFnctr Normal;
};
FacetedSurfaceNormals()
: Normalize(true)
{
}
/// Set/Get if the results should be normalized
void SetNormalize(bool value) { this->Normalize = value; }
bool GetNormalize() const { return this->Normalize; }
template <typename CellSetType,
typename CoordsCompType,
typename CoordsStorageType,
typename NormalCompType>
void Run(const CellSetType& cellset,
const vtkm::cont::ArrayHandle<vtkm::Vec<CoordsCompType, 3>, CoordsStorageType>& points,
vtkm::cont::ArrayHandle<vtkm::Vec<NormalCompType, 3>>& normals)
{
if (this->Normalize)
{
vtkm::worklet::DispatcherMapTopology<Worklet<>>().Invoke(cellset, points, normals);
}
else
{
vtkm::worklet::DispatcherMapTopology<Worklet<detail::PassThrough>>().Invoke(
cellset, points, normals);
}
}
template <typename CellSetType, typename NormalCompType>
void Run(const CellSetType& cellset,
const vtkm::cont::VariantArrayHandleBase<vtkm::TypeListTagFieldVec3>& points,
vtkm::cont::ArrayHandle<vtkm::Vec<NormalCompType, 3>>& normals)
{
if (this->Normalize)
{
vtkm::worklet::DispatcherMapTopology<Worklet<>>().Invoke(cellset, points, normals);
}
else
{
vtkm::worklet::DispatcherMapTopology<Worklet<detail::PassThrough>>().Invoke(
cellset, points, normals);
}
}
private:
bool Normalize;
};
class SmoothSurfaceNormals
{
public:
class Worklet : public vtkm::worklet::WorkletVisitPointsWithCells
{
public:
using ControlSignature = void(CellSetIn cellset,
FieldInCell faceNormals,
FieldOutPoint pointNormals);
using ExecutionSignature = void(CellCount, _2, _3);
using InputDomain = _1;
template <typename FaceNormalsVecType, typename T>
VTKM_EXEC void operator()(vtkm::IdComponent numCells,
const FaceNormalsVecType& faceNormals,
vtkm::Vec<T, 3>& pointNormal) const
{
if (numCells == 0)
{
pointNormal = vtkm::TypeTraits<vtkm::Vec<T, 3>>::ZeroInitialization();
}
else
{
auto result = faceNormals[0];
for (vtkm::IdComponent i = 1; i < numCells; ++i)
{
result += faceNormals[i];
}
pointNormal = vtkm::Normal(result);
}
}
};
template <typename CellSetType, typename NormalCompType, typename FaceNormalStorageType>
void Run(
const CellSetType& cellset,
const vtkm::cont::ArrayHandle<vtkm::Vec<NormalCompType, 3>, FaceNormalStorageType>& faceNormals,
vtkm::cont::ArrayHandle<vtkm::Vec<NormalCompType, 3>>& pointNormals)
{
vtkm::worklet::DispatcherMapTopology<Worklet>().Invoke(cellset, faceNormals, pointNormals);
}
template <typename CellSetType, typename FaceNormalTypeList, typename NormalCompType>
void Run(const CellSetType& cellset,
const vtkm::cont::VariantArrayHandleBase<FaceNormalTypeList>& faceNormals,
vtkm::cont::ArrayHandle<vtkm::Vec<NormalCompType, 3>>& pointNormals)
{
vtkm::worklet::DispatcherMapTopology<Worklet>().Invoke(cellset, faceNormals, pointNormals);
}
};
}
} // vtkm::worklet
#endif // vtk_m_worklet_SurfaceNormals_h