//============================================================================ // 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. // // Copyright 2017 National Technology & Engineering Solutions of Sandia, LLC (NTESS). // Copyright 2017 UT-Battelle, LLC. // Copyright 2017 Los Alamos National Security. // // Under the terms of Contract DE-NA0003525 with NTESS, // the U.S. Government retains certain rights in this software. // // Under the terms of Contract DE-AC52-06NA25396 with Los Alamos National // Laboratory (LANL), the U.S. Government retains certain rights in // this software. //============================================================================ #ifndef vtk_m_ImplicitFunction_h #define vtk_m_ImplicitFunction_h #include #include #include namespace vtkm { //============================================================================ class VTKM_ALWAYS_EXPORT ImplicitFunction : public vtkm::VirtualObjectBase { public: using Scalar = vtkm::FloatDefault; using Vector = vtkm::Vec; VTKM_EXEC_CONT virtual Scalar Value(const Vector& point) const = 0; VTKM_EXEC_CONT virtual Vector Gradient(const Vector& point) const = 0; VTKM_EXEC_CONT Scalar Value(Scalar x, Scalar y, Scalar z) const { return this->Value(Vector(x, y, z)); } VTKM_EXEC_CONT Vector Gradient(Scalar x, Scalar y, Scalar z) const { return this->Gradient(Vector(x, y, z)); } }; //============================================================================ /// A helpful functor that calls the (virtual) value method of a given ImplicitFunction. Can be /// passed to things that expect a functor instead of an ImplictFunction class (like an array /// transform). /// class VTKM_ALWAYS_EXPORT ImplicitFunctionValue { public: using Scalar = vtkm::ImplicitFunction::Scalar; using Vector = vtkm::ImplicitFunction::Vector; VTKM_EXEC_CONT ImplicitFunctionValue() : Function(nullptr) { } VTKM_EXEC_CONT ImplicitFunctionValue(const ImplicitFunction* function) : Function(function) { } VTKM_EXEC_CONT Scalar operator()(const Vector& point) const { return this->Function->Value(point); } private: const vtkm::ImplicitFunction* Function; }; /// A helpful functor that calls the (virtual) gradient method of a given ImplicitFunction. Can be /// passed to things that expect a functor instead of an ImplictFunction class (like an array /// transform). /// class VTKM_ALWAYS_EXPORT ImplicitFunctionGradient { public: using Scalar = vtkm::ImplicitFunction::Scalar; using Vector = vtkm::ImplicitFunction::Vector; VTKM_EXEC_CONT ImplicitFunctionGradient() : Function(nullptr) { } VTKM_EXEC_CONT ImplicitFunctionGradient(const ImplicitFunction* function) : Function(function) { } VTKM_EXEC_CONT Vector operator()(const Vector& point) const { return this->Function->Gradient(point); } private: const vtkm::ImplicitFunction* Function; }; //============================================================================ /// \brief Implicit function for a box class VTKM_ALWAYS_EXPORT Box : public ImplicitFunction { public: VTKM_EXEC_CONT Box() : MinPoint(Vector(Scalar(0))) , MaxPoint(Vector(Scalar(0))) { } VTKM_EXEC_CONT Box(const Vector& minPoint, const Vector& maxPoint) : MinPoint(minPoint) , MaxPoint(maxPoint) { } VTKM_EXEC_CONT Box(Scalar xmin, Scalar xmax, Scalar ymin, Scalar ymax, Scalar zmin, Scalar zmax) : MinPoint(xmin, ymin, zmin) , MaxPoint(xmax, ymax, zmax) { } VTKM_CONT void SetMinPoint(const Vector& point) { this->MinPoint = point; this->Modified(); } VTKM_CONT void SetMaxPoint(const Vector& point) { this->MaxPoint = point; this->Modified(); } VTKM_EXEC_CONT const Vector& GetMinPoint() const { return this->MinPoint; } VTKM_EXEC_CONT const Vector& GetMaxPoint() const { return this->MaxPoint; } VTKM_EXEC_CONT Scalar Value(const Vector& point) const override { Scalar minDistance = vtkm::NegativeInfinity32(); Scalar diff, t, dist; Scalar distance = Scalar(0.0); vtkm::IdComponent inside = 1; for (vtkm::IdComponent d = 0; d < 3; d++) { diff = this->MaxPoint[d] - this->MinPoint[d]; if (diff != Scalar(0.0)) { t = (point[d] - this->MinPoint[d]) / diff; // Outside before the box if (t < Scalar(0.0)) { inside = 0; dist = this->MinPoint[d] - point[d]; } // Outside after the box else if (t > Scalar(1.0)) { inside = 0; dist = point[d] - this->MaxPoint[d]; } else { // Inside the box in lower half if (t <= Scalar(0.5)) { dist = MinPoint[d] - point[d]; } // Inside the box in upper half else { dist = point[d] - MaxPoint[d]; } if (dist > minDistance) { minDistance = dist; } } } else { dist = vtkm::Abs(point[d] - MinPoint[d]); if (dist > Scalar(0.0)) { inside = 0; } } if (dist > Scalar(0.0)) { distance += dist * dist; } } distance = vtkm::Sqrt(distance); if (inside) { return minDistance; } else { return distance; } } VTKM_EXEC_CONT Vector Gradient(const Vector& point) const override { vtkm::IdComponent minAxis = 0; Scalar dist = 0.0; Scalar minDist = vtkm::Infinity32(); vtkm::Vec location; Vector normal(Scalar(0)); Vector inside(Scalar(0)); Vector outside(Scalar(0)); Vector center((this->MaxPoint + this->MinPoint) * Scalar(0.5)); // Compute the location of the point with respect to the box // Point will lie in one of 27 separate regions around or within the box // Gradient vector is computed differently in each of the regions. for (vtkm::IdComponent d = 0; d < 3; d++) { if (point[d] < this->MinPoint[d]) { // Outside the box low end location[d] = 0; outside[d] = -1.0; } else if (point[d] > this->MaxPoint[d]) { // Outside the box high end location[d] = 2; outside[d] = 1.0; } else { location[d] = 1; if (point[d] <= center[d]) { // Inside the box low end dist = point[d] - this->MinPoint[d]; inside[d] = -1.0; } else { // Inside the box high end dist = this->MaxPoint[d] - point[d]; inside[d] = 1.0; } if (dist < minDist) // dist is negative { minDist = dist; minAxis = d; } } } vtkm::Id indx = location[0] + 3 * location[1] + 9 * location[2]; switch (indx) { // verts - gradient points away from center point case 0: case 2: case 6: case 8: case 18: case 20: case 24: case 26: for (vtkm::IdComponent d = 0; d < 3; d++) { normal[d] = point[d] - center[d]; } vtkm::Normalize(normal); break; // edges - gradient points out from axis of cube case 1: case 3: case 5: case 7: case 9: case 11: case 15: case 17: case 19: case 21: case 23: case 25: for (vtkm::IdComponent d = 0; d < 3; d++) { if (outside[d] != 0.0) { normal[d] = point[d] - center[d]; } else { normal[d] = 0.0; } } vtkm::Normalize(normal); break; // faces - gradient points perpendicular to face case 4: case 10: case 12: case 14: case 16: case 22: for (vtkm::IdComponent d = 0; d < 3; d++) { normal[d] = outside[d]; } break; // interior - gradient is perpendicular to closest face case 13: normal[0] = normal[1] = normal[2] = 0.0; normal[minAxis] = inside[minAxis]; break; default: VTKM_ASSERT(false); break; } return normal; } private: Vector MinPoint; Vector MaxPoint; }; //============================================================================ /// \brief Implicit function for a cylinder class VTKM_ALWAYS_EXPORT Cylinder : public vtkm::ImplicitFunction { public: VTKM_EXEC_CONT Cylinder() : Center(Scalar(0)) , Axis(Scalar(1), Scalar(0), Scalar(0)) , Radius(Scalar(0.2)) { } VTKM_EXEC_CONT Cylinder(const Vector& axis, Scalar radius) : Center(Scalar(0)) , Axis(axis) , Radius(radius) { } VTKM_EXEC_CONT Cylinder(const Vector& center, const Vector& axis, Scalar radius) : Center(center) , Axis(axis) , Radius(radius) { } VTKM_CONT void SetCenter(const Vector& center) { this->Center = center; this->Modified(); } VTKM_CONT void SetAxis(const Vector& axis) { this->Axis = axis; this->Modified(); } VTKM_CONT void SetRadius(Scalar radius) { this->Radius = radius; this->Modified(); } VTKM_EXEC_CONT Scalar Value(const Vector& point) const override { Vector x2c = point - this->Center; FloatDefault proj = vtkm::dot(this->Axis, x2c); return vtkm::dot(x2c, x2c) - (proj * proj) - (this->Radius * this->Radius); } VTKM_EXEC_CONT Vector Gradient(const Vector& point) const override { Vector x2c = point - this->Center; FloatDefault t = this->Axis[0] * x2c[0] + this->Axis[1] * x2c[1] + this->Axis[2] * x2c[2]; vtkm::Vec closestPoint = this->Center + (this->Axis * t); return (point - closestPoint) * FloatDefault(2); } private: Vector Center; Vector Axis; Scalar Radius; }; //============================================================================ /// \brief Implicit function for a frustum class VTKM_ALWAYS_EXPORT Frustum : public vtkm::ImplicitFunction { public: Frustum() = default; VTKM_EXEC_CONT Frustum(const Vector points[6], const Vector normals[6]) { this->SetPlanes(points, normals); } VTKM_EXEC_CONT explicit Frustum(const Vector points[8]) { this->CreateFromPoints(points); } VTKM_EXEC void SetPlanes(const Vector points[6], const Vector normals[6]) { for (vtkm::Id index : { 0, 1, 2, 3, 4, 5 }) { this->Points[index] = points[index]; } for (vtkm::Id index : { 0, 1, 2, 3, 4, 5 }) { this->Normals[index] = normals[index]; } this->Modified(); } VTKM_EXEC void SetPlane(int idx, const Vector& point, const Vector& normal) { VTKM_ASSERT((idx >= 0) && (idx < 6)); this->Points[idx] = point; this->Normals[idx] = normal; this->Modified(); } VTKM_EXEC_CONT void GetPlanes(Vector points[6], Vector normals[6]) const { for (vtkm::Id index : { 0, 1, 2, 3, 4, 5 }) { points[index] = this->Points[index]; } for (vtkm::Id index : { 0, 1, 2, 3, 4, 5 }) { normals[index] = this->Normals[index]; } } VTKM_EXEC_CONT const Vector* GetPoints() const { return this->Points; } VTKM_EXEC_CONT const Vector* GetNormals() const { return this->Normals; } // The points should be specified in the order of hex-cell vertices VTKM_EXEC_CONT void CreateFromPoints(const Vector points[8]) { // XXX(clang-format-3.9): 3.8 is silly. 3.9 makes it look like this. // clang-format off int planes[6][3] = { { 3, 2, 0 }, { 4, 5, 7 }, { 0, 1, 4 }, { 1, 2, 5 }, { 2, 3, 6 }, { 3, 0, 7 } }; // clang-format on for (int i = 0; i < 6; ++i) { const Vector& v0 = points[planes[i][0]]; const Vector& v1 = points[planes[i][1]]; const Vector& v2 = points[planes[i][2]]; this->Points[i] = v0; this->Normals[i] = vtkm::Normal(vtkm::Cross(v2 - v0, v1 - v0)); } this->Modified(); } VTKM_EXEC_CONT Scalar Value(const Vector& point) const override { Scalar maxVal = vtkm::NegativeInfinity(); for (vtkm::Id index : { 0, 1, 2, 3, 4, 5 }) { const Vector& p = this->Points[index]; const Vector& n = this->Normals[index]; const Scalar val = vtkm::dot(point - p, n); maxVal = vtkm::Max(maxVal, val); } return maxVal; } VTKM_EXEC_CONT Vector Gradient(const Vector& point) const override { Scalar maxVal = vtkm::NegativeInfinity(); vtkm::Id maxValIdx = 0; for (vtkm::Id index : { 0, 1, 2, 3, 4, 5 }) { const Vector& p = this->Points[index]; const Vector& n = this->Normals[index]; Scalar val = vtkm::dot(point - p, n); if (val > maxVal) { maxVal = val; maxValIdx = index; } } return this->Normals[maxValIdx]; } private: Vector Points[6]; Vector Normals[6]; }; //============================================================================ /// \brief Implicit function for a plane class VTKM_ALWAYS_EXPORT Plane : public vtkm::ImplicitFunction { public: VTKM_EXEC_CONT Plane() : Origin(Scalar(0)) , Normal(Scalar(0), Scalar(0), Scalar(1)) { } VTKM_EXEC_CONT explicit Plane(const Vector& normal) : Origin(Scalar(0)) , Normal(normal) { } VTKM_EXEC_CONT Plane(const Vector& origin, const Vector& normal) : Origin(origin) , Normal(normal) { } VTKM_CONT void SetOrigin(const Vector& origin) { this->Origin = origin; this->Modified(); } VTKM_CONT void SetNormal(const Vector& normal) { this->Normal = normal; this->Modified(); } VTKM_EXEC_CONT const Vector& GetOrigin() const { return this->Origin; } VTKM_EXEC_CONT const Vector& GetNormal() const { return this->Normal; } VTKM_EXEC_CONT Scalar Value(const Vector& point) const override { return vtkm::dot(point - this->Origin, this->Normal); } VTKM_EXEC_CONT Vector Gradient(const Vector&) const override { return this->Normal; } private: Vector Origin; Vector Normal; }; //============================================================================ /// \brief Implicit function for a sphere class VTKM_ALWAYS_EXPORT Sphere : public vtkm::ImplicitFunction { public: VTKM_EXEC_CONT Sphere() : Radius(Scalar(0.2)) , Center(Scalar(0)) { } VTKM_EXEC_CONT explicit Sphere(Scalar radius) : Radius(radius) , Center(Scalar(0)) { } VTKM_EXEC_CONT Sphere(Vector center, Scalar radius) : Radius(radius) , Center(center) { } VTKM_CONT void SetRadius(Scalar radius) { this->Radius = radius; this->Modified(); } VTKM_CONT void SetCenter(const Vector& center) { this->Center = center; this->Modified(); } VTKM_EXEC_CONT Scalar GetRadius() const { return this->Radius; } VTKM_EXEC_CONT const Vector& GetCenter() const { return this->Center; } VTKM_EXEC_CONT Scalar Value(const Vector& point) const override { return vtkm::MagnitudeSquared(point - this->Center) - (this->Radius * this->Radius); } VTKM_EXEC_CONT Vector Gradient(const Vector& point) const override { return Scalar(2) * (point - this->Center); } private: Scalar Radius; Vector Center; }; } // namespace vtkm #ifdef VTKM_CUDA // Cuda seems to have a bug where it expects the template class VirtualObjectTransfer // to be instantiated in a consitent order among all the translation units of an // executable. Failing to do so results in random crashes and incorrect results. // We workaroud this issue by explicitly instantiating VirtualObjectTransfer for // all the implicit functions here. #include VTKM_EXPLICITLY_INSTANTIATE_TRANSFER(vtkm::Box); VTKM_EXPLICITLY_INSTANTIATE_TRANSFER(vtkm::Cylinder); VTKM_EXPLICITLY_INSTANTIATE_TRANSFER(vtkm::Frustum); VTKM_EXPLICITLY_INSTANTIATE_TRANSFER(vtkm::Plane); VTKM_EXPLICITLY_INSTANTIATE_TRANSFER(vtkm::Sphere); #endif #endif //vtk_m_ImplicitFunction_h