shapeworks::Mesh
Module: Mesh Classes
#include <Mesh.h>
Public Types
| Name | |
|---|---|
| enum | AlignmentType |
| enum | DistanceMethod |
| enum | CurvatureType |
| enum | SubdivisionType |
| using vtkSmartPointer< vtkPolyData > | MeshType |
Public Functions
| Name | |
|---|---|
| Mesh(const std::string & pathname) | |
| Mesh(MeshType meshPtr) | |
| Mesh(const Mesh & orig) | |
| Mesh(Mesh && orig) | |
| Mesh & | operator=(const Mesh & orig) |
| Mesh & | operator=(Mesh && orig) |
| Mesh & | operator+=(const Mesh & otherMesh) append two meshes |
| MeshType | getVTKMesh() const return the current mesh |
| Mesh & | write(const std::string & pathname, bool binaryFile =false) writes mesh, format specified by filename extension |
| Mesh & | coverage(const Mesh & otherMesh, bool allowBackIntersections =true, double angleThreshold =0, double backSearchRadius =0) determines coverage between current mesh and another mesh (e.g. acetabular cup / femoral head) |
| Mesh & | smooth(int iterations =0, double relaxation =0.0) applies laplacian smoothing |
| Mesh & | smoothSinc(int iterations =0, double passband =0.0) applies vtk windowed sinc smoothing |
| Mesh & | remesh(int numVertices, double adaptivity =1.0) applies remeshing using approximated centroidal voronoi diagrams for a given number of vertices and adaptivity |
| Mesh & | remeshPercent(double percentage, double adaptivity =1.0) applies remeshing using approximated centroidal voronoi diagrams for a given percentage of vertices and adaptivity |
| Mesh & | invertNormals() handle flipping normals |
| Mesh & | reflect(const Axis & axis, const Vector3 & origin =makeVector({ 0.0, 0.0, 0.0 })) reflect meshes with respect to a specified center and specific axis |
| MeshTransform | createTransform(const Mesh & target, AlignmentType align =Similarity, unsigned iterations =10) creates transform to target mesh using specified AlignmentType (Mesh::Rigid, Mesh::Similarity, Mesh::Affine) for specified number of iterations |
| Mesh & | applyTransform(const MeshTransform transform) applies the given transformation to the mesh |
| Mesh & | fillHoles() finds holes in a mesh and closes them |
| Mesh & | probeVolume(const Image & image) samples image data values at point locations specified by image |
| Mesh & | clip(const Plane plane) clips a mesh using a cutting plane |
| Mesh & | translate(const Vector3 & v) helper to translate mesh |
| Mesh & | scale(const Vector3 & v) helper to scale mesh |
| PhysicalRegion | boundingBox() const computes bounding box of current mesh |
| Mesh & | fixElement() fix element winding of mesh |
| Mesh & | distance(const Mesh & target, const DistanceMethod method =PointToPoint) computes surface to surface distance, compute method: PointToPoint (default) or PointToCell |
| Mesh & | clipClosedSurface(const Plane plane) clips a mesh using a cutting plane resulting in a closed surface |
| Mesh & | computeNormals() computes and adds oriented point and cell normals |
| Point3 | closestPoint(const Point3 point) returns closest point on a face in the mesh to the given point in space |
| int | closestPointId(const Point3 point) returns closest point id in this mesh to the given point in space |
| double | geodesicDistance(int source, int target) computes geodesic distance between two vertices (specified by their indices) on mesh |
| Field | geodesicDistance(const Point3 landmark) computes geodesic distance between a point (landmark) and each vertex on mesh |
| Field | geodesicDistance(const std::vector< Point3 > curve) computes geodesic distance between a set of points (curve) and each vertex on mesh |
| Field | curvature(const CurvatureType type =Principal) computes and adds curvature (principal (default) or gaussian or mean) |
| Mesh & | applySubdivisionFilter(const SubdivisionType type =Butterfly, int subdivision =1) applies subdivision filter (butterfly (default) or loop) |
| Image | toImage(PhysicalRegion region =PhysicalRegion(), Point spacing =Point({1., 1., 1.})) const rasterizes specified region to create binary image of desired dims (default: unit spacing) |
| Image | toDistanceTransform(PhysicalRegion region =PhysicalRegion(), Point spacing =Point({1., 1., 1.})) const converts specified region to distance transform image (default: unit spacing) |
| Point3 | center() const center of mesh |
| Point3 | centerOfMass() const center of mass of mesh |
| int | numPoints() const number of points |
| int | numFaces() const number of faces |
| Eigen::MatrixXd | points() const matrix with number of points with (x,y,z) coordinates of each point |
| Eigen::MatrixXi | faces() const matrix with number of faces with indices of the three points from which each face is composed |
| Point3 | getPoint(int id) const (x,y,z) coordinates of vertex at given index |
| IPoint3 | getFace(int id) const return indices of the three points with which the face at the given index is composed |
| std::vector< std::string > | getFieldNames() const print all field names in mesh |
| Mesh & | setField(std::string name, Array array) sets the given field for points with array (*does not copy array's values) |
| Mesh & | setFieldForFaces(std::string name, Array array) sets the given field for faces with array (*does not copy array's values) |
| template <typename T > vtkSmartPointer< T > |
getField(const std::string & name) const gets a pointer to the requested field, null if field doesn't exist |
| void | setFieldValue(const std::string & name, int idx, double value) sets the given index of field to value |
| double | getFieldValue(const std::string & name, int idx) const gets the value at the given index of field (NOTE: returns first component of vector fields) |
| Eigen::VectorXd | getMultiFieldValue(const std::string & name, int idx) const gets the multi value at the given index of field |
| std::vector< double > | getFieldRange(const std::string & name) const returns the range of the given field (NOTE: returns range of first component of vector fields) |
| double | getFieldMean(const std::string & name) const returns the mean the given field |
| double | getFieldStd(const std::string & name) const returns the standard deviation of the given field |
| bool | compareAllPoints(const Mesh & other_mesh) const compare if values of the points in two (corresponding) meshes are (eps)equal |
| bool | compareAllFaces(const Mesh & other_mesh) const compare if face indices in two (corresponding) meshes are equal |
| bool | compareAllFields(const Mesh & other_mesh, const double eps =-1.0) const compare if all fields in two meshes are (eps)equal |
| bool | compareField(const Mesh & other_mesh, const std::string & name1, const std::string & name2 ="", const double eps =-1.0) const compare field of meshes to be (eps)equal (same field for both if only one specified) |
| bool | compare(const Mesh & other_mesh, const double eps =-1.0) const compare meshes |
| bool | operator==(const Mesh & other) const compare meshes |
| bool | splitMesh(std::vector< std::vector< Eigen::Vector3d > > boundaries, Eigen::Vector3d query, size_t dom, size_t num) Splits the mesh for FFCs by setting scalar and vector fields. |
| double | getFFCValue(Eigen::Vector3d query) Gets values and gradients for FFCs. |
| Eigen::Vector3d | getFFCGradient(Eigen::Vector3d query) |
| vtkSmartPointer< vtkPoints > | getIGLMesh(Eigen::MatrixXd & V, Eigen::MatrixXi & F) const Formats mesh into an IGL format. |
| std::vector< std::string > | getSupportedTypes() getSupportedTypes |
Friends
| Name | |
|---|---|
| struct | SharedCommandData |
Detailed Description
class shapeworks::Mesh;
This class encapsulates a Mesh and operations that can be performed on meshes
Public Types Documentation
enum AlignmentType
| Enumerator | Value | Description |
|---|---|---|
| Rigid | ||
| Similarity | ||
| Affine |
enum DistanceMethod
| Enumerator | Value | Description |
|---|---|---|
| PointToPoint | ||
| PointToCell |
enum CurvatureType
| Enumerator | Value | Description |
|---|---|---|
| Principal | ||
| Gaussian | ||
| Mean |
enum SubdivisionType
| Enumerator | Value | Description |
|---|---|---|
| Butterfly | ||
| Loop |
using MeshType
using shapeworks::Mesh::MeshType = vtkSmartPointer<vtkPolyData>;
Public Functions Documentation
function Mesh
inline Mesh(
const std::string & pathname
)
function Mesh
inline Mesh(
MeshType meshPtr
)
function Mesh
inline Mesh(
const Mesh & orig
)
function Mesh
inline Mesh(
Mesh && orig
)
function operator=
inline Mesh & operator=(
const Mesh & orig
)
function operator=
inline Mesh & operator=(
Mesh && orig
)
function operator+=
Mesh & operator+=(
const Mesh & otherMesh
)
append two meshes
function getVTKMesh
inline MeshType getVTKMesh() const
return the current mesh
function write
Mesh & write(
const std::string & pathname,
bool binaryFile =false
)
writes mesh, format specified by filename extension
function coverage
Mesh & coverage(
const Mesh & otherMesh,
bool allowBackIntersections =true,
double angleThreshold =0,
double backSearchRadius =0
)
determines coverage between current mesh and another mesh (e.g. acetabular cup / femoral head)
function smooth
Mesh & smooth(
int iterations =0,
double relaxation =0.0
)
applies laplacian smoothing
function smoothSinc
Mesh & smoothSinc(
int iterations =0,
double passband =0.0
)
applies vtk windowed sinc smoothing
function remesh
Mesh & remesh(
int numVertices,
double adaptivity =1.0
)
applies remeshing using approximated centroidal voronoi diagrams for a given number of vertices and adaptivity
function remeshPercent
Mesh & remeshPercent(
double percentage,
double adaptivity =1.0
)
applies remeshing using approximated centroidal voronoi diagrams for a given percentage of vertices and adaptivity
function invertNormals
Mesh & invertNormals()
handle flipping normals
function reflect
Mesh & reflect(
const Axis & axis,
const Vector3 & origin =makeVector({ 0.0, 0.0, 0.0 })
)
reflect meshes with respect to a specified center and specific axis
function createTransform
MeshTransform createTransform(
const Mesh & target,
AlignmentType align =Similarity,
unsigned iterations =10
)
creates transform to target mesh using specified AlignmentType (Mesh::Rigid, Mesh::Similarity, Mesh::Affine) for specified number of iterations
function applyTransform
Mesh & applyTransform(
const MeshTransform transform
)
applies the given transformation to the mesh
function fillHoles
Mesh & fillHoles()
finds holes in a mesh and closes them
function probeVolume
Mesh & probeVolume(
const Image & image
)
samples image data values at point locations specified by image
function clip
Mesh & clip(
const Plane plane
)
clips a mesh using a cutting plane
function translate
Mesh & translate(
const Vector3 & v
)
helper to translate mesh
function scale
Mesh & scale(
const Vector3 & v
)
helper to scale mesh
function boundingBox
PhysicalRegion boundingBox() const
computes bounding box of current mesh
function fixElement
Mesh & fixElement()
fix element winding of mesh
function distance
Mesh & distance(
const Mesh & target,
const DistanceMethod method =PointToPoint
)
computes surface to surface distance, compute method: PointToPoint (default) or PointToCell
function clipClosedSurface
Mesh & clipClosedSurface(
const Plane plane
)
clips a mesh using a cutting plane resulting in a closed surface
function computeNormals
Mesh & computeNormals()
computes and adds oriented point and cell normals
function closestPoint
Point3 closestPoint(
const Point3 point
)
returns closest point on a face in the mesh to the given point in space
function closestPointId
int closestPointId(
const Point3 point
)
returns closest point id in this mesh to the given point in space
function geodesicDistance
double geodesicDistance(
int source,
int target
)
computes geodesic distance between two vertices (specified by their indices) on mesh
function geodesicDistance
Field geodesicDistance(
const Point3 landmark
)
computes geodesic distance between a point (landmark) and each vertex on mesh
function geodesicDistance
Field geodesicDistance(
const std::vector< Point3 > curve
)
computes geodesic distance between a set of points (curve) and each vertex on mesh
function curvature
Field curvature(
const CurvatureType type =Principal
)
computes and adds curvature (principal (default) or gaussian or mean)
function applySubdivisionFilter
Mesh & applySubdivisionFilter(
const SubdivisionType type =Butterfly,
int subdivision =1
)
applies subdivision filter (butterfly (default) or loop)
function toImage
Image toImage(
PhysicalRegion region =PhysicalRegion(),
Point spacing =Point({1., 1., 1.})
) const
rasterizes specified region to create binary image of desired dims (default: unit spacing)
function toDistanceTransform
Image toDistanceTransform(
PhysicalRegion region =PhysicalRegion(),
Point spacing =Point({1., 1., 1.})
) const
converts specified region to distance transform image (default: unit spacing)
function center
Point3 center() const
center of mesh
function centerOfMass
Point3 centerOfMass() const
center of mass of mesh
function numPoints
inline int numPoints() const
number of points
function numFaces
inline int numFaces() const
number of faces
function points
Eigen::MatrixXd points() const
matrix with number of points with (x,y,z) coordinates of each point
function faces
Eigen::MatrixXi faces() const
matrix with number of faces with indices of the three points from which each face is composed
function getPoint
Point3 getPoint(
int id
) const
(x,y,z) coordinates of vertex at given index
function getFace
IPoint3 getFace(
int id
) const
return indices of the three points with which the face at the given index is composed
function getFieldNames
std::vector< std::string > getFieldNames() const
print all field names in mesh
function setField
Mesh & setField(
std::string name,
Array array
)
sets the given field for points with array (*does not copy array's values)
function setFieldForFaces
Mesh & setFieldForFaces(
std::string name,
Array array
)
sets the given field for faces with array (*does not copy array's values)
function getField
template <typename T >
inline vtkSmartPointer< T > getField(
const std::string & name
) const
gets a pointer to the requested field, null if field doesn't exist
function setFieldValue
void setFieldValue(
const std::string & name,
int idx,
double value
)
sets the given index of field to value
function getFieldValue
double getFieldValue(
const std::string & name,
int idx
) const
gets the value at the given index of field (NOTE: returns first component of vector fields)
function getMultiFieldValue
Eigen::VectorXd getMultiFieldValue(
const std::string & name,
int idx
) const
gets the multi value at the given index of field
function getFieldRange
std::vector< double > getFieldRange(
const std::string & name
) const
returns the range of the given field (NOTE: returns range of first component of vector fields)
function getFieldMean
double getFieldMean(
const std::string & name
) const
returns the mean the given field
function getFieldStd
double getFieldStd(
const std::string & name
) const
returns the standard deviation of the given field
function compareAllPoints
bool compareAllPoints(
const Mesh & other_mesh
) const
compare if values of the points in two (corresponding) meshes are (eps)equal
function compareAllFaces
bool compareAllFaces(
const Mesh & other_mesh
) const
compare if face indices in two (corresponding) meshes are equal
function compareAllFields
bool compareAllFields(
const Mesh & other_mesh,
const double eps =-1.0
) const
compare if all fields in two meshes are (eps)equal
function compareField
bool compareField(
const Mesh & other_mesh,
const std::string & name1,
const std::string & name2 ="",
const double eps =-1.0
) const
compare field of meshes to be (eps)equal (same field for both if only one specified)
function compare
bool compare(
const Mesh & other_mesh,
const double eps =-1.0
) const
compare meshes
function operator==
inline bool operator==(
const Mesh & other
) const
compare meshes
function splitMesh
bool splitMesh(
std::vector< std::vector< Eigen::Vector3d > > boundaries,
Eigen::Vector3d query,
size_t dom,
size_t num
)
Splits the mesh for FFCs by setting scalar and vector fields.
function getFFCValue
double getFFCValue(
Eigen::Vector3d query
)
Gets values and gradients for FFCs.
function getFFCGradient
Eigen::Vector3d getFFCGradient(
Eigen::Vector3d query
)
function getIGLMesh
vtkSmartPointer< vtkPoints > getIGLMesh(
Eigen::MatrixXd & V,
Eigen::MatrixXi & F
) const
Formats mesh into an IGL format.
function getSupportedTypes
static inline std::vector< std::string > getSupportedTypes()
getSupportedTypes
Friends
friend SharedCommandData
friend struct SharedCommandData();
Updated on 2022-03-31 at 09:51:19 -0600