Merge branch 'master' of ssh://opencfd@repo.or.cz/srv/git/OpenFOAM-1.5.x
[OpenFOAM-1.5.x.git] / ReleaseNotes-1.5.html
blob480775406ad887ea37d5a2dbb60f41ea32b971b5
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml"
4 lang="en" xml:lang="en">
5 <head>
6 <title><b>OpenFOAM release notes for version 1.5</b></title>
7 <meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1"/>
8 <meta name="generator" content="Org-mode"/>
9 <meta name="generated" content="14 July 2008"/>
10 <meta name="author" content="OpenCFD Ltd."/>
11 <style type="text/css">
12 html {
13 font-family: Times, serif;
14 font-size: 12pt;
16 .title { text-align: center; }
17 .todo { color: red; }
18 .done { color: green; }
19 .timestamp { color: grey }
20 .timestamp-kwd { color: CadetBlue }
21 .tag { background-color:lightblue; font-weight:normal }
22 .target { }
23 pre {
24 border: 1pt solid #AEBDCC;
25 background-color: #F3F5F7;
26 padding: 5pt;
27 font-family: courier, monospace;
28 font-size: 90%;
30 table { border-collapse: collapse; }
31 td, th {
32 vertical-align: top;
33 <!--border: 1pt solid #ADB9CC;-->
35 dt { font-weight: bold; }
36 </style>
37 </head><body>
38 <h1 class="title"><b>OpenFOAM release notes for version 1.5</b></h1>
39 <div id="table-of-contents">
40 <h2>Table of Contents</h2>
41 <div id="text-table-of-contents">
42 <ul>
43 <li><a href="#sec-1">1 Overview</a></li>
44 <li><a href="#sec-2">2 GNU/Linux version</a></li>
45 <li><a href="#sec-3">3 C++ Compiler version</a></li>
46 <li><a href="#sec-4">4 Developments to solvers (applications)</a></li>
47 <li><a href="#sec-5">5 Automatic mesher</a></li>
48 <li><a href="#sec-6">6 Developments to utilities</a></li>
49 <li><a href="#sec-7">7 Migration from ParaView 2.4 to ParaView 3.x</a></li>
50 <li><a href="#sec-8">8 Model development</a></li>
51 <li><a href="#sec-9">9 New functionObjects</a></li>
52 <li><a href="#sec-10">10 Improvements to boundary conditions</a></li>
53 <li><a href="#sec-11">11 Other</a></li>
54 </ul>
55 </div>
56 </div>
58 <div id="outline-container-1" class="outline-2">
59 <h2 id="sec-1">1 Overview</h2>
60 <div id="text-1">
62 <p>OpenFOAM-1.5 is is a significant upgrade to version 1.4 in ways which are
63 outlined below. This release passes all our standard tests and the tutorials
64 have been broadly checked. If there are any bugs, please report them using
65 the instructions set out in: <a href="http://www.openfoam.org/bugs.html">http://www.openfoam.org/bugs.html</a>.
66 </p>
67 <p>
68 Most of the developments for this release are in: new applications, e.g. for
69 multiphase flow and cavitation, buoyancy-flow and heat transfer, high speed
70 flows and even molecular dynamics; new utilities, e.g. for meshing and case
71 monitoring; and, new modelling, e.g. in Lagrangian particle tracking,
72 radiation and rotating frames of reference. With these new applications come
73 numerous new example cases.
74 </p>
75 </div>
77 </div>
79 <div id="outline-container-2" class="outline-2">
80 <h2 id="sec-2">2 GNU/Linux version</h2>
81 <div id="text-2">
83 <p>The 64bit binary packs of the OpenFOAM release were compiled on a machine
84 running SuSE GNU/Linux version 10.3 and the 32bit on a machine running Ubuntu
85 GNU/Linux version 7.1 and also tested on Ubuntu 8.04. We recommend that
86 users run OpenFOAM on one of these or a similar recent version of GNU/Linux.
87 This release has also been successfully compiled and tested on older GNU/Linux
88 releases but this requires the installation of Qt 4.3.? for ParaView-3 to run.
89 </p>
90 </div>
92 </div>
94 <div id="outline-container-3" class="outline-2">
95 <h2 id="sec-3">3 C++ Compiler version</h2>
96 <div id="text-3">
98 <ul>
99 <li>
100 Released compiled with GCC 4.3.1, the latest version.
101 </li>
102 <li>
103 Built in support for the Intel C++ 10.? compiler (untested).
104 </li>
105 <li>
106 The choice of the compiler is controlled by the setting of the $WM_COMPILER
107 and $WM_COMPILER_ARCH environment variables in the OpenFOAM-1.5/etc/bashrc
108 (or cshrc) file.
109 </li>
110 <li>
111 The location of the installation of the compiler is controlled by the
112 $WM_COMPILER_INST environment variable in the OpenFOAM-1.5/etc/settings.sh
113 (or settings.csh) file.
115 </li>
116 </ul>
117 </div>
119 </div>
121 <div id="outline-container-4" class="outline-2">
122 <h2 id="sec-4">4 Developments to solvers (applications)</h2>
123 <div id="text-4">
125 <ul>
126 <li>
127 New rhoCentralFoam solver for high-speed, viscous, compressible flows using
128 non-oscillatory, central-upwind schemes.
129 </li>
130 <li>
131 New interDyMFoam solver for 2 incompressible, isothermal, immiscible fluids
132 using a VoF phase-fraction based interface capturing approach, with optional
133 mesh motion and mesh topology changes including adaptive mesh
134 (un)refinement. Useful for simulations such as tank filling, sloshing ---
135 using solid body motion e.g. SDA or SKA (6DoF) &mdash; and slamming (using the
136 mesh motion solver) and other large-scale applications that benefit from the
137 efficiency gain of adaptive mesh (un)refinement of the interface.
138 </li>
139 <li>
140 New compressibleInterFoam solver for 2 compressible, isothermal, immiscible
141 fluids using a volume of fluid (VoF) phase-fraction approach for
142 interface-capturing. The momentum and other fluid properties are of the
143 "mixture" and a single momentum equation is solved. Turbulence is modelled
144 using a run-time selectable incompressible LES model.
145 </li>
146 <li>
147 New interPhaseChangeFoam solver for 2 incompressible, isothermal, immiscible
148 fluids with phase-change, e.g. cavitation. Uses VoF interface capturing,
149 with momentum and other fluid properties described for the ``mixture'' and a
150 single momentum equation is solved. The set of phase-change models provided
151 are designed to simulate cavitation but other mechanisms of phase-change are
152 supported within this solver framework.
153 </li>
154 <li>
155 New rasCavitatingFoam solver for transient cavitation using a barotropic
156 compressibility model, with RAS turbulence.
157 </li>
158 <li>
159 New lesCavitatingFoam solver for transient cavitation using a barotropic
160 compressibility model, with LES turbulence.
161 </li>
162 <li>
163 New chtMultiRegionFoam solver that couples conjugate heat transfer in a
164 solid to a buoyancy-driven flow simulation.
165 </li>
166 <li>
167 New PDRFoam solver for compressible premixed/partially-premixed turbulent
168 combustion that includes porosity/distributed resistance (PDR) modelling to
169 handle regions containing solid blockages which cannot be resolved by the
170 mesh. Requires the PDR fields.
171 </li>
172 <li>
173 New lesBuoyantFoam solver for transient, buoyant, turbulent flow of
174 compressible fluids for ventilation and heat-transfer. Turbulence is
175 modelled using a run-time selectable compressible LES model.
176 </li>
177 <li>
178 New rhoPimpleFoam solver for transient, turbulent flow of compressible
179 fluids for ventilation and heat-transfer. Uses the flexible PIMPLE
180 (PISO-SIMPLE) solution for time-resolved and pseudo-transient simulations.
181 </li>
182 <li>
183 New buoyantSimpleRadiationFoam solver for steady-state, buoyant, turbulent
184 flow of compressible fluids with radiation, for ventilation and
185 heat-transfer.
186 </li>
187 <li>
188 New rhoTurbTwinParcelFoam solver for transient for compressible, turbulent
189 flow with two thermo-clouds.
190 </li>
191 <li>
192 New gnemdFOAM solver for general purpose molecular dynamics that simulates
193 atoms in arbitrary shaped domains and average atomic/molecular quantities to
194 the mesh to create field data.
195 </li>
196 <li>
197 New mdEqulibrationFoam solver to equilibrates and/or preconditions molecular
198 dynamics systems.
199 </li>
200 <li>
201 Demonstration SRFSimpleFoam solver based on simpleFoam that incorporates the
202 SRF extensions (see below) for rotating flows.
204 </li>
205 </ul>
206 </div>
208 </div>
210 <div id="outline-container-5" class="outline-2">
211 <h2 id="sec-5">5 Automatic mesher</h2>
212 <div id="text-5">
214 <p>New snappyHexMesh utility that generates split-hex meshes automatically from
215 triangulated (STL) surface geometries. The mesh approximately conforms to
216 the surface by iteratively refining a starting mesh and morphing the
217 resulting split-hex mesh to the surface. An optional phase will shrink back
218 the resulting mesh and insert cell layers. It has a flexible specification
219 of mesh refinement level and robust surface handling with a pre-specified
220 final mesh quality. It runs in parallel with a load balancing step every
221 iteration.
222 </p>
223 </div>
225 </div>
227 <div id="outline-container-6" class="outline-2">
228 <h2 id="sec-6">6 Developments to utilities</h2>
229 <div id="text-6">
231 <ul>
232 <li>
233 New extrude2DMesh utility that extrudes 2D meshes into a 3D mesh. 2D meshes
234 are described by faces with 2 points, so can be used in combination with 2D
235 meshes converted with ccm26ToFoam.
236 </li>
237 <li>
238 New couplePatches functionality integrated into createPatch, which
239 optionally synchronises ("couples") points and faces of coupled (cyclic,
240 processor) patches.
241 </li>
242 <li>
243 New applyBoundaryLayer pre-processing utility to apply 1/7th power-law
244 boundary layers at walls, starting from uniform or potential flow solutions.
245 </li>
246 <li>
247 New execFlowFunctionObjects utility executes functionObjects as a
248 post-processing activity, e.g. probes, sampling, force calculation.
249 </li>
250 <li>
251 New changeDictionary utility makes batch changes to OpenFOAM input files,
252 e.g. to change boundary conditions of field files.
253 </li>
254 <li>
255 New foamCalc utility, a generic post-processing field calculator tool
256 </li>
257 <li>
258 New molConfig pre-processing utility for molecular dynamics cases. Fills
259 zones of a mesh with single crystal lattices of specified structure,
260 density, orientation, alignment and temperature.
261 </li>
262 <li>
263 Extended splitMeshRegions utility to split multi-zone meshes, e.g. defined
264 through cellZones, into separate meshes.
265 </li>
266 <li>
267 Extended the foamToVTK, decomposePar, reconstructPar and mapFields utilities
268 to include support for multiple particle clouds in parallel processing.
270 </li>
271 </ul>
272 </div>
274 </div>
276 <div id="outline-container-7" class="outline-2">
277 <h2 id="sec-7">7 Migration from ParaView 2.4 to ParaView 3.x</h2>
278 <div id="text-7">
280 <ul>
281 <li>
282 Rewritten OpenFOAM Reader Module for version 3, a major redesign of
283 ParaView.
284 </li>
285 <li>
286 New features include viewing patch names, reading of Lagrangian data,
287 handling of cell, face and point sets, multiple views.
289 </li>
290 </ul>
291 </div>
293 </div>
295 <div id="outline-container-8" class="outline-2">
296 <h2 id="sec-8">8 Model development</h2>
297 <div id="text-8">
299 <ul>
300 <li>
301 Overhauled the lagrangian library to support multiple clouds.
302 </li>
303 <li>
304 New lagrangianIntermediate library incorporating a hierarchy of parcel and
305 cloud types, accommodating kinematic, thermodynamic and reacting
306 applications, including coupling to the new radiation library. Sub-models
307 are added at the relevant level of physics, e.g.:
308 <ul>
309 <li>
310 kinematic: injection, wall interaction, drag, dispersion;
311 </li>
312 <li>
313 thermo: heat transfer;
314 </li>
315 <li>
316 reacting: reacting composition, mass transfer, surface reactions.
317 </li>
318 </ul>
319 </li>
320 <li>
321 New single rotating frame of reference (SRF) library for rotating flow
322 applications, e.g. turbo-machinery.
323 </li>
324 <li>
325 New radiation library including the P1 model and associated Marshak boundary
326 conditions for incident radiation.
327 </li>
328 <li>
329 New displacementInterpolation motion solver for flexible mesh scaling.
330 </li>
331 <li>
332 New molecularDynamics Lagrangian library to calculate intermolecular forces
333 between spherically symmetrical monatomic species in arbitrary geometries.
335 </li>
336 </ul>
337 </div>
339 </div>
341 <div id="outline-container-9" class="outline-2">
342 <h2 id="sec-9">9 New functionObjects</h2>
343 <div id="text-9">
345 <p>To aid common monitoring and post-processing activities.
346 </p><ul>
347 <li>
348 forces: calculate the force and moment on a patch or set of patches, e.g. to
349 calculate the lift, drag and moment of an object in the flow.
350 </li>
351 <li>
352 forceCoeffs: calculate the normalised force and moment on a patch or set of
353 patches, e.g. to calculate the lift, drag and moment coefficients of an
354 object in the flow.
355 </li>
356 <li>
357 fieldAverage: calculate field arithmetic mean and prime-squared averages for
358 a list of fields.
359 </li>
360 <li>
361 foamCalcFunctions: calculate field components, div, mag, magGrad or magSqr.
363 </li>
364 </ul>
365 </div>
367 </div>
369 <div id="outline-container-10" class="outline-2">
370 <h2 id="sec-10">10 Improvements to boundary conditions</h2>
371 <div id="text-10">
373 <ul>
374 <li>
375 Generalised jumpCyclic type: cyclic condition with an additional prescribed
376 jump in value.
377 </li>
378 <li>
379 fan type: specialisation of jumpCyclic, applying a prescribed jump in
380 pressure to simulate a fan within a mesh.
381 </li>
382 <li>
383 Generalised advective outflow boundary condition based on solving D/Dt(psi,
384 U) = 0 at the boundary.
385 </li>
386 <li>
387 Additional turbulent flow inlet to specify mixing length and frequency.
388 </li>
389 <li>
390 Generalisation of time varying set of boundary conditions.
392 </li>
393 </ul>
394 </div>
396 </div>
398 <div id="outline-container-11" class="outline-2">
399 <h2 id="sec-11">11 Other</h2>
400 <div id="text-11">
402 <ul>
403 <li>
404 New argument-free command execution, e.g typing "icoFoam" without root and
405 case directory arguments.
406 </li>
407 <li>
408 Extended time command line options.
409 </li>
410 <li>
411 Many enhancements to dictionary including macro substitution, optional
412 merging and default/overwrite behaviour, enhanced "#include" file handling
413 and the framework to support function evaluation.
414 </li>
415 <li>
416 Cross-links between applications and Doxygen documentation with the "-doc"
417 argument.
418 </li>
419 <li>
420 Non-blocking, non-buffered, parallel transfers with potential scaling
421 benefits for larger number of processors.
422 </li>
423 </ul>
424 </div>
425 </div>
426 <div id="postamble"><p class="date"> Date: 14 July 2008</p>
427 <p>HTML generated by org-mode 6.05a in emacs 23<p>
428 </div></body>
429 </html>