source: src/documentation/constructs/tesselation.dox@ 88bb6b

Last change on this file since 88bb6b was caece4, checked in by Frederik Heber <heber@…>, 11 years ago

Enhanced documentation significantly.

  • went through all of the constructs and updated each.
  • enhanced documentation ofr Fragmentation::FragmentMolecule().
  • Property mode set to 100644
File size: 1.9 KB
RevLine 
[ce133f]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/**
[19bc74]9 * \file tesselation.dox
[ce133f]10 *
[19bc74]11 * Created on: Oct 28, 2011
[ce133f]12 * Author: heber
13 */
[750cff]14
15/** \page tesselation Tesselation
16 *
17 * Tesselation is a first step towards recognizing molecular surfaces.
18 *
19 * Within the code it is used for calculating correlation functions with regard
20 * to such a surface.
21 *
22 * \section tesselation-procedure
23 *
24 * In the tesselation all atoms act as possible hindrance to a rolling sphere
[caece4]25 * that moves in from infinity. Whenever it rests uniquely on three distinct
26 * points (atoms) a triangle is created. The algorithm continues by pushing the
[750cff]27 * sphere over one of the triangle's edges to eventually obtain a closed,
[caece4]28 * tesselated surface of the whole molecule.
[750cff]29 *
30 * \note This mesh is different to the usual sense of a molecular surface as
31 * atoms are directly located on it. Normally, one considers a so-called
[caece4]32 * Van-der-Waals sphere around the atoms and tesselates over these.
33 * \todo However, the mesh can easily be modified and even expanded to match the
34 * other (although the code for that is not yet fully implemented).
[750cff]35 *
36 * \section tesselation-extension
37 *
38 * The main problem for extending the mesh to match with the normal sense is
39 * that triangles may suddenly intersect others when we have the case of a non-
40 * convex mesh (which is rather the normal case). And this has to be
41 * specifically treated. Also, it is not sure whether the procedure of
42 * expanding our current surface is optimal and one should not start on a
43 * different set of nodes created from virtual points resting on the
44 * van-der-Waals spheres.
45 *
[caece4]46 * Note that it is possible to select a number of atoms and create a bounding box
47 * from a combination of spheres with van der Waals radii.
48 *
49 * \date 2014-03-10
[750cff]50 *
51 */
Note: See TracBrowser for help on using the repository browser.