| 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 tesselation.dox | 
|---|
| 10 | * | 
|---|
| 11 | * Created on: Oct 28, 2011 | 
|---|
| 12 | *    Author: heber | 
|---|
| 13 | */ | 
|---|
| 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 | 
|---|
| 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 | 
|---|
| 27 | * sphere over one of the triangle's edges to eventually obtain a closed, | 
|---|
| 28 | * tesselated surface of the whole molecule. | 
|---|
| 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 | 
|---|
| 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). | 
|---|
| 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 | * | 
|---|
| 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 | 
|---|
| 50 | * | 
|---|
| 51 | */ | 
|---|