1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177
|
<!DOCTYPE HTML>
<html>
<head>
<title>Surface Evolver catenoid example</title>
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" >
<link rel="stylesheet" type="text/css" href="evdoc-style.css" />
</head>
<BODY>
<h1 class="center"><a href="http://www.susqu.edu/facstaff/b/brakke/evolver/evolver.htm" class="comic">
Surface Evolver</a> Documentation</h1>
<a href="evolver.htm#doc-top">Back to top of Surface Evolver documentation.</a>
<a href="index.htm">Index.</a><br>
<a href="twointor.htm">Next: Kelvin foam example.</a> <br>
<a href="tutorial.htm#tutorial">Back to top of tutorial.</a>
<a id="catenoid_example"></a>
<h1> Example: Catenoid. </h1>
The catenoid is the minimal surface formed between two rings not too far apart.
In cylindrical coordinates, its equation is <code>r = (1/a)cosh(az)</code>.
In cat.fe, both the upper and lower rings are given as one-parameter
boundary wires. The separation and radius are parameters, so
you can change them during a run with assignment statements or the
<a href="single.htm#A" class="keyword">A</a> command.
The initial radius given is the minimum for which a catenoid can exist
for the given separation of the rings. To get a stable catenoid, you
will have to increase this value. However, if you do run with the
original value, you can watch the neck pinch out.
The initial surface
consists of six rectangles forming a cylinder between the two circles.
The vertices on the boundaries are fixed, elsewise they would slide
along the boundary to short-cut the curvature; two diameters is shorter
than one circumference. The boundary edges are fixed so that vertices arising
from subdividing the edges are likewise fixed. <P>
<table>
<tr><td>
<img src="catbare.gif" alt="catenoid skeleton"></td>
<td> The initial catenoid skeleton, with
vertices and edges numbered. </td></tr>
</table>
Here is the catenoid datafile:
<pre>
// cat.fe
// Evolver data for catenoid.
PARAMETER RMAX = 1.5088795 // minimum radius for height
PARAMETER ZMAX = 1.0
boundary 1 parameters 1 // upper ring
x1: RMAX * cos(p1)
x2: RMAX * sin(p1)
x3: ZMAX
boundary 2 parameters 1 // lower ring
x1: RMAX * cos(p1)
x2: RMAX * sin(p1)
x3: -ZMAX
vertices // given in terms of boundary parameter
1 0.00 boundary 1 fixed
2 pi/3 boundary 1 fixed
3 2*pi/3 boundary 1 fixed
4 pi boundary 1 fixed
5 4*pi/3 boundary 1 fixed
6 5*pi/3 boundary 1 fixed
7 0.00 boundary 2 fixed
8 pi/3 boundary 2 fixed
9 2*pi/3 boundary 2 fixed
10 pi boundary 2 fixed
11 4*pi/3 boundary 2 fixed
12 5*pi/3 boundary 2 fixed
edges
1 1 2 boundary 1 fixed
2 2 3 boundary 1 fixed
3 3 4 boundary 1 fixed
4 4 5 boundary 1 fixed
5 5 6 boundary 1 fixed
6 6 1 boundary 1 fixed
7 7 8 boundary 2 fixed
8 8 9 boundary 2 fixed
9 9 10 boundary 2 fixed
10 10 11 boundary 2 fixed
11 11 12 boundary 2 fixed
12 12 7 boundary 2 fixed
13 1 7
14 2 8
15 3 9
16 4 10
17 5 11
18 6 12
faces
1 1 14 -7 -13
2 2 15 -8 -14
3 3 16 -9 -15
4 4 17 -10 -16
5 5 18 -11 -17
6 6 13 -12 -18
</pre>
The parameter in a boundary definition is always <code>p1</code> (and <code>p2</code>
in a two-parameter boundary). The Evolver can handle periodic parameterizations,
as is done in this example.
Try this sequence of
commands (displaying at your convenience):
<pre>
<a href="single.htm#r">r</a> (refine to get a crude, but workable, triangulation)
<a href="single.htm#u">u</a> (equiangulation makes much better triangulation)
<a href="single.htm#g">g</a> 120 (takes this many iterations for neck to collapse)
<a href="single.htm#t">t</a> 0.05 (collapse neck to single vertex by eliminating all
edges shorter than 0.05)
<a href="single.htm#o">o</a> (split neck vertex to separate top and bottom surfaces)
<a href="single.htm#g">g</a> (spikes collapse)
</pre>
The catenoid shows some of the subtleties of evolution. Suppose the
initial radius is set to <code>RMAX = 1.0</code> and the initial height to
<code>ZMAX = 0.55</code> (these are pre-set in <code>catman.fe</code>).
Fifty iterations with optimizing scale factor result in an area of 6.458483.
At this point, each iteration is reducing the area by only .0000001,
the triangles are all nearly equilateral, everything
looks nice, and the innocent user might conclude the surface is very
near its minimum. But this is really a saddle point of energy.
Further iteration shows that the area change per iteration bottoms out
about iteration 70, and by iteration 300 the area is down to 6.4336.
The triangulation really wants to twist around so that there are edges
following the lines of curvature, which are vertical meridians and
horizontal circles. Hence the optimum triangulation appears to be
rectangles with diagonals. <P>
The evolution can be speeded up by turning on the
<a href="iterate.htm#conjugate-gradient" >conjugate gradient</a>
method with the
<a href="single.htm#U" class="keyword">U</a>
command.
With <code>catman.fe</code>, try the script "<code>r; u; U; g 70</code>".
For conjugate gradient cognoscenti,
the saddle point demonstrates the difference between the Fletcher-Reeves
and Polak-Ribiere versions of conjugate gradient. The saddle point
seems to confuse the Fletcher-Reeves version (which used to be the default).
However, the Polak-Ribiere version (the current default) has little problem.
The
<a href="single.htm#U" class="keyword">U</a>
command toggles conjugate gradient on and off, and
<a href="toggle.htm#ribiere" class="keyword">ribiere</a>
toggles the Polak-Ribiere version.
With Fletcher-Reeves conjugate gradient in effect, the
saddle point is reached at iteration 17 and area starts decreasing again
until iteration 30, when it reaches 6.4486. But then iteration stalls
out, and the conjugate gradient mode has to be turned off and on to
erase the history vector. Once restarted, another 20 iterations will
get the area down to 6.4334.
In Polak-Ribiere mode, no restart is necessary. <P>
Exercise for the reader: Get the Surface Evolver to display an unstable
catenoid by declaring the catenoid facets to be the boundary of a body,
and adjusting the body volume with the
<a href="single.htm#b" class="keyword">b</a>
command to get zero pressure.
See the sample datafile <code>catbody.fe</code>.
<P>
<hr>
<a href="twointor.htm">Next: Kelvin foam example.</a> <br>
<a href="tutorial.htm#tutorial">Back to top of tutorial.</a>
<br>
<a href="evolver.htm#doc-top">Back to top of Evolver documentation.</a>
<a href="index.htm">Index.</a>
</body>
</html>
|