SoSurfaceFittingApproximation3d Class Reference
[Computational Geometry]

SoSurfaceFittingApproximation3d surface approximation. More...

#include <ImageViz/Engines/ImageSegmentation/ComputationalGeometry/SoSurfaceFittingApproximation3d.h>

Inheritance diagram for SoSurfaceFittingApproximation3d:

List of all members.

Public Types
enum	DetectionType {   MAXIMUM,   MINIMUM }
enum	BoundaryCondition {   DIRICHLET,   NEUMANN }
enum	RegularizationType {   LAPLACIAN,   LAPLACIAN_2 }
Public Member Functions
	SoSurfaceFittingApproximation3d ()
Public Attributes
SoSFStructuredQuadrilateralMesh	inSurface
SoSFImageDataAdapter	inFeatureImage
SoSFDouble	distance
SoSFVec2d	thresholdLevel
SoSFFloat	smoothing
SoMFVec3f	directions
SoSFEnum	detectionType
SoSFEnum	leftBoundaryCondition
SoSFEnum	rightBoundaryCondition
SoSFEnum	topBoundaryCondition
SoSFEnum	bottomBoundaryCondition
SoSFEnum	regularizationType
SoMFFloat	dirichletValues
SoImageVizEngineOutput < SoSFStructuredQuadrilateralMesh, SbStructuredQuadrilateralMesh * >	outSurface
SoImageVizEngineMFieldOutput < SoMFVec3f, const SbVec3f * >	outDirections

---

Detailed Description

SoSurfaceFittingApproximation3d surface approximation.

This engine adjusts the positions of the vertices in a structured quadrilateral mesh based on "weight" values given in a volume. These values normally represent some features / structures in the volume, e.g. weights could be the distance to the outside of a wall.

The engine will search for a best fit along a direction specified for each vertex (the vertex surface normal by be default) up to a distance defined by the parameter distance. A voxel will be considered as a best fit based on a criterion given by the detectionType. A regularization can be applied on the resulting surface to smooth it and limit the effect of outliers.

FILE FORMAT/DEFAULT

SoSurfaceFittingApproximation3d {

inSurface	NULL
inFeatureImage	NULL
distance	1.0
thresholdLevel	SbVec2d( 0.0, std::numeric_limits<double>::max() )
smoothing	1.0f
directions	SbVec3f( 0.0f, 0.0f, 0.0f )
detectionType	MAXIMUM

}

SEE ALSO

SoPolylineExtrusionApproximation3d, SoSurfaceUnfoldingProcessing3d

Library references:

See related examples:

MedicalDentalSurfaceUnfolding

---

Member Enumeration Documentation

enum SoSurfaceFittingApproximation3d::BoundaryCondition

Define the type of supported boundaries condition.

Enumerator:

DIRICHLET
NEUMANN

enum SoSurfaceFittingApproximation3d::DetectionType

Enumerator:

MAXIMUM	Uses the maximum value.
MINIMUM	Uses the minimum value.

enum SoSurfaceFittingApproximation3d::RegularizationType

The type of regularization applied to the mesh.

Enumerator:

LAPLACIAN
LAPLACIAN_2

---

Constructor & Destructor Documentation

SoSurfaceFittingApproximation3d::SoSurfaceFittingApproximation3d

(

)

Constructor.

---

Member Data Documentation

SoSFEnum SoSurfaceFittingApproximation3d::bottomBoundaryCondition

The type of boundary conditions for the bottom boundary.

SoSFEnum SoSurfaceFittingApproximation3d::detectionType

Defines the criterion on which a vertex will be kept as the best fit.

Use enum DetectionType. Default is MAXIMUM.

SoMFVec3f SoSurfaceFittingApproximation3d::directions

Defines the search direction for each vertex.

If the field is empty or if its size is different from the input surface number of vertices, the vertex normals are used as directions. Default value is SbVec3f( 0.0f, 0.0f, 0.0f ), so by default vertex normals are computed for the surface.

SoMFFloat SoSurfaceFittingApproximation3d::dirichletValues

Dirichlet values for left, right, top and bottom boundary conditions.

SoSFDouble SoSurfaceFittingApproximation3d::distance

Defines the maximum distance that vertices can be moved.

This distance is expressed in world coordinates of the input mesh. Default is 1.

SoSFImageDataAdapter SoSurfaceFittingApproximation3d::inFeatureImage

Input 3D image containing weight values.

SoSFStructuredQuadrilateralMesh SoSurfaceFittingApproximation3d::inSurface

Input surface.

SoSFEnum SoSurfaceFittingApproximation3d::leftBoundaryCondition

The type of boundary conditions for the left boundary.

SoImageVizEngineMFieldOutput< SoMFVec3f, const SbVec3f*> SoSurfaceFittingApproximation3d::outDirections

Directions along which the most fitted value was searched.

SoImageVizEngineOutput<SoSFStructuredQuadrilateralMesh, SbStructuredQuadrilateralMesh*> SoSurfaceFittingApproximation3d::outSurface

Output surface with fitted vertices.

SoSFEnum SoSurfaceFittingApproximation3d::regularizationType

The type of regularization used to enforce the smoothness of the mesh.

SoSFEnum SoSurfaceFittingApproximation3d::rightBoundaryCondition

The type of boundary conditions for the right boundary.

SoSFFloat SoSurfaceFittingApproximation3d::smoothing

A regularization is applied on the fitted mesh in order to smooth it and limit the effect of outliers.

The smoothing factor defines the strength of this regularization. The greater the value is the greater the smoothing will be. A smoothing value of 0 will disable the regularization. Default is 1.

SoSFVec2d SoSurfaceFittingApproximation3d::thresholdLevel

Defines a range of values that can be considered for the best fit.

A value outside of this range will be considered as an outlier. Default is full range of double precision values.

SoSFEnum SoSurfaceFittingApproximation3d::topBoundaryCondition

The type of boundary conditions for the top boundary.

---

The documentation for this class was generated from the following file:

• ImageViz/Engines/ImageSegmentation/ComputationalGeometry/SoSurfaceFittingApproximation3d.h