36.1 | Introduction | ||||
36.2 | Definition of a Skin Surface | ||||
36.3 | The Interface | ||||
36.4 | Timings | ||||
36.5 | Example Programs | ||||
36.5.1 Meshing a Skin Surface | |||||
36.5.2 Meshing and Subdividing a Skin Surface |
Skin surfaces, introduced by Edelsbrunner in [Ede99], have a rich and simple combinatorial and geometric structure that makes them suitable for modeling large molecules in biological computing. Meshing such surfaces is often required for further processing of their geometry, like in numerical simulation and visualization.
A skin surface is defined by a set of weighted points (input balls) and a scalar called the shrink factor. If the shrink factor is equal to one, the surface is just the boundary of the union of the input balls. For a shrink factor smaller than one, the skin surface becomes tangent continuous, due to the appearance of patches of spheres and hyperboloids connecting the balls.
This package constructs a mesh isotopic to the skin surface defined by a set of balls and a shrink factor using the algorithm described in [KV05].
An optimized algorithm is implemented for meshing the union of a set of balls.
This section first briefly reviews skin surfaces. For a more thorough introduction to skin surfaces, we refer to [Ede99] where they were originally introduced.
A skin surface is defined in terms of a finite set of weighted points and a shrink factor , with . A weighted point corresponds to a ball with center and radius . A weighted point with zero weight is called an unweighted point.
A pseudo distance between a weighted point and an unweighted point is defined as
where is the Euclidean distance between and . The ball corresponding to a weighted point is the zero set of . Note that if the radius of the ball is imaginary and the zero-set is empty.
We can take convex combinations of weighted points by taking convex combinations of their distance functions. Figure 36.1 (left) shows weighted points that are obtained as convex combinations of the dashed circles. For further reading on the space of circles and spheres we refer to [Ped70].
Starting from a weighted point , the shrunk weighted point is obtained by taking a convex combination with the unweighted point centered at , formally , with . A simple calculation shows that, . The set is the set obtained by shrinking every weighted point of by a factor : . The shrunk weighted points of Figure 36.1 (left) are shown in Figure 36.1 (right).
We now define the skin surface skn associated with a set of weighted points . Consider the set of weighted points obtained by taking the convex hull of the input weighted points. A calculation shows that every weighted point lies within the union of the input balls. Next, we shrink each weighted point in the convex hull with the shrink factor . Hence, we multiply the radius of the corresponding (real) input circles with a factor . The skin surface is the boundary of the union of this set of weighted points:
Here
Recall that each weighted point in the convex hull of the input weighted points is contained in the union of the input weighted points. Hence, for a shrink factor equal to one, the skin surface is the boundary of the union of the input weighted points.
By definition of a skin surface, the weights of the input balls (their
radius-squared) are shrunk with a factor of
The interface to the skin surface package consists of one main function, taking a set of weighted points and a shrink factor and outputting the meshed surface. Further, it defines classes and functions and classed used to perform the main steps of the algorithm. There are two global classes Skin_surface_3 and Union_of_balls_3 both of which are models of the concept SkinSurface_3 and there are two functions to extract a mesh of the skin surface (union of balls) from the objects of the aforementioned classes. A final function takes a mesh and the Skin_surface_3 (Union_of_balls_3) object it is constructed from and refines the mesh. This section describes these classes and functions in more detail.
The main function of the skin surface package takes an iterator range of weighted points, a shrink factor and the number of subdivision steps and outputs a mesh in a CGAL::Polyhedron_3:
| ||||
|
|
Where, FT is the number type used by the Weighted_points.
To obtain more control over the algorithm, the different steps can also be performed separately. First, a Skin_surface_3 object is created from an iterator range of weighted points and a shrink factor. Optional arguments are a boolean telling whether the input weighted points should be grown in such a way that the skin surface wraps around the input balls instead of the shrunk input balls.
| ||
|
|
The template parameter should implement the SkinSurfaceTraits_3 concept. The type WP_iterator, is an iterator over weighted points as defined by SkinSurfaceTraits_3 and FT is the number type used by the weighted points.
For a shrink factor equal to one the skin surface is the boundary of the union of the input balls. In this case the algorithm used for meshing the skin surface greatly simplifies. These optimizations are implemented in the class Union_of_balls_3. The constructor for the union of balls class is similar, except for the missing shrink factor:
| ||
|
|
With a model of the concept SkinSurface_3 it is possible to generate a coarse mesh isotopic to the skin surface. Using the function mesh_skin_surface_3 with signature:
| ||
|
|
The last function takes the (coarse) mesh and subdivides it in-situ by applying a given number of 1-4 split operations (each triangle is split into four sub-triangles) and moving the new vertices towards the skin surface. If the number of iterations is not specified, one subdivision step is done. The object of the SkinSurface_3 concept used to construct the coarse mesh is needed to move new points on the skin surface.
| ||
|
|
Data set | Number of weighted points | Coarse mesh | first subdivision step |
Caffeine | 23 | 0.2 sec. | 0.05 sec. |
Gramicidin A | 318 | 5 sec. | 2 sec. |
File: examples/Skin_surface_3/skin_surface_simple.cpp
#include <CGAL/Exact_predicates_inexact_constructions_kernel.h> #include <CGAL/make_skin_surface_mesh_3.h> #include <list> typedef CGAL::Exact_predicates_inexact_constructions_kernel K; typedef K::Point_3 Bare_point; typedef CGAL::Weighted_point<Bare_point,K::RT> Weighted_point; typedef CGAL::Polyhedron_3<K> Polyhedron; int main() { std::list<Weighted_point> l; double shrinkfactor = 0.5; l.push_front(Weighted_point(Bare_point( 1,-1,-1), 1.25)); l.push_front(Weighted_point(Bare_point( 1, 1, 1), 1.25)); l.push_front(Weighted_point(Bare_point(-1, 1,-1), 1.25)); l.push_front(Weighted_point(Bare_point(-1,-1, 1), 1.25)); Polyhedron p; CGAL::make_skin_surface_mesh_3(p, l.begin(), l.end(), shrinkfactor); return 0; }
Next, the coarse mesh is refined to obtain a better approximation. The use of CGAL::Skin_surface_polyhedral_items_3<Skin_surface_3> in the CGAL::Polyhedron is not necessary, but gives the subdivision a significant speedup.
File: examples/Skin_surface_3/skin_surface_subdiv.cpp
#include <CGAL/Exact_predicates_inexact_constructions_kernel.h> #include <CGAL/Skin_surface_3.h> #include <CGAL/Polyhedron_3.h> #include <CGAL/mesh_skin_surface_3.h> #include <CGAL/subdivide_skin_surface_mesh_3.h> #include "skin_surface_writer.h" #include <list> #include <fstream> typedef CGAL::Exact_predicates_inexact_constructions_kernel K; typedef CGAL::Skin_surface_traits_3<K> Traits; typedef CGAL::Skin_surface_3<Traits> Skin_surface_3; typedef Skin_surface_3::FT FT; typedef Skin_surface_3::Weighted_point Weighted_point; typedef Weighted_point::Point Bare_point; typedef CGAL::Polyhedron_3<K, CGAL::Skin_surface_polyhedral_items_3<Skin_surface_3> > Polyhedron; int main() { std::list<Weighted_point> l; FT shrinkfactor = 0.5; l.push_front(Weighted_point(Bare_point( 1,-1,-1), 1.25)); l.push_front(Weighted_point(Bare_point( 1, 1, 1), 1.25)); l.push_front(Weighted_point(Bare_point(-1, 1,-1), 1.25)); l.push_front(Weighted_point(Bare_point(-1,-1, 1), 1.25)); Polyhedron p; Skin_surface_3 skin_surface(l.begin(), l.end(), shrinkfactor); CGAL::mesh_skin_surface_3(skin_surface, p); CGAL::subdivide_skin_surface_mesh_3(skin_surface, p); std::ofstream out("mesh.off"); out << p; return 0; }