source: src/documentation/constructs/shapes.dox@ 0f3042

Last change on this file since 0f3042 was eee1b7, checked in by Frederik Heber <heber@…>, 12 years ago

DOCU: Documentation on ShapeRegistry, QtUI changes, validators, and parameters.

  • Property mode set to 100644
File size: 1.4 KB
Line 
1/*
2 * Project: MoleCuilder
3 * Description: creates and alters molecular systems
4 * Copyright (C) 2010 University of Bonn. All rights reserved.
5 * Please see the LICENSE file or "Copyright notice" in builder.cpp for details.
6 */
7
8/**
9 * \file shapes.dox
10 *
11 * Created on: Oct 28, 2011
12 * Author: heber
13 */
14
15/** \page shapes Shapes
16 *
17 * Shapes are present for denoting a specific region of the simulation domain.
18 * There are four primitive types present:
19 * - Sphere
20 * - Ellipsoid
21 * - Cuboid
22 * - Cylinder
23 *
24 * Note that all may be modified (shrink/grow, rotate, morph) via an arbitrary
25 * matrix.
26 *
27 * The shapes are for the moment only used within \ref descriptors to specify
28 * a specific subset of atoms, here that reside in a certain region of the
29 * simulation domain.
30 *
31 * \todo There is a certain relation between Tesselation and Shape. Hence, later
32 * Tesselation shall itself be a Shape, i.e. that describes a certain region in
33 * space, here via a tesselated mesh.
34 *
35 * Again, Shapes can be joined via boolean operators:
36 * - add
37 * - or
38 * - not
39 *
40 * And thus are a very powerful concept.
41 *
42 * E.g. a shape can be used like this
43 * \code
44 * Cuboid(Vector(0,0,0), Vector(2,2,2)) && !Sphere(Vector(1,1,1), 1.)
45 * \endcode
46 * which would match any object within the cuboid from (0,0,0) to (2,2,2)
47 * that is not in the unit sphere at (1,1,1).
48 *
49 *
50 * \date 2013-02-07
51 *
52 */
Note: See TracBrowser for help on using the repository browser.