cgal/Generator/doc/Generator/PackageDescription.txt

77 lines
2.7 KiB
Plaintext

/// \defgroup PkgGenerators Geometric Object Generators Reference
/// \defgroup PkgGeneratorsConcepts Concepts
/// \ingroup PkgGenerators
/*!
\addtogroup PkgGenerators
\cgalPkgDescriptionBegin{Geometric Object Generators,PkgGeneratorsSummary}
\cgalPkgPicture{dice.png}
\cgalPkgSummaryBegin
\cgalPkgAuthors{Olivier Devillers, Susan Hert, Michael Hoffmann, Lutz Kettner, and Sven Schönherr}
\cgalPkgDesc{This package provides a variety of generators for geometric objects. They are useful as synthetic test data sets, e.g. for testing algorithms on degenerate object sets and for performance analysis. }
\cgalPkgManuals{Chapter_Geometric_Object_Generators,PkgGenerators}
\cgalPkgSummaryEnd
\cgalPkgShortInfoBegin
\cgalPkgSince{1.0}
\cgalPkgBib{cgal:dhhk-gog}
\cgalPkgLicense{\ref licensesLGPL "LGPL"}
\cgalPkgDemo{Generators,generator.zip}
\cgalPkgShortInfoEnd
\cgalPkgDescriptionEnd
This chapter describes the functions and classes provided in \cgal
that are useful for generating synthetic test data sets, <I>e.g.,</I>
for testing algorithms on degenerate object sets and for performance
analysis. These include a class for generating random numbers and
function for selecting random items from a set of objects, generators
for two-dimensional and three-dimensional points sets, a generator for
random convex sets and one for simple polygons. The \stl algorithm
`std::random_shuffle` is useful with these functions and classes to to
achieve random permutations for otherwise regular generators (
<I>e.g.</I>, points on a grid or segment).
\cgalClassifedRefPages
## Concepts ##
- `PointGenerator`
- `RandomConvexSetTraits_2`
- `RandomPolygonTraits_2`
## Functions ##
- `CGAL::perturb_points_2()`
- `CGAL::points_on_segment_2()`
- `CGAL::points_on_square_grid_2()`
- `CGAL::points_on_cube_grid_3()`
- `CGAL::points_on_cube_grid_d()`
- `CGAL::random_collinear_points_2()`
- `CGAL::random_convex_set_2()`
- `CGAL::random_polygon_2()`
- `CGAL::random_selection()`
## Variables ##
- `CGAL::default_random`
## Classes ##
- `CGAL::Random`
- `CGAL::Points_on_segment_2<Point_2>`
- `CGAL::Random_points_in_ball_d<Point_d>`
- `CGAL::Random_points_in_cube_3<Point_3, Creator>`
- `CGAL::Random_points_in_cube_d<Point_d>`
- `CGAL::Random_points_in_disc_2<Point_2, Creator>`
- `CGAL::Random_points_in_sphere_3<Point_3, Creator>`
- `CGAL::Random_points_in_square_2<Point_2, Creator>`
- `CGAL::Random_points_on_circle_2<Point_2, Creator>`
- `CGAL::Random_points_on_segment_2<Point_2, Creator>`
- `CGAL::Random_points_on_sphere_3<Point_3, Creator>`
- `CGAL::Random_points_on_sphere_d<Point_d>`
- `CGAL::Random_points_on_square_2<Point_2, Creator>`
## Traits Class ##
- `CGAL::Random_convex_set_traits_2<Kernel>`
*/