ReleaseNotes-1.5.html

   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="19 August 2008"/>
  10 <meta name="author" content="Hrvoje Jasak"/>
  11 <style type="text/css">
  12   html {
  13         font-family: Times, serif;
  14         font-size: 12pt;
  15   }
  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%;
  29   }
  30   table { border-collapse: collapse; }
  31   td, th {
  32         vertical-align: top;
  33         <!--border: 1pt solid #ADB9CC;-->
  34   }
  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>
  57
  58 <div id="outline-container-1" class="outline-2">
  59 <h2 id="sec-1">1 Overview</h2>
  60 <div id="text-1">
  61
  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>
  76
  77 </div>
  78
  79 <div id="outline-container-2" class="outline-2">
  80 <h2 id="sec-2">2 GNU/Linux version</h2>
  81 <div id="text-2">
  82
  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>
  91
  92 </div>
  93
  94 <div id="outline-container-3" class="outline-2">
  95 <h2 id="sec-3">3 C++ Compiler version</h2>
  96 <div id="text-3">
  97
  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.
 114
 115 </li>
 116 </ul>
 117 </div>
 118
 119 </div>
 120
 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">
 124
 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.
 203
 204 </li>
 205 </ul>
 206 </div>
 207
 208 </div>
 209
 210 <div id="outline-container-5" class="outline-2">
 211 <h2 id="sec-5">5 Automatic mesher</h2>
 212 <div id="text-5">
 213
 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>
 224
 225 </div>
 226
 227 <div id="outline-container-6" class="outline-2">
 228 <h2 id="sec-6">6 Developments to utilities</h2>
 229 <div id="text-6">
 230
 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.
 269
 270 </li>
 271 </ul>
 272 </div>
 273
 274 </div>
 275
 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">
 279
 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.
 288
 289 </li>
 290 </ul>
 291 </div>
 292
 293 </div>
 294
 295 <div id="outline-container-8" class="outline-2">
 296 <h2 id="sec-8">8 Model development</h2>
 297 <div id="text-8">
 298
 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.
 334
 335 </li>
 336 </ul>
 337 </div>
 338
 339 </div>
 340
 341 <div id="outline-container-9" class="outline-2">
 342 <h2 id="sec-9">9 New functionObjects</h2>
 343 <div id="text-9">
 344
 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.
 362
 363 </li>
 364 </ul>
 365 </div>
 366
 367 </div>
 368
 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">
 372
 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.
 391
 392 </li>
 393 </ul>
 394 </div>
 395
 396 </div>
 397
 398 <div id="outline-container-11" class="outline-2">
 399 <h2 id="sec-11">11 Other</h2>
 400 <div id="text-11">
 401
 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 </div></body>
 428 </html>