Functions

Classes
struct	CGAL::Mesh_smoothing_3::Smoothing_status
	Status of the mesh smoothing process. More...

Enumerations
enum class	CGAL::Mesh_smoothing_3::Smoothing_return_code { Smoothing_return_code::ALL_VERTICES_FROZEN , Smoothing_return_code::CONVERGENCE_REACHED , Smoothing_return_code::MAX_NUMBER_OF_METRIC_EVALUATIONS_REACHED , Smoothing_return_code::TIME_LIMIT_REACHED }
	Return codes of the mesh smoothing. More...

Functions
template<typename C3t3, typename CTS, typename NamedParameters = parameters::Default_named_parameters>
Mesh_smoothing_3::Smoothing_status	CGAL::boundary_aware_mesh_smoothing (C3t3 &c3t3, CTS const &cts, NamedParameters const &np=parameters::default_values())
	smooths a tetrahedral mesh while preserving the boundary and curve features.

Enumeration Type Documentation

Smoothing_return_code

enum class CGAL::Mesh_smoothing_3::Smoothing_return_code

strong

#include <CGAL/Mesh_smoothing_3/Smoothing_status.h>

Return codes of the mesh smoothing.

Enumerator
ALL_VERTICES_FROZEN	All vertices are frozen.
CONVERGENCE_REACHED	Convergence reached.
MAX_NUMBER_OF_METRIC_EVALUATIONS_REACHED	Maximum number of metric evaluations reached.
TIME_LIMIT_REACHED	Time limit reached.

Function Documentation

boundary_aware_mesh_smoothing()

template<typename C3t3, typename CTS, typename NamedParameters = parameters::Default_named_parameters>

Mesh_smoothing_3::Smoothing_status CGAL::boundary_aware_mesh_smoothing	(	C3t3 &	c3t3,
		CTS const &	cts,
		NamedParameters const &	np = parameters::default_values() )

#include <CGAL/Mesh_smoothing_3/boundary_aware_mesh_smoothing.h>

smooths a tetrahedral mesh while preserving the boundary and curve features.

This function takes as input a tetrahedral mesh and will iteratively move its vertices to improve the quality of the tetrahedra while preserving (softly) the boundary and curve features through projection queries. Vertices will stay close to their original entity (surface patch or curve). Corners are locked on their original position. The algorithm will recover curvature discontinuities (sharp features) in a patch, and is capable of recovering inverted tetrahedra in the mesh. An input mesh with only positively oriented tetrahedra is guaranteed to remain so during the smoothing procedure.

Warning

This function updates vertex positions without modifying connectivity, and therefore does not preserve Delaunay properties.

Template Parameters

C3t3	model of MeshComplex_3InTriangulation_3
CTS	model of ConstructTangentSpace
NamedParameters	a sequence of Named Parameters

Parameters

c3t3	tetrahedral mesh to smooth.
cts	support to re-project faces and edges on their respective patches and curves.
np	optional sequence of Named Parameters among the ones listed below

Optional Named Parameters

verbose If true, the function prints information about the smoothing process to the standard output. Type: bool Default: false
maximum_running_time Maximum allowed time for the smoothing process in seconds. Type: double Default: 0., indicating no time limit.
max_number_of_evaluations Maximum number of quality metric evaluations for smoothing. Type: unsigned int Default: 10000 Extra: Metric evaluations will be used to find improved point locations. Increase the value if the algorithm has not converged yet. It is strongly correlated to running time but will scale linearly with mesh size.
concurrency_tag a tag indicating if the task should be done using one or several threads. Type: Either CGAL::Sequential_tag, or CGAL::Parallel_tag, or CGAL::Parallel_if_available_tag Default: CGAL::Parallel_if_available_tag
vertex_is_constrained_map a property map containing the constrained-or-not status of each vertex of the triangulation in the c3t3. Type: a class model of ReadablePropertyMap with C3t3::Vertex_handle as key type and bool as value type. It must be default constructible. Default: a default property map where no vertex is constrained Extra: A constrained vertex will not be moved by smoothing.
edge_is_constrained_map a property map containing the constrained-or-not status of each edge of the triangulation in the c3t3. Type: a class model of ReadablePropertyMap with std::pair<C3t3::Vertex_handle, C3t3::Vertex_handle> as key type and bool as value type. It must be default constructible. Default: a default property map where no edge is constrained Extra: Vertices of a constrained edge will not be moved by the smoothing.
facet_is_constrained_map a property map containing the constrained-or-not status of each facet of the triangulation in the c3t3. Type: a class model of ReadablePropertyMap with C3t3::Facet as key type and bool as value type. It must be default constructible. Default: a default property map where no facet is constrained Extra: Vertices of a constrained facet will not be moved by smoothing.

Returns

a Mesh_smoothing_3::Smoothing_status object containing information about the smoothing process and convergence.

Examples

Mesh_smoothing_3/c3t3_smooth.cpp, Mesh_smoothing_3/hybrid_domain_feature_recovery.cpp, and Mesh_smoothing_3/implicit_domain_feature_recovery.cpp.