docs

Documentation/doc/biblio/cgal_manual.bib

@@ -2857,6 +2857,17 @@ pages = "207--221"
   ,year         = 1999
   ,pages        = {317--324}
 }
+
+@inproceedings{kazhdan2012can,
+  title={Can Mean-Curvature Flow be Modified to be Non-singular?},
+  author={Kazhdan, Michael and Solomon, Jake and Ben-Chen, Mirela},
+  booktitle={Computer Graphics Forum},
+  volume={31},
+  number={5},
+  pages={1745--1754},
+  year={2012},
+  organization={Wiley Online Library}
+}
 % ----------------------------------------------------------------------------
 % END OF BIBFILE
 % ----------------------------------------------------------------------------

Polygon_mesh_processing/doc/Polygon_mesh_processing/NamedParameters.txt

@@ -375,15 +375,8 @@ so that small angles carry more weight.
 \b Default is `false`
 \cgalNPEnd
 
-\cgalNPBegin{avoid_singularities} \anchor PMP_avoid_singularities
-Parameter used in `shape_remeshing()` to indicate convergence to a sphere.
-\n
-\b Type : `bool` \n
-\b Default is `false`
-\cgalNPEnd
-
 \cgalNPBegin{gradient_descent_precision} \anchor PMP_gradient_descent_precision
-Parameter used in `area_remeshing()` to set precision to be met while the relative energy
+Parameter used in `smooth_area()` to set precision to be met while the relative energy
 between iterations of each triagle is minimized. Triangle energy is defined based on its area compared to the
 average area of all triagnles adjacent to the vertex that is being moved.
 \n

Polygon_mesh_processing/doc/Polygon_mesh_processing/PackageDescription.txt

@@ -89,10 +89,11 @@ and provides a list of the parameters that are used in this package.
 ## Meshing Functions ##
 - `CGAL::Polygon_mesh_processing::fair()`
 - `CGAL::Polygon_mesh_processing::refine()`
-- `CGAL::Polygon_mesh_processing::angle_smoothing()`
-- `CGAL::Polygon_mesh_processing::area_smoothing()`
+- `CGAL::Polygon_mesh_processing::smooth_angles()`
+- `CGAL::Polygon_mesh_processing::smooth_areas()`
 - `CGAL::Polygon_mesh_processing::compatible_smoothing()`
-- `CGAL::Polygon_mesh_processing::shape_smoothing()`
+- `CGAL::Polygon_mesh_processing::smooth_curvature_flow()`
+- `CGAL::Polygon_mesh_processing::smooth_modified_curvature_flow()`
 - `CGAL::Polygon_mesh_processing::triangulate_face()`
 - `CGAL::Polygon_mesh_processing::triangulate_faces()`
 - \link PMP_meshing_grp `CGAL::Polygon_mesh_processing::isotropic_remeshing()` \endlink

Polygon_mesh_processing/doc/Polygon_mesh_processing/Polygon_mesh_processing.txt

@@ -143,11 +143,10 @@ especially for meshes with highly irregular connectivity. As such, area smoothin
 distribution of the vertices over the area that is being smoothed.
 
 For shape smoothing, `CGAL::Polygon_mesh_processing::smooth_curvature_flow()`
-takes into account the mean curvature flow to calculate a weighted barycenter towards which vertices move incrementally.
-Shape smoothing using the curvature flow is based on Desbrun et al \cgalCite{cgal:dmsb-ifamdcf-99}.
-The algorihm uses the mean curvature flow to translate surface vertices by moving along the surface normal with a speed equal to the mean curvature of the area that is being smoothed. This means that vertices on sharp corners slide faster and also if the surface is flat around a vertex, this vertex will not move (zero curvature). 
+takes into account the mean curvature flow to calculate a weighted barycenter towards which vertices move incrementally. Shape smoothing using the curvature flow is based on Desbrun et al \cgalCite{cgal:dmsb-ifamdcf-99}.
+The algorihm uses the mean curvature flow to calculate the translation of surface vertices along the surface normal with a speed equal to the mean curvature of the area that is being smoothed. This means that vertices on sharp corners slide faster and also if the surface is flat around a vertex, this vertex will not move (zero curvature). 
 
-`CGAL::Polygon_mesh_processing::smooth_modified_curvature_flow()` may be used to apply a modified algorithm based on the mean curvature flow that slows down the evolution in cylindrical regions, and thus avoiding the formation of undesirable neck pinches. The algorithm converges gradually to a sphere.
+`CGAL::Polygon_mesh_processing::smooth_modified_curvature_flow()` may be used to apply a modified algorithm based on the mean curvature flow that slows down the evolution in cylindrical regions, and thus avoiding the formation of undesirable neck pinches. The algorithm is based on Kazhdan et al \cgalCite{cgal:dmsb-ifamdcf-99} and the smoothed surface converges to a conformal parameterization of the surface onto a sphere
 
 
 \cgalFigureBegin{smooth_sphere, smooth_sphere.png}

Polygon_mesh_processing/include/CGAL/Polygon_mesh_processing/smoothing.h

@@ -53,7 +53,7 @@ namespace Polygon_mesh_processing {
 * A weighted scheme is also proposed to favorise the removal of small angles.
 * Optionally, the points are reprojected after each iteration.
 *
-* @todo Make the projection of poinst optional
+* @todo Make the projection of points optional.
 * @tparam PolygonMesh model of `MutableFaceGraph`.
 *         If `PolygonMesh` has an internal property map for `CGAL::face_index_t`,
 *         and no `face_index_map` is given
@@ -212,7 +212,7 @@ void angle_smoothing(PolygonMesh& pmesh)
 * This function tries to make the area distribution of triangle as uniform as possible
 * by moving non constrained vertices.
 * Optionally, the points are reprojected after each iteration.
-* @todo make the reprojected optional
+* @todo make the reprojection optional.
 *
 * @tparam PolygonMesh model of `MutableFaceGraph`.
 *         If `PolygonMesh` has an internal property map for `CGAL::face_index_t`,
@@ -368,7 +368,7 @@ void area_smoothing(PolygonMesh& pmesh)
 /*!
 * \ingroup PMP_meshing_grp
 * smoothes a triangulated region of a polygon mesh using area and angle based criteria.
-* Each iteration alternates a call to `angle_smoothing()`, `area_smoothing()`, and `angle_smoothing()`.
+* Each iteration alternates a call to `smooth_angles()`, `smooth_areas()`, and `smooth_angles()`.
 * Convergence is realized based on the Hausdorff distance of the mesh between previous
 * and current iteration or until a specified maximum number of iterations.
 *
@@ -384,7 +384,7 @@ void area_smoothing(PolygonMesh& pmesh)
 * @param faces the range of triangular faces defining one or several surface patches to be smoothed.
 * @param np optional sequence of \ref namedparameters among the ones listed below.
 *
-* @todo remove Hausdorff and use ratio between max (or mean?) displacement
+* @todo remove Hausdorff and use ratio between max (or mean?) displacement.
 * \cgalNamedParamsBegin
 *  \cgalParamBegin{geom_traits} a geometric traits class instance, model of `Kernel`.
 *    Exact constructions kernels are not supported by this function.