ReleaseNotes-1.7-OpenFOAM

   1 #                            -*- mode: org; -*-
   2 #
   3 #+TITLE:           OpenFOAM release notes for version 1.7.x
   4 #+AUTHOR:                      OpenCFD Ltd.
   5 #+DATE:                        24 June 2010
   6 #+LINK:                   http://www.openfoam.com
   7 #+OPTIONS: author:nil ^:{}
   8 # Copyright (c) 2010 OpenCFD Ltd.
   9
  10 * Overview
  11   OpenFOAM-1.7.x is the latest release of OpenFOAM that contains new features
  12   both from OpenCFD's development version of OpenFOAM and the repository 1.6.x
  13   distribution.  This release passes our standard tests and the tutorials have
  14   been broadly checked.  Please report any bugs by following the link:
  15   http://www.openfoam.com/bugs.
  16
  17 * GNU/Linux version
  18   This release of OpenFOAM is distributed primarily in 2 ways: (1) as a Debian
  19   pack containing binaries and source; (2) from the SourceForge source code
  20   repository (see [[./README][README]]).
  21
  22   The Ubuntu/Debian pack is available for 32 and 64 bit versions of the 10.04
  23   LTS operating system using the system compiler and libraries that will be
  24   installed automatically from standard Debian packs.
  25
  26   To use the source version from the SourceForge repository, we provide a source
  27   pack of third-party packages that can be compiled on the user's system.  This
  28   does not include =gcc=, since the system installed version is typically
  29   sufficient, but includes =paraview-3.8.0=, =openmpi-1.4.1=, =scotch_5.1=,
  30   =metis-5.0pre2=, =ParMetis-3.1= and =ParMGridGen-1.0=.
  31
  32 * Library developments
  33   There have been a number of developments to the libraries to support the
  34   extension of functionality in solver and utility applications.
  35 *** Core library
  36     + Large number of code refinements and consistency improvements to support
  37       other developments.
  38 *** Turbulence modelling
  39     + Wall function boundary conditions:
  40       + *New* =mutWallFunction= continuous wall function,
  41       + *New* =mutLowReWallFunction= continuous wall function,
  42       + *New* =nutWallFunction= continuous wall function,
  43       + *New* =nutLowReWallFunction= continuous wall function,
  44       + Standard wall functions, based on k, now renamed  =nutkWallFunction= and
  45         =mutkWallFunction=
  46       + =omegaWallFunction= now includes laminar blending function.
  47     + Conjugate heat transfer boundary conditions:
  48       + *New* =turbulentTemperatureCoupledBaffleMixed= BC,
  49       + *New* =turbulentTemperatureCoupledBaffle=  BC.
  50 *** Thermo-physical Models
  51     There has been a set of developments to redefine the thermodynamics in some
  52     solvers in terms of sensible enthalpy instead of total (i.e. including
  53     chemical) enthalpy.  This was done to improve the handling of
  54     thermodynamics in the case of partially-premixed or non-premixed combustion
  55     systems, or to handle systems with non-unity Lewis number.
  56     + *New* =hsPsiThermo= thermophysical model calculation based on sensible
  57        enthalpy =hs= and compressibility =psi=.
  58     + *New* =hsRhoThermo= thermophysical model calculation based on =hs= and
  59       density =rho=.
  60     + *New* =hsCombustionThermo= thermophysical model calculation for a
  61       combustion mixture based on =hs= and =psi=.
  62     + *New* =hsPsiMixtureThermo= thermophysical model calculation for a
  63       mixture based on =hs= and =psi=.
  64     + *New* =hsReactionThermo= thermophysical model calculation for a complex
  65       reacting mixture based on =hs=.
  66 *** DSMC
  67     + 1D and 2D planar simulations now possible by specifying empty patches in
  68       the usual way.
  69     + *New* =MixedDiffuseSpecular= wall boundary condition added.
  70     + *New* pressure field measurement.
  71     + *New* measurement of velocity slip and temperature jump.
  72 *** Dynamic Mesh
  73     + *New* =sixDoFRigidBodyDisplacement= six degree-of-freedom, fluid coupled
  74       rigid body motion, applied as a boundary condition to a patch in the
  75       pointDisplacement field for dynamic mesh cases.  The motion may have any
  76       number of restraints (springs and dampers) and constraints (reductions in
  77       degrees-of-freedom) applied. Restraints include
  78       =linearAxialAngularSpring=, =linearSpring=, =sphericalAngularSpring= and
  79       =tabulatedAxialAngularSpring=.
  80       Constraints include =fixedAxis=, =fixedLine=, =fixedOrientation=,
  81       =fixedPlane= and =fixedPoint=.
  82 *** Numerics
  83     + MULES now supports sub-cycling on moving meshes for interface capturing
  84       VoF (volume of fluid) calculations.
  85     + Developments to =TimeActivatedExplicitSource=, a class that allows a
  86       source to be applied to an equation according to an input dictionary at
  87       run-time, that can be switched on at particular times and within
  88       particular regions of the mesh, using =cellZones=.
  89
  90 * Solvers
  91   A number of new solvers have been developed for a range of engineering
  92   applications.  There has been a set of improvements to certain classes of
  93   solver that are introduced in this release.
  94 *** *New* Solvers
  95     + =fireFoam=: Transient solver for fires and turbulent diffusion flames.
  96     + =rhoPorousMRFPimpleFoam=: Transient solver for laminar or turbulent flow
  97       of compressible fluids with support for porous media and MRF for HVAC and
  98       similar applications.  Uses the flexible PIMPLE (PISO-SIMPLE) solution for
  99       time-resolved and pseudo-transient simulations.
 100     + =chtMultiRegionSimpleFoam=: Steady-state version of =chtMultiRegionFoam=.
 101     + =porousSimpleFoam=: Steady-state solver for incompressible, turbulent
 102       flow with implicit or explicit porosity treatment.
 103     + =interMixingFoam=: Solver for 3 incompressible fluids, two of which are
 104       miscible, using a VoF method to capture the interface.
 105     + =porousInterFoam=: Solver for 2 incompressible, isothermal immiscible
 106       fluids using a VoF phase-fraction based interface capturing approach.
 107     + =simpleWindFoam=: Steady-state solver for incompressible, turbulent flow
 108       with external source in the momentum equation to approximate, e.g. wind
 109       turbines; located in tutorials, with associated =turbineSiting= test
 110       case.
 111 *** Modifications to multiphase and buoyant solvers
 112     + Multiphase and buoyant flow solvers now solve for =p_rgh= = =p - rho*g.h=,
 113       rather than the static pressure =p=.  This change is to avoid deficiencies
 114       in the handling of the pressure force / buoyant force balance on
 115       non-orthogonal and distorted meshes.
 116     + Improvements to boundary conditions and pressure referencing in closed
 117       domains have been developed to avoid the problems encountered in previous
 118       attempts to decompose pressure for buoyant flow.
 119     + The following solvers have been modified for =p_rgh=: =fireFoam=
 120       =buoyantBoussinesqPimpleFoam=, =buoyantBoussinesqSimpleFoam=,
 121       =buoyantPimpleFoam=, =buoyantSimpleFoam=, =chtMultiRegionFoam=,
 122       =chtMultiRegionSimpleFoam=, =compressibleInterDyMFoam=,
 123       =compressibleInterFoam=, =interDyMFoam=, =porousInterFoam=,
 124       =MRFInterFoam=, =interFoam=, =interPhaseChangeFoam=,
 125       =multiphaseInterFoam=, =settlingFoam=, =twoLiquidMixingFoam=.
 126 *** Modifications to solvers for sensible enthalpy
 127     + The following solvers have been modified to solve for =hs= (instead of
 128       =h=): =dieselEngineFoam=, =dieselFoam=, =reactingFoam=,
 129       =rhoReactingFoam=, =coalChemistryFoam=,
 130       =porousExplictSourceReactingParcelFoam=, =reactingParcelFoam=.
 131 *** Modifications to steady-state compressible solvers
 132     + Boundedness to the thermodynamics is ensured by limiting the density,
 133       rather than the pressure.  This improves convergence by maintaining
 134       consistency between the pressure gradient and momentum changes
 135     + Removed the Sp "boundedness" correction in the convection term from the
 136       momentum equation.
 137     + The following solvers have been modified with this change:
 138       =rhoSimpleFoam=, =buoyantSimpleFoam=, =chtMultiRegionSimpleFoam=
 139 *** Other modifications
 140     + Added diffusion number limit to the time-step correction in
 141       =chtMultiRegionFoam=.
 142     + Reformulated pressure correction during phase change to maintain
 143       boundedness of pressure in =cavitatingFoam=.
 144
 145 * Boundary conditions
 146   New boundary conditions have been introduced to support new applications in
 147   OpenFOAM.
 148   + Added new time varying boundary conditions.
 149   + Added new velocity inlets and wall boundary conditions:
 150     =cylindricalInletVelocity=, =swirlFlowRateInletVelocity=,
 151     =translatingWallVelocity=.
 152   + Added boundary conditions for wind/atmospheric simulation:
 153     =atmBoundaryLayerInletEpsilon=, =atmBoundaryLayerInletVelocity=,
 154     =fixedShearStress=.
 155
 156 * Utilities
 157   There have been some utilities added and updated in this release.
 158 *** *New* utilities
 159     + =foamToTecplot360=: Tecplot binary file format writer.
 160     + =IFCLookUpTableGen=: Infinitely-fast chemistry (IFC) look-up table
 161       generator that calculates the infinitely-fast chemistry relationships as a
 162       function of =ft= for a given fuel.
 163 *** Updated utilities
 164     + =gmshToFoam=: adapted for msh2.1 and 2.2 format.
 165     + =snappyHexMesh=: lower memory usage by pre-balancing and non-blocking
 166       transfers.
 167     + =blockMesh=: proper spline edges.
 168     + =setSet=: handling of faceZoneSet, cellZoneSet, pointZoneSet.
 169     + =splitMeshRegions=: option to use existing cellZones only for split.
 170     + =changeDictionary=: allow wildcards in changeDictionaryDict.
 171
 172 * Post-processing
 173   Post-processing has been extended particularly to function objects, the
 174   on-the-fly post-processing system.
 175   + *New* =fieldValues= function object, allows spatial averaging, sum,
 176       min/max calculations to be made on fields in sets of cells or faces in the
 177       geometry
 178   + *New* =surfaceInterpolateFields= function object to generate surface fields
 179       from volume fields where required
 180   + *New* =sampledTriSurfaceMesh= surface type for surface sampling function
 181     object
 182   + *New* =readFields= function object controls the loading of fields from time
 183       directories for further post-processing
 184
 185 * New tutorials
 186   There is a large number of new tutorials to support the new solvers in the
 187   release.
 188   + =combustion/fireFoam/les/smallPoolFire2D=
 189   + =combustion/reactingFoam/ras/counterFlowFlame2D=
 190   + =compressible/rhoPorousMRFPimpleFoam/mixerVessel2D=
 191   + =heatTransfer/chtMultiRegionSimpleFoam/multiRegionHeater=
 192   + =incompressible/pimpleDyMFoam/wingMotion=
 193   + =incompressible/porousSimpleFoam/angledDuctExplicit=
 194   + =incompressible/porousSimpleFoam/angledDuctImplicit=
 195   + =incompressible/simpleWindFoam/turbineSiting=
 196   + =lagrangian/porousExplictSourceReactingParcelFoam/parcelInbox=
 197   + =lagrangian/porousExplictSourceReactingParcelFoam/verticalChannel=
 198   + =multiPhase/interDyMFoam/floatingObject=
 199   + =multiPhase/interMixingFoam/laminar/damBreak=
 200   + =multiPhase/interPhaseChangeFoam/cavitatingBullet=