mirror of
https://gitlab.kitware.com/vtk/vtk-m
synced 2024-09-19 10:35:42 +00:00
5db762ee71
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 ```
75 lines
2.4 KiB
C++
75 lines
2.4 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_exec_arg_IncidentElementCount_h
|
|
#define vtk_m_exec_arg_IncidentElementCount_h
|
|
|
|
#include <vtkm/exec/arg/ExecutionSignatureTagBase.h>
|
|
#include <vtkm/exec/arg/Fetch.h>
|
|
#include <vtkm/exec/arg/ThreadIndicesTopologyMap.h>
|
|
|
|
namespace vtkm
|
|
{
|
|
namespace exec
|
|
{
|
|
namespace arg
|
|
{
|
|
|
|
/// \brief Aspect tag to use for getting the incident element count.
|
|
///
|
|
/// The \c AspectTagIncidentElementCount aspect tag causes the \c Fetch class to
|
|
/// obtain the number of indices that map to the current topology element.
|
|
///
|
|
struct AspectTagIncidentElementCount
|
|
{
|
|
};
|
|
|
|
/// \brief The \c ExecutionSignature tag to get the number of incident elements.
|
|
///
|
|
/// In a topology map, there are \em visited and \em incident topology elements
|
|
/// specified. The scheduling occurs on the \em visited elements, and for each
|
|
/// \em visited element there is some number of incident \em incident elements
|
|
/// that are accessible. This \c ExecutionSignature tag provides the number of
|
|
/// these \em incident elements that are accessible.
|
|
///
|
|
struct IncidentElementCount : vtkm::exec::arg::ExecutionSignatureTagBase
|
|
{
|
|
static constexpr vtkm::IdComponent INDEX = 1;
|
|
using AspectTag = vtkm::exec::arg::AspectTagIncidentElementCount;
|
|
};
|
|
|
|
template <typename FetchTag, typename ConnectivityType, typename ExecObjectType>
|
|
struct Fetch<FetchTag,
|
|
vtkm::exec::arg::AspectTagIncidentElementCount,
|
|
vtkm::exec::arg::ThreadIndicesTopologyMap<ConnectivityType>,
|
|
ExecObjectType>
|
|
{
|
|
using ThreadIndicesType = vtkm::exec::arg::ThreadIndicesTopologyMap<ConnectivityType>;
|
|
|
|
using ValueType = vtkm::IdComponent;
|
|
|
|
VTKM_SUPPRESS_EXEC_WARNINGS
|
|
VTKM_EXEC
|
|
ValueType Load(const ThreadIndicesType& indices, const ExecObjectType&) const
|
|
{
|
|
return indices.GetIndicesIncident().GetNumberOfComponents();
|
|
}
|
|
|
|
VTKM_EXEC
|
|
void Store(const ThreadIndicesType&, const ExecObjectType&, const ValueType&) const
|
|
{
|
|
// Store is a no-op.
|
|
}
|
|
};
|
|
}
|
|
}
|
|
} // namespace vtkm::exec::arg
|
|
|
|
#endif //vtk_m_exec_arg_IncidentElementCount_h
|