Formatted & Renamed Release notes
This commit is contained in:
parent
8b9c3d4764
commit
db2f14f563
5 changed files with 1333 additions and 279 deletions
|
@ -77,3 +77,4 @@ Contents:
|
||||||
Tian Tang
|
Tian Tang
|
||||||
Håkan Nilsson
|
Håkan Nilsson
|
||||||
Klas Jareteg
|
Klas Jareteg
|
||||||
|
Carsten Dehning
|
||||||
|
|
308
ReleaseNotes
Normal file
308
ReleaseNotes
Normal file
|
@ -0,0 +1,308 @@
|
||||||
|
# -*- mode: org; -*-
|
||||||
|
#
|
||||||
|
#+TITLE: *Release notes for foam-extend-3.1*
|
||||||
|
#+AUTHOR: foam-extend administrators:
|
||||||
|
#+AUTHOR: Hrvoje Jasak
|
||||||
|
#+AUTHOR: Håkan Nilsson
|
||||||
|
#+AUTHOR: Henrik Rusche
|
||||||
|
#+AUTHOR: Martin Beaudoin
|
||||||
|
#+AUTHOR: Bernhard Gschaider
|
||||||
|
#+DATE: 8 June 2014
|
||||||
|
#+LINK: http://foam-extend.org
|
||||||
|
#+OPTIONS: author:nil
|
||||||
|
#+OPTIONS: toc:2
|
||||||
|
#+OPTIONS: _:nil
|
||||||
|
#+OPTIONS: ^:nil
|
||||||
|
|
||||||
|
################################################################################
|
||||||
|
|
||||||
|
** Overview
|
||||||
|
The foam-extend project is a fork of the OpenFOAM® open source library for
|
||||||
|
Computational Fluid Dynamics (CFD). It is an open project welcoming and
|
||||||
|
integrating contributions from all users and developers. Previously known as
|
||||||
|
OpenFOAM®-dev and OpenFOAM®-extend, it contains bug fixes and performance
|
||||||
|
improvements, as well as extensions and additional features provided
|
||||||
|
by community contributors (see file ListOfContributors), such as dynamic mesh
|
||||||
|
and topological change support, turbomachinery extensions including general
|
||||||
|
grid interpolation (GGI), cyclic GGI and mixing plane, block-coupled matrix
|
||||||
|
support, finite area method, comprehensive mesh motion capability and GPU
|
||||||
|
support. For a full list, see below and previous release notes at:
|
||||||
|
http://sourceforge.net/p/openfoam-extend/wiki/Home/
|
||||||
|
|
||||||
|
Version 3.1, nicknamed "Zagreb", is the current version of foam-extend. The
|
||||||
|
release continues the tradition and spirit of the original FOAM code
|
||||||
|
developed by prof. Jasak and Mr. Weller during their time at
|
||||||
|
Imperial College and released as the general purpose CFD/CCM package by
|
||||||
|
Nabla Ltd. in 2000. In this spirit, we reverted 18 December 2013 to the
|
||||||
|
original numbering scheme (foam-2.3.2, 13 December 2004) as release
|
||||||
|
number 3.0.
|
||||||
|
Visit http://foam-extend.org for more information.
|
||||||
|
|
||||||
|
OPENFOAM® is a registered trademark of ESI Group. OpenFOAM-extend and
|
||||||
|
foam-extend are a community effort not endorsed by ESI Group.
|
||||||
|
|
||||||
|
** Installation
|
||||||
|
foam-extend-3.1 can be compiled and runs on any linux system
|
||||||
|
|
||||||
|
* Main supported OSs:
|
||||||
|
- Ubuntu 14.04
|
||||||
|
- Fedora 20
|
||||||
|
- Mac OS X
|
||||||
|
|
||||||
|
* Compile from source:
|
||||||
|
|
||||||
|
Please refer to doc/buildInstructions/ for details. Further
|
||||||
|
installation instruction are available on the unofficial OpenFOAM
|
||||||
|
Wiki:
|
||||||
|
http://openfoamwiki.net/index.php/Installation/Linux/foam-extend-3.0
|
||||||
|
If you have improvements or build instructions for a new system,
|
||||||
|
please share them with the community (see section "How to
|
||||||
|
contribute", below).
|
||||||
|
|
||||||
|
* Download binary packages:
|
||||||
|
|
||||||
|
Binary packages are available for download at
|
||||||
|
http://sourceforge.net/projects/openfoam-extend/ for the following
|
||||||
|
systems: Ubuntu 14.04, Fedora 20 and Mac OS X.
|
||||||
|
|
||||||
|
* Accompanying ThirdParty software:
|
||||||
|
- gcc compatibility up to 4.8.2
|
||||||
|
- Paraview 4.0.1
|
||||||
|
- qt 4.8.5
|
||||||
|
- openmpi 1.6.5
|
||||||
|
- cmake 2.8.12
|
||||||
|
- metis 5.1.0
|
||||||
|
- parmetis 4.0.3
|
||||||
|
- scotch 6.0.0
|
||||||
|
- ParMGridGen 1.0
|
||||||
|
- mesquite 2.1.2
|
||||||
|
- PyFoam 0.6.3
|
||||||
|
- swak4Foam 0.3.1
|
||||||
|
- zoltan 3.6
|
||||||
|
- bison 2.7
|
||||||
|
- hwloc 1.7.2
|
||||||
|
- libccmio 2.6.1
|
||||||
|
|
||||||
|
** Compatibility
|
||||||
|
Upstream features from the OpenFOAM® code base are merged into
|
||||||
|
foam-extend on regular basis. The interface format of
|
||||||
|
foam-extend-3.1 is largely compatible to OpenFOAM-1.6-ext and
|
||||||
|
OpenFOAM-1.7.x. In some cases, the differences are caused by bug
|
||||||
|
fixes and algorithmic improvements, considered more important than
|
||||||
|
inter-operability.
|
||||||
|
|
||||||
|
** Main differentiators between foam-extend and OpenFOAM
|
||||||
|
A large number of features have been lost within the release of
|
||||||
|
OpenFOAM since version 1.3, the code base has shrunk by more than
|
||||||
|
40%. While we understand the lack of technical ability of
|
||||||
|
supporting advanced CFD features, we feel that existing features and
|
||||||
|
specifically large-scale contributions should remain active and
|
||||||
|
developed further. Below is a list of main features of foam-extend
|
||||||
|
which are lacking, lost, deactivated or unusable in ESI releases:
|
||||||
|
|
||||||
|
* Turbomachinery features, including General Grid Interface (GGI),
|
||||||
|
partial overlap GGI, cyclic GGI, with improvements in parallel
|
||||||
|
scaling. First release of a mixing plane stage interface
|
||||||
|
|
||||||
|
* Dynamic mesh with topological changes Sliding interfaces, mesh
|
||||||
|
layering, attach-detach boundaries etc. In foam-extend, full
|
||||||
|
parallel support for topological changes is released for the first
|
||||||
|
time
|
||||||
|
|
||||||
|
* Finite Element Method with support for polyhedral meshes This is
|
||||||
|
mainly used in mesh deformation and over the last 15 years it has
|
||||||
|
proven vastly superior to all other dynamic mesh methods.
|
||||||
|
|
||||||
|
* Advanced mesh deformation technology Including tet FEM mesh
|
||||||
|
deformation, Radial Basis Function (RBF) mesh deformation,
|
||||||
|
tetrahedral remeshing dynamic mesh support and solid body motion
|
||||||
|
functions. All of the above include parallelisation support
|
||||||
|
|
||||||
|
* Library of dynamic meshes with topological changes with full
|
||||||
|
second order FVM discretisation support on moving meshes with
|
||||||
|
topological changes
|
||||||
|
|
||||||
|
* Internal combustion engine-specific dynamic mesh classes such as
|
||||||
|
two-stroke engine and various forms of 4-stroke and multi-valve
|
||||||
|
dynamic mesh classes
|
||||||
|
|
||||||
|
* Finite Area Method providing support for FVM-like discretisation
|
||||||
|
on a curved surface in 3-D, with examples of liquid film modelling
|
||||||
|
|
||||||
|
* Block-coupled matrix support, allowing fully implicit
|
||||||
|
multi-equation solution of NxN equation sets, with full
|
||||||
|
parallelisation support. First release of a block-AMG linear
|
||||||
|
equation solver
|
||||||
|
|
||||||
|
* Fully implicit conjugate-coupled solution framework, allowing
|
||||||
|
implicit solution fo multiple equations over multiple meshes, with
|
||||||
|
parallelism
|
||||||
|
|
||||||
|
* Proper Orthogonal Decomposition data analysis tools, with
|
||||||
|
applications to FOAM field classes
|
||||||
|
|
||||||
|
* Equation reader classes and tutorials
|
||||||
|
|
||||||
|
* Multi-solver solution framework, allowing multiple field models to
|
||||||
|
be solved in a coupled manner
|
||||||
|
|
||||||
|
* A major contribution is solid mechanics modelling, including
|
||||||
|
linear and non-linear materials, contact, self-contact and
|
||||||
|
friction, with updated Lagrangian or absolute Lagrangian
|
||||||
|
formulation. Solution of damage models and crack propagation in
|
||||||
|
complex materials via topological changes
|
||||||
|
|
||||||
|
* CUDA solver release, provided in full source and as an example of
|
||||||
|
coupling external linear equation solvers with FOAM
|
||||||
|
|
||||||
|
* Library-level support for Immersed Boundary Method and Overset
|
||||||
|
Mesh
|
||||||
|
|
||||||
|
* Major improvements in accuracy and stability of FVM discretisation
|
||||||
|
with options on convection and diffusion discretisation, deferred
|
||||||
|
correction or explicit schemes
|
||||||
|
|
||||||
|
* Algebraic multigrid solver framework
|
||||||
|
|
||||||
|
* 210 tutorials with automated run scripts
|
||||||
|
|
||||||
|
* Automatic test harness
|
||||||
|
|
||||||
|
** New features in foam-extend-3.1, since foam-extend-3.0
|
||||||
|
The list of features is a result of the work of numerous
|
||||||
|
contributors. The maintainers of foam-extend would formally like to
|
||||||
|
thank them all.
|
||||||
|
|
||||||
|
Get a full log of the updates by (either):
|
||||||
|
#+BEGIN_SRC bash
|
||||||
|
user@machine> git log 3.0.. > commitLog
|
||||||
|
#+END_SRC
|
||||||
|
#+BEGIN_SRC bash
|
||||||
|
user@machine> git log 3.0.. --oneline > commitLog
|
||||||
|
#+END_SRC
|
||||||
|
#+BEGIN_SRC bash
|
||||||
|
user@machine> gitg 3.0..
|
||||||
|
#+END_SRC
|
||||||
|
|
||||||
|
* Major new features:
|
||||||
|
- Pressure-based compressible turbo functionalities
|
||||||
|
- Pressure-based coupled solver (block-coupling p and U)
|
||||||
|
|
||||||
|
* Licence: GPLv3
|
||||||
|
|
||||||
|
* Installation:
|
||||||
|
- Updated and bug-fixed installation procedures
|
||||||
|
- Removed need for gmake link in Ubuntu
|
||||||
|
- Scripts for minimizing installation after compilation
|
||||||
|
- ThirdParty/Allclean alsoPackage - new option
|
||||||
|
- wcleanAllButLibBinLnInclude
|
||||||
|
- Fixed problem with ParaView reader for Ubuntu 14.04
|
||||||
|
- foamToTecplot360: building tecio doesn't require X.org
|
||||||
|
development files
|
||||||
|
|
||||||
|
* Solvers:
|
||||||
|
- compressible/dbnsFoam
|
||||||
|
- compressible/dbnsTurbFoam
|
||||||
|
- compressible/steadyCompressibleFoam
|
||||||
|
- compressible/steadyCompressibleMRFFoam
|
||||||
|
- compressible/steadyCompressibleSRFFoam
|
||||||
|
- coupled/pUCoupledFoam (incl. core library changes)
|
||||||
|
|
||||||
|
- Update and cleanup of solvers/solidMechanics
|
||||||
|
- Update for segregated FEM matrix,
|
||||||
|
solvers/solidMechanics/stressFemFoam
|
||||||
|
|
||||||
|
* Utilities:
|
||||||
|
- convertPhi (for steadyCompressible solvers)
|
||||||
|
- foamMeshToElmer, fluent3DMeshToElmer
|
||||||
|
- transformPoints -cylToCart "origin axis direction" - new option
|
||||||
|
- blockMesh syntax update (see commit a78b12074)
|
||||||
|
|
||||||
|
* Libraries:
|
||||||
|
- General:
|
||||||
|
- Added Gauss-Seidel as asymmetric solver
|
||||||
|
- Block matrix agglomeration (for pUCoupledFoam)
|
||||||
|
- Block AMG solver
|
||||||
|
- dbns library (src/dbns)
|
||||||
|
- Boundary conditions:
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFFlowRateInletVelocity
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFSurfaceNormalVelocity
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFTotalPressure
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFTotalTemperature
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/pulseFixedValue
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/waveTransmissiveInlet
|
||||||
|
- thermophysicalModels/basic/derivedFvPatchFields/isentropicTotalTemperature
|
||||||
|
- thermophysicalModels/basic/derivedFvPatchFields/temperatureDirectedInletOutletVelocity
|
||||||
|
- fvMesh/fvPatches/constraint/mixingPlane
|
||||||
|
- Turbulence modeling:
|
||||||
|
- Removed kOmegaSST_lowRe - USE WHAT INSTEAD???
|
||||||
|
|
||||||
|
- Tutorial updates (settings, initial conditions, bug fixes etc.):
|
||||||
|
- incompressible/icoDyMFoam/mixerGgi
|
||||||
|
- incompressible/icoDyMFoam/movingConeMotion
|
||||||
|
- incompressible/icoDyMFoam/movingConeTopo
|
||||||
|
- solidMechanics/elasticNonLinTLSolidFoam/largeStrainCantileverBeam
|
||||||
|
- solidMechanics/elasticNonLinTLSolidFoam/nonLinBlock
|
||||||
|
- solidMechanics/elasticNonLinTLSolidFoam/rotateSphereTL
|
||||||
|
- solidMechanics/elasticThermalSolidFoam/hotCylinder
|
||||||
|
- solidMechanics/stressFemFoam/plateHole
|
||||||
|
- Many other updates due to blockMesh syntax update
|
||||||
|
|
||||||
|
* New tutorials:
|
||||||
|
- compressible/dbnsFoam/forwardStep
|
||||||
|
- compressible/dbnsFoam/shockTube
|
||||||
|
- compressible/dbnsTurbFoam/naca0012
|
||||||
|
- compressible/steadyCompressibleFoam/2bump
|
||||||
|
- compressible/steadyCompressibleFoam/bumpBlockMesh
|
||||||
|
- compressible/steadyCompressibleFoam/bumpFine05
|
||||||
|
- compressible/steadyCompressibleMRFFoam/bentRotorStator
|
||||||
|
- compressible/steadyCompressibleMRFFoam/simpleRotorStator
|
||||||
|
- compressible/steadyCompressibleSRFFoam/bentBlade
|
||||||
|
- compressible/steadyCompressibleSRFFoam/simpleBlade
|
||||||
|
- coupled/pUCoupledFoam/cavity
|
||||||
|
- incompressible/MRFSimpleFoam/axialTurbine_ggi
|
||||||
|
- incompressible/MRFSimpleFoam/axialTurbine_mixingPlane
|
||||||
|
- incompressible/pimpleDyMFoam/axialTurbine
|
||||||
|
- incompressible/pimpleDyMFoam/movingCylinders
|
||||||
|
- incompressible/pUCoupledFoam/backwardFacingStepLaminar
|
||||||
|
- incompressible/pUCoupledFoam/backwardFacingStepTurbulent
|
||||||
|
- incompressible/pUCoupledFoam/cavity
|
||||||
|
- incompressible/simpleSRFFoam/axialTurbine
|
||||||
|
- mesh/moveDynamicMesh/movingCylinders
|
||||||
|
|
||||||
|
* Bug fixes:
|
||||||
|
LinearUpwind no longer hangs in parallel execution on empty patches
|
||||||
|
|
||||||
|
** Recent sucessful compilations and tests
|
||||||
|
* Ubuntu 14.04:
|
||||||
|
|
||||||
|
http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=736
|
||||||
|
|
||||||
|
* Ubuntu 12.04:
|
||||||
|
|
||||||
|
http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=738
|
||||||
|
|
||||||
|
* CentOS 6.4:
|
||||||
|
|
||||||
|
http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=734
|
||||||
|
|
||||||
|
* Mac OX X & CLang:
|
||||||
|
|
||||||
|
http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=733
|
||||||
|
|
||||||
|
* Mac OX X & gcc
|
||||||
|
|
||||||
|
http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=737
|
||||||
|
|
||||||
|
** Reporting bugs
|
||||||
|
To report bugs, please use the MantisBT bugtracker at
|
||||||
|
http://sourceforge.net/apps/mantisbt/openfoam-extend
|
||||||
|
|
||||||
|
** How to contribute
|
||||||
|
All your contributions are highly welcome: New solvers, utilities and
|
||||||
|
models; bug fixes; documentation. The many ways of contributing and the
|
||||||
|
contribution process are described in detail in the file "HowToContribute"
|
||||||
|
and at http://sourceforge.net/p/openfoam-extend/wiki/Home/
|
||||||
|
|
||||||
|
** List of Contributors:
|
||||||
|
See file ListOfContributors
|
|
@ -1,279 +0,0 @@
|
||||||
# -*- mode: org; -*-
|
|
||||||
#
|
|
||||||
#+TITLE: *Release notes for foam-extend-3.1*
|
|
||||||
#+AUTHOR: foam-extend administrators:
|
|
||||||
#+AUTHOR: Hrvoje Jasak
|
|
||||||
#+AUTHOR: Håkan Nilsson
|
|
||||||
#+AUTHOR: Henrik Rusche
|
|
||||||
#+AUTHOR: Martin Beaudoin
|
|
||||||
#+AUTHOR: Bernhard Gschaider
|
|
||||||
#+DATE: 8 June 2014
|
|
||||||
#+LINK: http://foam-extend.org
|
|
||||||
#+OPTIONS: author:nil
|
|
||||||
|
|
||||||
################################################################################
|
|
||||||
|
|
||||||
Contents:
|
|
||||||
* Overview
|
|
||||||
* Installation
|
|
||||||
* Compatibility
|
|
||||||
* Main differentiators compared to OpenFOAM
|
|
||||||
* New features in foam-extend-3.1, since foam-extend-3.0
|
|
||||||
* Reporting bugs
|
|
||||||
* How to contribute
|
|
||||||
* List of Contributors
|
|
||||||
|
|
||||||
################################################################################
|
|
||||||
|
|
||||||
* Overview
|
|
||||||
The foam-extend project is a fork of the OpenFOAM® open source library for
|
|
||||||
Computational Fluid Dynamics (CFD). It is an open project welcoming and
|
|
||||||
integrating contributions from all users and developers. Previously known as
|
|
||||||
OpenFOAM®-dev and OpenFOAM®-extend, it contains bug fixes and performance
|
|
||||||
improvements, as well as extensions and additional features provided
|
|
||||||
by community contributors (see file ListOfContributors), such as dynamic mesh
|
|
||||||
and topological change support, turbomachinery extensions including general
|
|
||||||
grid interpolation (GGI), cyclic GGI and mixing plane, block-coupled matrix
|
|
||||||
support, finite area method, comprehensive mesh motion capability and GPU
|
|
||||||
support. For a full list, see below and previous release notes at:
|
|
||||||
http://sourceforge.net/p/openfoam-extend/wiki/Home/
|
|
||||||
|
|
||||||
Version 3.1, nicknamed "Zagreb", is the current version of foam-extend. The
|
|
||||||
release continues the tradition and spirit of the original FOAM code
|
|
||||||
developed by prof. Jasak and Mr. Weller during their time at
|
|
||||||
Imperial College and released as the general purpose CFD/CCM package by
|
|
||||||
Nabla Ltd. in 2000. In this spirit, we reverted 18 December 2013 to the
|
|
||||||
original numbering scheme (foam-2.3.2, 13 December 2004) as release
|
|
||||||
number 3.0.
|
|
||||||
Visit http://foam-extend.org for more information.
|
|
||||||
|
|
||||||
OPENFOAM® is a registered trademark of ESI Group. OpenFOAM-extend and
|
|
||||||
foam-extend are a community effort not endorsed by ESI Group.
|
|
||||||
|
|
||||||
* Installation
|
|
||||||
foam-extend-3.1 can be compiled and runs on any linux system
|
|
||||||
|
|
||||||
Main supported OSs:
|
|
||||||
Ubuntu 14.04
|
|
||||||
Mac OS X
|
|
||||||
|
|
||||||
** Compile from source:
|
|
||||||
Please refer to doc/buildInstructions/ for details. Further
|
|
||||||
installation instruction are available on the unofficial OpenFOAM Wiki:
|
|
||||||
http://openfoamwiki.net/index.php/Installation/Linux/foam-extend-3.0
|
|
||||||
If you have improvements or build instructions for a new system, please
|
|
||||||
share them with the community (see section "How to contribute", below).
|
|
||||||
|
|
||||||
** Download binary packages:
|
|
||||||
Binary packages are available for download at
|
|
||||||
http://sourceforge.net/projects/openfoam-extend/
|
|
||||||
for the following systems: Ubuntu 14.04 and Fedora 20.
|
|
||||||
|
|
||||||
** Accompanying ThirdParty software:
|
|
||||||
gcc compatibility up to 4.8.2
|
|
||||||
Paraview 4.0.1
|
|
||||||
qt 4.8.5
|
|
||||||
openmpi 1.6.5
|
|
||||||
cmake 2.8.12
|
|
||||||
metis 5.1.0
|
|
||||||
parmetis 4.0.3
|
|
||||||
scotch 6.0.0
|
|
||||||
ParMGridGen 1.0
|
|
||||||
mesquite 2.1.2
|
|
||||||
PyFoam 0.6.3
|
|
||||||
swak4Foam 0.3.1
|
|
||||||
zoltan 3.6
|
|
||||||
bison 2.7
|
|
||||||
hwloc 1.7.2
|
|
||||||
libccmio 2.6.1
|
|
||||||
|
|
||||||
* Compatibility
|
|
||||||
Upstream features from the OpenFOAM® code base are merged into foam-extend
|
|
||||||
on regular basis. The interface format of foam-extend-3.1 is largely
|
|
||||||
compatible to OpenFOAM-1.6-ext and OpenFOAM-1.7.x. In some cases,
|
|
||||||
the differences are caused by bug fixes and algorithmic improvements,
|
|
||||||
considered more important than inter-operability.
|
|
||||||
|
|
||||||
* Main differentiators compared to OpenFOAM
|
|
||||||
A large number of features have been lost within the release of OpenFOAM
|
|
||||||
since version 1.3, the code base has shrunk by more than 40%. While
|
|
||||||
we understand the lack of technical ability of supporting advanced
|
|
||||||
CFD features, we feel that existing features and specifically large-scale
|
|
||||||
contributions should remain active and developed further. Below is a list
|
|
||||||
of main features of foam-extend which are lacking, lost, deactivated or
|
|
||||||
unusable in ESI releases:
|
|
||||||
|
|
||||||
** Turbomachinery features, including General Grid Interface (GGI),
|
|
||||||
partial overlap GGI, cyclic GGI, with improvements in parallel scaling.
|
|
||||||
First release of a mixing plane stage interface
|
|
||||||
|
|
||||||
** Dynamic mesh with topological changes
|
|
||||||
Sliding interfaces, mesh layering, attach-detach boundaries etc.
|
|
||||||
In foam-extend, full parallel support for topological changes
|
|
||||||
is released for the first time
|
|
||||||
|
|
||||||
** Finite Element Method with support for polyhedral meshes
|
|
||||||
This is mainly used in mesh deformation and over the last 15 years
|
|
||||||
it has proven vastly superior to all other dynamic mesh methods.
|
|
||||||
|
|
||||||
** Advanced mesh deformation technology
|
|
||||||
Including tet FEM mesh deformation, Radial Basis Function (RBF) mesh
|
|
||||||
deformation, tetrahedral remeshing dynamic mesh support and solid body
|
|
||||||
motion functions. All of the above include parallelisation support
|
|
||||||
|
|
||||||
** Library of dynamic meshes with topological changes with full
|
|
||||||
second order FVM discretisation support on moving meshes with
|
|
||||||
topological changes
|
|
||||||
|
|
||||||
** Internal combustion engine-specific dynamic mesh classes such as
|
|
||||||
two-stroke engine and various forms of 4-stroke and multi-valve
|
|
||||||
dynamic mesh classes
|
|
||||||
|
|
||||||
** Finite Area Method providing support for FVM-like discretisation on
|
|
||||||
a curved surface in 3-D, with examples of liquid film modelling
|
|
||||||
|
|
||||||
** Block-coupled matrix support, allowing fully implicit multi-equation
|
|
||||||
solution of NxN equation sets, with full parallelisation support.
|
|
||||||
First release of a block-AMG linear equation solver
|
|
||||||
|
|
||||||
** Fully implicit conjugate-coupled solution framework, allowing implicit
|
|
||||||
solution fo multiple equations over multiple meshes, with parallelism
|
|
||||||
|
|
||||||
** Proper Orthogonal Decomposition data analysis tools, with applications
|
|
||||||
to FOAM field classes
|
|
||||||
|
|
||||||
** Equation reader classes and tutorials
|
|
||||||
|
|
||||||
** Multi-solver solution framework, allowing multiple field models to be
|
|
||||||
solved in a coupled manner
|
|
||||||
|
|
||||||
** A major contribution is solid mechanics modelling, including linear
|
|
||||||
and non-linear materials, contact, self-contact and friction, with
|
|
||||||
updated Lagrangian or absolute Lagrangian formulation. Solution of
|
|
||||||
damage models and crack propagation in complex materials via
|
|
||||||
topological changes
|
|
||||||
|
|
||||||
** CUDA solver release, provided in full source and as an example of
|
|
||||||
coupling external linear equation solvers with FOAM
|
|
||||||
|
|
||||||
** Library-level support for Immersed Boundary Method and Overset Mesh
|
|
||||||
|
|
||||||
** Major improvements in accuracy and stability of FVM discretisation
|
|
||||||
with options on convection and diffusion discretisation, deferred
|
|
||||||
correction or explicit schemes
|
|
||||||
|
|
||||||
** Algebraic multigrid solver framework
|
|
||||||
|
|
||||||
** 210 tutorials with automated run scripts
|
|
||||||
|
|
||||||
** Automatic test harness
|
|
||||||
|
|
||||||
* New features in foam-extend-3.1, since foam-extend-3.0
|
|
||||||
The list of features is a result of the work of numerous contributors. The
|
|
||||||
maintainers of foam-extend would formally like to thank them all.
|
|
||||||
|
|
||||||
Get a full log of the updates by (either):
|
|
||||||
git log 3.0.. > commitLog
|
|
||||||
git log 3.0.. --oneline > commitLog
|
|
||||||
gitg 3.0..
|
|
||||||
|
|
||||||
Major new features:
|
|
||||||
Pressure-based compressible turbo functionalities
|
|
||||||
Pressure-based coupled solver (block-coupling p and U)
|
|
||||||
|
|
||||||
Licence:
|
|
||||||
Bumped to GPLv3
|
|
||||||
|
|
||||||
Installation:
|
|
||||||
Updated and bug-fixed installation procedures
|
|
||||||
Removed need for gmake link in Ubuntu
|
|
||||||
Scripts for minimizing installation after compilation
|
|
||||||
ThirdParty/Allclean alsoPackage - new option
|
|
||||||
wcleanAllButLibBinLnInclude
|
|
||||||
Fixed problem with ParaView reader for Ubuntu 14.04
|
|
||||||
foamToTecplot360: building tecio doesn't require X.org development files
|
|
||||||
|
|
||||||
Solvers:
|
|
||||||
compressible/dbnsFoam
|
|
||||||
compressible/dbnsTurbFoam
|
|
||||||
compressible/steadyCompressibleFoam
|
|
||||||
compressible/steadyCompressibleMRFFoam
|
|
||||||
compressible/steadyCompressibleSRFFoam
|
|
||||||
coupled/pUCoupledFoam (incl. core library changes)
|
|
||||||
---
|
|
||||||
Update and cleanup of solvers/solidMechanics
|
|
||||||
Update for segregated FEM matrix, solvers/solidMechanics/stressFemFoam
|
|
||||||
|
|
||||||
Utilities:
|
|
||||||
convertPhi (for steadyCompressible solvers)
|
|
||||||
fluent3DMeshToElmer
|
|
||||||
foamMeshToElmer
|
|
||||||
transformPoints -cylToCart "origin axis direction" - new option
|
|
||||||
blockMesh syntax backport (see commit a78b12074)
|
|
||||||
|
|
||||||
Libraries:
|
|
||||||
General:
|
|
||||||
Added Gauss-Seidel as asymmetric solver
|
|
||||||
Block matrix agglomeration (for pUCoupledFoam)
|
|
||||||
Block AMG solver
|
|
||||||
dbns library (src/dbns)
|
|
||||||
Boundary conditions:
|
|
||||||
cfdTools/general/SRF/derivedFvPatchFields/SRFFlowRateInletVelocity
|
|
||||||
cfdTools/general/SRF/derivedFvPatchFields/SRFSurfaceNormalVelocity*
|
|
||||||
cfdTools/general/SRF/derivedFvPatchFields/SRFTotalPressure
|
|
||||||
cfdTools/general/SRF/derivedFvPatchFields/SRFTotalTemperature
|
|
||||||
cfdTools/general/SRF/derivedFvPatchFields/pulseFixedValue
|
|
||||||
cfdTools/general/SRF/derivedFvPatchFields/waveTransmissiveInlet
|
|
||||||
thermophysicalModels/basic/derivedFvPatchFields/isentropicTotalTemperature
|
|
||||||
thermophysicalModels/basic/derivedFvPatchFields/temperatureDirectedInletOutletVelocity
|
|
||||||
Turbulence modeling:
|
|
||||||
Removed kOmegaSST_lowRe - USE WHAT INSTEAD???
|
|
||||||
|
|
||||||
Tutorial updates (settings, initial conditions, bug fixes etc.):
|
|
||||||
incompressible/icoDyMFoam/mixerGgi
|
|
||||||
incompressible/icoDyMFoam/movingConeMotion
|
|
||||||
incompressible/icoDyMFoam/movingConeTopo
|
|
||||||
solidMechanics/elasticNonLinTLSolidFoam/largeStrainCantileverBeam
|
|
||||||
solidMechanics/elasticNonLinTLSolidFoam/nonLinBlock
|
|
||||||
solidMechanics/elasticNonLinTLSolidFoam/rotateSphereTL
|
|
||||||
solidMechanics/elasticThermalSolidFoam/hotCylinder
|
|
||||||
solidMechanics/stressFemFoam/plateHole
|
|
||||||
Many other updates due to blockMesh backport
|
|
||||||
|
|
||||||
New tutorials:
|
|
||||||
compressible/dbnsFoam/forwardStep
|
|
||||||
compressible/dbnsFoam/shockTube
|
|
||||||
compressible/dbnsTurbFoam/naca0012
|
|
||||||
compressible/steadyCompressibleFoam/2bump
|
|
||||||
compressible/steadyCompressibleFoam/bumpBlockMesh
|
|
||||||
compressible/steadyCompressibleFoam/bumpFine05
|
|
||||||
compressible/steadyCompressibleMRFFoam/bentRotorStator
|
|
||||||
compressible/steadyCompressibleMRFFoam/simpleRotorStator
|
|
||||||
compressible/steadyCompressibleSRFFoam/bentBlade
|
|
||||||
compressible/steadyCompressibleSRFFoam/simpleBlade
|
|
||||||
coupled/pUCoupledFoam/cavity
|
|
||||||
incompressible/MRFSimpleFoam/axialTurbine_ggi
|
|
||||||
incompressible/MRFSimpleFoam/axialTurbine_mixingPlane
|
|
||||||
incompressible/pimpleDyMFoam/axialTurbine
|
|
||||||
incompressible/pimpleDyMFoam/movingCylinders
|
|
||||||
incompressible/pUCoupledFoam/backwardFacingStepLaminar
|
|
||||||
incompressible/pUCoupledFoam/backwardFacingStepTurbulent
|
|
||||||
incompressible/pUCoupledFoam/cavity
|
|
||||||
incompressible/simpleSRFFoam/axialTurbine
|
|
||||||
mesh/moveDynamicMesh/movingCylinders
|
|
||||||
|
|
||||||
Bug fixes:
|
|
||||||
LinearUpwind no longer hangs in parallel execution on empty patches
|
|
||||||
|
|
||||||
* Reporting bugs
|
|
||||||
To report bugs, please use the MantisBT bugtracker at
|
|
||||||
http://sourceforge.net/apps/mantisbt/openfoam-extend
|
|
||||||
|
|
||||||
* How to contribute
|
|
||||||
All your contributions are highly welcome: New solvers, utilities and
|
|
||||||
models; bug fixes; documentation. The many ways of contributing and the
|
|
||||||
contribution process are described in detail in the file "HowToContribute"
|
|
||||||
and at http://sourceforge.net/p/openfoam-extend/wiki/Home/
|
|
||||||
|
|
||||||
* List of Contributors:
|
|
||||||
See file ListOfContributors
|
|
683
ReleaseNotes.html
Normal file
683
ReleaseNotes.html
Normal file
|
@ -0,0 +1,683 @@
|
||||||
|
<?xml version="1.0" encoding="utf-8"?>
|
||||||
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
|
||||||
|
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
|
||||||
|
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
|
||||||
|
<head>
|
||||||
|
<title><b>Release notes for foam-extend-3.1</b></title>
|
||||||
|
<!-- 2014-06-15 Sun 13:44 -->
|
||||||
|
<meta http-equiv="Content-Type" content="text/html;charset=utf-8" />
|
||||||
|
<meta name="generator" content="Org-mode" />
|
||||||
|
<style type="text/css">
|
||||||
|
<!--/*--><![CDATA[/*><!--*/
|
||||||
|
.title { text-align: center; }
|
||||||
|
.todo { font-family: monospace; color: red; }
|
||||||
|
.done { color: green; }
|
||||||
|
.tag { background-color: #eee; font-family: monospace;
|
||||||
|
padding: 2px; font-size: 80%; font-weight: normal; }
|
||||||
|
.timestamp { color: #bebebe; }
|
||||||
|
.timestamp-kwd { color: #5f9ea0; }
|
||||||
|
.right { margin-left: auto; margin-right: 0px; text-align: right; }
|
||||||
|
.left { margin-left: 0px; margin-right: auto; text-align: left; }
|
||||||
|
.center { margin-left: auto; margin-right: auto; text-align: center; }
|
||||||
|
.underline { text-decoration: underline; }
|
||||||
|
#postamble p, #preamble p { font-size: 90%; margin: .2em; }
|
||||||
|
p.verse { margin-left: 3%; }
|
||||||
|
pre {
|
||||||
|
border: 1px solid #ccc;
|
||||||
|
box-shadow: 3px 3px 3px #eee;
|
||||||
|
padding: 8pt;
|
||||||
|
font-family: monospace;
|
||||||
|
overflow: auto;
|
||||||
|
margin: 1.2em;
|
||||||
|
}
|
||||||
|
pre.src {
|
||||||
|
position: relative;
|
||||||
|
overflow: visible;
|
||||||
|
padding-top: 1.2em;
|
||||||
|
}
|
||||||
|
pre.src:before {
|
||||||
|
display: none;
|
||||||
|
position: absolute;
|
||||||
|
background-color: white;
|
||||||
|
top: -10px;
|
||||||
|
right: 10px;
|
||||||
|
padding: 3px;
|
||||||
|
border: 1px solid black;
|
||||||
|
}
|
||||||
|
pre.src:hover:before { display: inline;}
|
||||||
|
pre.src-sh:before { content: 'sh'; }
|
||||||
|
pre.src-bash:before { content: 'sh'; }
|
||||||
|
pre.src-emacs-lisp:before { content: 'Emacs Lisp'; }
|
||||||
|
pre.src-R:before { content: 'R'; }
|
||||||
|
pre.src-perl:before { content: 'Perl'; }
|
||||||
|
pre.src-java:before { content: 'Java'; }
|
||||||
|
pre.src-sql:before { content: 'SQL'; }
|
||||||
|
|
||||||
|
table { border-collapse:collapse; }
|
||||||
|
td, th { vertical-align:top; }
|
||||||
|
th.right { text-align: center; }
|
||||||
|
th.left { text-align: center; }
|
||||||
|
th.center { text-align: center; }
|
||||||
|
td.right { text-align: right; }
|
||||||
|
td.left { text-align: left; }
|
||||||
|
td.center { text-align: center; }
|
||||||
|
dt { font-weight: bold; }
|
||||||
|
.footpara:nth-child(2) { display: inline; }
|
||||||
|
.footpara { display: block; }
|
||||||
|
.footdef { margin-bottom: 1em; }
|
||||||
|
.figure { padding: 1em; }
|
||||||
|
.figure p { text-align: center; }
|
||||||
|
.inlinetask {
|
||||||
|
padding: 10px;
|
||||||
|
border: 2px solid gray;
|
||||||
|
margin: 10px;
|
||||||
|
background: #ffffcc;
|
||||||
|
}
|
||||||
|
#org-div-home-and-up
|
||||||
|
{ text-align: right; font-size: 70%; white-space: nowrap; }
|
||||||
|
textarea { overflow-x: auto; }
|
||||||
|
.linenr { font-size: smaller }
|
||||||
|
.code-highlighted { background-color: #ffff00; }
|
||||||
|
.org-info-js_info-navigation { border-style: none; }
|
||||||
|
#org-info-js_console-label
|
||||||
|
{ font-size: 10px; font-weight: bold; white-space: nowrap; }
|
||||||
|
.org-info-js_search-highlight
|
||||||
|
{ background-color: #ffff00; color: #000000; font-weight: bold; }
|
||||||
|
/*]]>*/-->
|
||||||
|
</style>
|
||||||
|
<script type="text/javascript">
|
||||||
|
/*
|
||||||
|
@licstart The following is the entire license notice for the
|
||||||
|
JavaScript code in this tag.
|
||||||
|
|
||||||
|
Copyright (C) 2012-2013 Free Software Foundation, Inc.
|
||||||
|
|
||||||
|
The JavaScript code in this tag is free software: you can
|
||||||
|
redistribute it and/or modify it under the terms of the GNU
|
||||||
|
General Public License (GNU GPL) as published by the Free Software
|
||||||
|
Foundation, either version 3 of the License, or (at your option)
|
||||||
|
any later version. The code is distributed WITHOUT ANY WARRANTY;
|
||||||
|
without even the implied warranty of MERCHANTABILITY or FITNESS
|
||||||
|
FOR A PARTICULAR PURPOSE. See the GNU GPL for more details.
|
||||||
|
|
||||||
|
As additional permission under GNU GPL version 3 section 7, you
|
||||||
|
may distribute non-source (e.g., minimized or compacted) forms of
|
||||||
|
that code without the copy of the GNU GPL normally required by
|
||||||
|
section 4, provided you include this license notice and a URL
|
||||||
|
through which recipients can access the Corresponding Source.
|
||||||
|
|
||||||
|
|
||||||
|
@licend The above is the entire license notice
|
||||||
|
for the JavaScript code in this tag.
|
||||||
|
*/
|
||||||
|
<!--/*--><![CDATA[/*><!--*/
|
||||||
|
function CodeHighlightOn(elem, id)
|
||||||
|
{
|
||||||
|
var target = document.getElementById(id);
|
||||||
|
if(null != target) {
|
||||||
|
elem.cacheClassElem = elem.className;
|
||||||
|
elem.cacheClassTarget = target.className;
|
||||||
|
target.className = "code-highlighted";
|
||||||
|
elem.className = "code-highlighted";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
function CodeHighlightOff(elem, id)
|
||||||
|
{
|
||||||
|
var target = document.getElementById(id);
|
||||||
|
if(elem.cacheClassElem)
|
||||||
|
elem.className = elem.cacheClassElem;
|
||||||
|
if(elem.cacheClassTarget)
|
||||||
|
target.className = elem.cacheClassTarget;
|
||||||
|
}
|
||||||
|
/*]]>*///-->
|
||||||
|
</script>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="content">
|
||||||
|
<h1 class="title"><b>Release notes for foam-extend-3.1</b></h1>
|
||||||
|
<div id="table-of-contents">
|
||||||
|
<h2>Table of Contents</h2>
|
||||||
|
<div id="text-table-of-contents">
|
||||||
|
<ul>
|
||||||
|
<li><a href="#sec-1">1. Overview</a></li>
|
||||||
|
<li><a href="#sec-2">2. Installation</a></li>
|
||||||
|
<li><a href="#sec-3">3. Compatibility</a></li>
|
||||||
|
<li><a href="#sec-4">4. Main differentiators between foam-extend and OpenFOAM</a></li>
|
||||||
|
<li><a href="#sec-5">5. New features in foam-extend-3.1, since foam-extend-3.0</a></li>
|
||||||
|
<li><a href="#sec-6">6. Recent sucessful compilations and tests</a></li>
|
||||||
|
<li><a href="#sec-7">7. Reporting bugs</a></li>
|
||||||
|
<li><a href="#sec-8">8. How to contribute</a></li>
|
||||||
|
<li><a href="#sec-9">9. List of Contributors:</a></li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<p>
|
||||||
|
################################################################################
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<div id="outline-container-sec-1" class="outline-2">
|
||||||
|
<h2 id="sec-1"><span class="section-number-2">1</span> Overview</h2>
|
||||||
|
<div class="outline-text-2" id="text-1">
|
||||||
|
<p>
|
||||||
|
The foam-extend project is a fork of the OpenFOAM® open source library for
|
||||||
|
Computational Fluid Dynamics (CFD). It is an open project welcoming and
|
||||||
|
integrating contributions from all users and developers. Previously known as
|
||||||
|
OpenFOAM®-dev and OpenFOAM®-extend, it contains bug fixes and performance
|
||||||
|
improvements, as well as extensions and additional features provided
|
||||||
|
by community contributors (see file ListOfContributors), such as dynamic mesh
|
||||||
|
and topological change support, turbomachinery extensions including general
|
||||||
|
grid interpolation (GGI), cyclic GGI and mixing plane, block-coupled matrix
|
||||||
|
support, finite area method, comprehensive mesh motion capability and GPU
|
||||||
|
support. For a full list, see below and previous release notes at:
|
||||||
|
<a href="http://sourceforge.net/p/openfoam-extend/wiki/Home/">http://sourceforge.net/p/openfoam-extend/wiki/Home/</a>
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Version 3.1, nicknamed "Zagreb", is the current version of foam-extend. The
|
||||||
|
release continues the tradition and spirit of the original FOAM code
|
||||||
|
developed by prof. Jasak and Mr. Weller during their time at
|
||||||
|
Imperial College and released as the general purpose CFD/CCM package by
|
||||||
|
Nabla Ltd. in 2000. In this spirit, we reverted 18 December 2013 to the
|
||||||
|
original numbering scheme (foam-2.3.2, 13 December 2004) as release
|
||||||
|
number 3.0.
|
||||||
|
Visit <a href="http://foam-extend.org">http://foam-extend.org</a> for more information.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
OPENFOAM® is a registered trademark of ESI Group. OpenFOAM-extend and
|
||||||
|
foam-extend are a community effort not endorsed by ESI Group.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-2" class="outline-2">
|
||||||
|
<h2 id="sec-2"><span class="section-number-2">2</span> Installation</h2>
|
||||||
|
<div class="outline-text-2" id="text-2">
|
||||||
|
<p>
|
||||||
|
foam-extend-3.1 can be compiled and runs on any linux system
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Main supported OSs:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Ubuntu 14.04
|
||||||
|
</li>
|
||||||
|
<li>Fedora 20
|
||||||
|
</li>
|
||||||
|
<li>Mac OS X
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Compile from source:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Please refer to doc/buildInstructions/ for details. Further
|
||||||
|
installation instruction are available on the unofficial OpenFOAM
|
||||||
|
Wiki:
|
||||||
|
<a href="http://openfoamwiki.net/index.php/Installation/Linux/foam-extend-3.0">http://openfoamwiki.net/index.php/Installation/Linux/foam-extend-3.0</a>
|
||||||
|
If you have improvements or build instructions for a new system,
|
||||||
|
please share them with the community (see section "How to
|
||||||
|
contribute", below).
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Download binary packages:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Binary packages are available for download at
|
||||||
|
<a href="http://sourceforge.net/projects/openfoam-extend/">http://sourceforge.net/projects/openfoam-extend/</a> for the following
|
||||||
|
systems: Ubuntu 14.04, Fedora 20 and Mac OS X.
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Accompanying ThirdParty software:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>gcc compatibility up to 4.8.2
|
||||||
|
</li>
|
||||||
|
<li>Paraview 4.0.1
|
||||||
|
</li>
|
||||||
|
<li>qt 4.8.5
|
||||||
|
</li>
|
||||||
|
<li>openmpi 1.6.5
|
||||||
|
</li>
|
||||||
|
<li>cmake 2.8.12
|
||||||
|
</li>
|
||||||
|
<li>metis 5.1.0
|
||||||
|
</li>
|
||||||
|
<li>parmetis 4.0.3
|
||||||
|
</li>
|
||||||
|
<li>scotch 6.0.0
|
||||||
|
</li>
|
||||||
|
<li>ParMGridGen 1.0
|
||||||
|
</li>
|
||||||
|
<li>mesquite 2.1.2
|
||||||
|
</li>
|
||||||
|
<li>PyFoam 0.6.3
|
||||||
|
</li>
|
||||||
|
<li>swak4Foam 0.3.1
|
||||||
|
</li>
|
||||||
|
<li>zoltan 3.6
|
||||||
|
</li>
|
||||||
|
<li>bison 2.7
|
||||||
|
</li>
|
||||||
|
<li>hwloc 1.7.2
|
||||||
|
</li>
|
||||||
|
<li>libccmio 2.6.1
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-3" class="outline-2">
|
||||||
|
<h2 id="sec-3"><span class="section-number-2">3</span> Compatibility</h2>
|
||||||
|
<div class="outline-text-2" id="text-3">
|
||||||
|
<p>
|
||||||
|
Upstream features from the OpenFOAM® code base are merged into
|
||||||
|
foam-extend on regular basis. The interface format of
|
||||||
|
foam-extend-3.1 is largely compatible to OpenFOAM-1.6-ext and
|
||||||
|
OpenFOAM-1.7.x. In some cases, the differences are caused by bug
|
||||||
|
fixes and algorithmic improvements, considered more important than
|
||||||
|
inter-operability.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-4" class="outline-2">
|
||||||
|
<h2 id="sec-4"><span class="section-number-2">4</span> Main differentiators between foam-extend and OpenFOAM</h2>
|
||||||
|
<div class="outline-text-2" id="text-4">
|
||||||
|
<p>
|
||||||
|
A large number of features have been lost within the release of
|
||||||
|
OpenFOAM since version 1.3, the code base has shrunk by more than
|
||||||
|
40%. While we understand the lack of technical ability of
|
||||||
|
supporting advanced CFD features, we feel that existing features and
|
||||||
|
specifically large-scale contributions should remain active and
|
||||||
|
developed further. Below is a list of main features of foam-extend
|
||||||
|
which are lacking, lost, deactivated or unusable in ESI releases:
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Turbomachinery features, including General Grid Interface (GGI),
|
||||||
|
partial overlap GGI, cyclic GGI, with improvements in parallel
|
||||||
|
scaling. First release of a mixing plane stage interface
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Dynamic mesh with topological changes Sliding interfaces, mesh
|
||||||
|
layering, attach-detach boundaries etc. In foam-extend, full
|
||||||
|
parallel support for topological changes is released for the first
|
||||||
|
time
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Finite Element Method with support for polyhedral meshes This is
|
||||||
|
mainly used in mesh deformation and over the last 15 years it has
|
||||||
|
proven vastly superior to all other dynamic mesh methods.
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Advanced mesh deformation technology Including tet FEM mesh
|
||||||
|
deformation, Radial Basis Function (RBF) mesh deformation,
|
||||||
|
tetrahedral remeshing dynamic mesh support and solid body motion
|
||||||
|
functions. All of the above include parallelisation support
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Library of dynamic meshes with topological changes with full
|
||||||
|
second order FVM discretisation support on moving meshes with
|
||||||
|
topological changes
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Internal combustion engine-specific dynamic mesh classes such as
|
||||||
|
two-stroke engine and various forms of 4-stroke and multi-valve
|
||||||
|
dynamic mesh classes
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Finite Area Method providing support for FVM-like discretisation
|
||||||
|
on a curved surface in 3-D, with examples of liquid film modelling
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Block-coupled matrix support, allowing fully implicit
|
||||||
|
multi-equation solution of NxN equation sets, with full
|
||||||
|
parallelisation support. First release of a block-AMG linear
|
||||||
|
equation solver
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Fully implicit conjugate-coupled solution framework, allowing
|
||||||
|
implicit solution fo multiple equations over multiple meshes, with
|
||||||
|
parallelism
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Proper Orthogonal Decomposition data analysis tools, with
|
||||||
|
applications to FOAM field classes
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Equation reader classes and tutorials
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Multi-solver solution framework, allowing multiple field models to
|
||||||
|
be solved in a coupled manner
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>A major contribution is solid mechanics modelling, including
|
||||||
|
linear and non-linear materials, contact, self-contact and
|
||||||
|
friction, with updated Lagrangian or absolute Lagrangian
|
||||||
|
formulation. Solution of damage models and crack propagation in
|
||||||
|
complex materials via topological changes
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>CUDA solver release, provided in full source and as an example of
|
||||||
|
coupling external linear equation solvers with FOAM
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Library-level support for Immersed Boundary Method and Overset
|
||||||
|
Mesh
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Major improvements in accuracy and stability of FVM discretisation
|
||||||
|
with options on convection and diffusion discretisation, deferred
|
||||||
|
correction or explicit schemes
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Algebraic multigrid solver framework
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>210 tutorials with automated run scripts
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Automatic test harness
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-5" class="outline-2">
|
||||||
|
<h2 id="sec-5"><span class="section-number-2">5</span> New features in foam-extend-3.1, since foam-extend-3.0</h2>
|
||||||
|
<div class="outline-text-2" id="text-5">
|
||||||
|
<p>
|
||||||
|
The list of features is a result of the work of numerous
|
||||||
|
contributors. The maintainers of foam-extend would formally like to
|
||||||
|
thank them all.
|
||||||
|
</p>
|
||||||
|
|
||||||
|
<p>
|
||||||
|
Get a full log of the updates by (either):
|
||||||
|
</p>
|
||||||
|
<div class="org-src-container">
|
||||||
|
|
||||||
|
<pre class="src src-bash">user@machine> git log 3.0.. > commitLog
|
||||||
|
</pre>
|
||||||
|
</div>
|
||||||
|
<div class="org-src-container">
|
||||||
|
|
||||||
|
<pre class="src src-bash">user@machine> git log 3.0.. --oneline > commitLog
|
||||||
|
</pre>
|
||||||
|
</div>
|
||||||
|
<div class="org-src-container">
|
||||||
|
|
||||||
|
<pre class="src src-bash">user@machine> gitg 3.0..
|
||||||
|
</pre>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Major new features:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Pressure-based compressible turbo functionalities
|
||||||
|
</li>
|
||||||
|
<li>Pressure-based coupled solver (block-coupling p and U)
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Licence: GPLv3
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Installation:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Updated and bug-fixed installation procedures
|
||||||
|
</li>
|
||||||
|
<li>Removed need for gmake link in Ubuntu
|
||||||
|
</li>
|
||||||
|
<li>Scripts for minimizing installation after compilation
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>ThirdParty/Allclean alsoPackage - new option
|
||||||
|
</li>
|
||||||
|
<li>wcleanAllButLibBinLnInclude
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li>Fixed problem with ParaView reader for Ubuntu 14.04
|
||||||
|
</li>
|
||||||
|
<li>foamToTecplot360: building tecio doesn't require X.org
|
||||||
|
development files
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Solvers:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>compressible/dbnsFoam
|
||||||
|
</li>
|
||||||
|
<li>compressible/dbnsTurbFoam
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleFoam
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleMRFFoam
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleSRFFoam
|
||||||
|
</li>
|
||||||
|
<li>coupled/pUCoupledFoam (incl. core library changes)
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Update and cleanup of solvers/solidMechanics
|
||||||
|
</li>
|
||||||
|
<li>Update for segregated FEM matrix,
|
||||||
|
solvers/solidMechanics/stressFemFoam
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Utilities:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>convertPhi (for steadyCompressible solvers)
|
||||||
|
</li>
|
||||||
|
<li>foamMeshToElmer, fluent3DMeshToElmer
|
||||||
|
</li>
|
||||||
|
<li>transformPoints -cylToCart "origin axis direction" - new option
|
||||||
|
</li>
|
||||||
|
<li>blockMesh syntax update (see commit a78b12074)
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Libraries:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>General:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Added Gauss-Seidel as asymmetric solver
|
||||||
|
</li>
|
||||||
|
<li>Block matrix agglomeration (for pUCoupledFoam)
|
||||||
|
</li>
|
||||||
|
<li>Block AMG solver
|
||||||
|
</li>
|
||||||
|
<li>dbns library (src/dbns)
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li>Boundary conditions:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>cfdTools/general/SRF/derivedFvPatchFields/SRFFlowRateInletVelocity
|
||||||
|
</li>
|
||||||
|
<li>cfdTools/general/SRF/derivedFvPatchFields/SRFSurfaceNormalVelocity
|
||||||
|
</li>
|
||||||
|
<li>cfdTools/general/SRF/derivedFvPatchFields/SRFTotalPressure
|
||||||
|
</li>
|
||||||
|
<li>cfdTools/general/SRF/derivedFvPatchFields/SRFTotalTemperature
|
||||||
|
</li>
|
||||||
|
<li>cfdTools/general/SRF/derivedFvPatchFields/pulseFixedValue
|
||||||
|
</li>
|
||||||
|
<li>cfdTools/general/SRF/derivedFvPatchFields/waveTransmissiveInlet
|
||||||
|
</li>
|
||||||
|
<li>thermophysicalModels/basic/derivedFvPatchFields/isentropicTotalTemperature
|
||||||
|
</li>
|
||||||
|
<li>thermophysicalModels/basic/derivedFvPatchFields/temperatureDirectedInletOutletVelocity
|
||||||
|
</li>
|
||||||
|
<li>fvMesh/fvPatches/constraint/mixingPlane
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
<li>Turbulence modeling:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Removed kOmegaSST_lowRe - USE WHAT INSTEAD???
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Tutorial updates (settings, initial conditions, bug fixes etc.):
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>incompressible/icoDyMFoam/mixerGgi
|
||||||
|
</li>
|
||||||
|
<li>incompressible/icoDyMFoam/movingConeMotion
|
||||||
|
</li>
|
||||||
|
<li>incompressible/icoDyMFoam/movingConeTopo
|
||||||
|
</li>
|
||||||
|
<li>solidMechanics/elasticNonLinTLSolidFoam/largeStrainCantileverBeam
|
||||||
|
</li>
|
||||||
|
<li>solidMechanics/elasticNonLinTLSolidFoam/nonLinBlock
|
||||||
|
</li>
|
||||||
|
<li>solidMechanics/elasticNonLinTLSolidFoam/rotateSphereTL
|
||||||
|
</li>
|
||||||
|
<li>solidMechanics/elasticThermalSolidFoam/hotCylinder
|
||||||
|
</li>
|
||||||
|
<li>solidMechanics/stressFemFoam/plateHole
|
||||||
|
</li>
|
||||||
|
<li>Many other updates due to blockMesh syntax update
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>New tutorials:
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>compressible/dbnsFoam/forwardStep
|
||||||
|
</li>
|
||||||
|
<li>compressible/dbnsFoam/shockTube
|
||||||
|
</li>
|
||||||
|
<li>compressible/dbnsTurbFoam/naca0012
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleFoam/2bump
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleFoam/bumpBlockMesh
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleFoam/bumpFine05
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleMRFFoam/bentRotorStator
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleMRFFoam/simpleRotorStator
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleSRFFoam/bentBlade
|
||||||
|
</li>
|
||||||
|
<li>compressible/steadyCompressibleSRFFoam/simpleBlade
|
||||||
|
</li>
|
||||||
|
<li>coupled/pUCoupledFoam/cavity
|
||||||
|
</li>
|
||||||
|
<li>incompressible/MRFSimpleFoam/axialTurbine_ggi
|
||||||
|
</li>
|
||||||
|
<li>incompressible/MRFSimpleFoam/axialTurbine_mixingPlane
|
||||||
|
</li>
|
||||||
|
<li>incompressible/pimpleDyMFoam/axialTurbine
|
||||||
|
</li>
|
||||||
|
<li>incompressible/pimpleDyMFoam/movingCylinders
|
||||||
|
</li>
|
||||||
|
<li>incompressible/pUCoupledFoam/backwardFacingStepLaminar
|
||||||
|
</li>
|
||||||
|
<li>incompressible/pUCoupledFoam/backwardFacingStepTurbulent
|
||||||
|
</li>
|
||||||
|
<li>incompressible/pUCoupledFoam/cavity
|
||||||
|
</li>
|
||||||
|
<li>incompressible/simpleSRFFoam/axialTurbine
|
||||||
|
</li>
|
||||||
|
<li>mesh/moveDynamicMesh/movingCylinders
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Bug fixes:
|
||||||
|
LinearUpwind no longer hangs in parallel execution on empty patches
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-6" class="outline-2">
|
||||||
|
<h2 id="sec-6"><span class="section-number-2">6</span> Recent sucessful compilations and tests</h2>
|
||||||
|
<div class="outline-text-2" id="text-6">
|
||||||
|
<ul class="org-ul">
|
||||||
|
<li>Ubuntu 14.04:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=736">http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=736</a>
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Ubuntu 12.04:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=738">http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=738</a>
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>CentOS 6.4:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=734">http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=734</a>
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Mac OX X & CLang:
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=733">http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=733</a>
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li>Mac OX X & gcc
|
||||||
|
|
||||||
|
<p>
|
||||||
|
<a href="http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=737">http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=737</a>
|
||||||
|
</p>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-7" class="outline-2">
|
||||||
|
<h2 id="sec-7"><span class="section-number-2">7</span> Reporting bugs</h2>
|
||||||
|
<div class="outline-text-2" id="text-7">
|
||||||
|
<p>
|
||||||
|
To report bugs, please use the MantisBT bugtracker at
|
||||||
|
<a href="http://sourceforge.net/apps/mantisbt/openfoam-extend">http://sourceforge.net/apps/mantisbt/openfoam-extend</a>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-8" class="outline-2">
|
||||||
|
<h2 id="sec-8"><span class="section-number-2">8</span> How to contribute</h2>
|
||||||
|
<div class="outline-text-2" id="text-8">
|
||||||
|
<p>
|
||||||
|
All your contributions are highly welcome: New solvers, utilities and
|
||||||
|
models; bug fixes; documentation. The many ways of contributing and the
|
||||||
|
contribution process are described in detail in the file "HowToContribute"
|
||||||
|
and at <a href="http://sourceforge.net/p/openfoam-extend/wiki/Home/">http://sourceforge.net/p/openfoam-extend/wiki/Home/</a>
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="outline-container-sec-9" class="outline-2">
|
||||||
|
<h2 id="sec-9"><span class="section-number-2">9</span> List of Contributors:</h2>
|
||||||
|
<div class="outline-text-2" id="text-9">
|
||||||
|
<p>
|
||||||
|
See file ListOfContributors
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div id="postamble" class="status">
|
||||||
|
<p class="date">Date: 8 June 2014</p>
|
||||||
|
<p class="date">Created: 2014-06-15 Sun 13:44</p>
|
||||||
|
<p class="creator"><a href="http://www.gnu.org/software/emacs/">Emacs</a> 24.3.1 (<a href="http://orgmode.org">Org</a> mode 8.2.4)</p>
|
||||||
|
<p class="validation"><a href="http://validator.w3.org/check?uri=referer">Validate</a></p>
|
||||||
|
</div>
|
||||||
|
</body>
|
||||||
|
</html>
|
341
ReleaseNotes.txt
Normal file
341
ReleaseNotes.txt
Normal file
|
@ -0,0 +1,341 @@
|
||||||
|
_____________________________________
|
||||||
|
|
||||||
|
*RELEASE NOTES FOR FOAM-EXTEND-3.1*
|
||||||
|
_____________________________________
|
||||||
|
|
||||||
|
|
||||||
|
8 June 2014
|
||||||
|
|
||||||
|
|
||||||
|
Table of Contents
|
||||||
|
_________________
|
||||||
|
|
||||||
|
1 Overview
|
||||||
|
2 Installation
|
||||||
|
3 Compatibility
|
||||||
|
4 Main differentiators between foam-extend and OpenFOAM
|
||||||
|
5 New features in foam-extend-3.1, since foam-extend-3.0
|
||||||
|
6 Recent sucessful compilations and tests
|
||||||
|
7 Reporting bugs
|
||||||
|
8 How to contribute
|
||||||
|
9 List of Contributors:
|
||||||
|
|
||||||
|
|
||||||
|
################################################################################
|
||||||
|
|
||||||
|
|
||||||
|
1 Overview
|
||||||
|
==========
|
||||||
|
|
||||||
|
The foam-extend project is a fork of the OpenFOAM® open source library
|
||||||
|
for Computational Fluid Dynamics (CFD). It is an open project
|
||||||
|
welcoming and integrating contributions from all users and
|
||||||
|
developers. Previously known as OpenFOAM®-dev and OpenFOAM®-extend, it
|
||||||
|
contains bug fixes and performance improvements, as well as extensions
|
||||||
|
and additional features provided by community contributors (see file
|
||||||
|
ListOfContributors), such as dynamic mesh and topological change
|
||||||
|
support, turbomachinery extensions including general grid
|
||||||
|
interpolation (GGI), cyclic GGI and mixing plane, block-coupled matrix
|
||||||
|
support, finite area method, comprehensive mesh motion capability and
|
||||||
|
GPU support. For a full list, see below and previous release notes at:
|
||||||
|
[http://sourceforge.net/p/openfoam-extend/wiki/Home/]
|
||||||
|
|
||||||
|
Version 3.1, nicknamed "Zagreb", is the current version of
|
||||||
|
foam-extend. The release continues the tradition and spirit of the
|
||||||
|
original FOAM code developed by prof. Jasak and Mr. Weller during
|
||||||
|
their time at Imperial College and released as the general purpose
|
||||||
|
CFD/CCM package by Nabla Ltd. in 2000. In this spirit, we reverted 18
|
||||||
|
December 2013 to the original numbering scheme (foam-2.3.2, 13
|
||||||
|
December 2004) as release number 3.0. Visit [http://foam-extend.org]
|
||||||
|
for more information.
|
||||||
|
|
||||||
|
OPENFOAM® is a registered trademark of ESI Group. OpenFOAM-extend and
|
||||||
|
foam-extend are a community effort not endorsed by ESI Group.
|
||||||
|
|
||||||
|
|
||||||
|
2 Installation
|
||||||
|
==============
|
||||||
|
|
||||||
|
foam-extend-3.1 can be compiled and runs on any linux system
|
||||||
|
|
||||||
|
* Main supported OSs:
|
||||||
|
- Ubuntu 14.04
|
||||||
|
- Fedora 20
|
||||||
|
- Mac OS X
|
||||||
|
|
||||||
|
* Compile from source:
|
||||||
|
|
||||||
|
Please refer to doc/buildInstructions/ for details. Further
|
||||||
|
installation instruction are available on the unofficial OpenFOAM
|
||||||
|
Wiki:
|
||||||
|
[http://openfoamwiki.net/index.php/Installation/Linux/foam-extend-3.0]
|
||||||
|
If you have improvements or build instructions for a new system,
|
||||||
|
please share them with the community (see section "How to
|
||||||
|
contribute", below).
|
||||||
|
|
||||||
|
* Download binary packages:
|
||||||
|
|
||||||
|
Binary packages are available for download at
|
||||||
|
[http://sourceforge.net/projects/openfoam-extend/] for the following
|
||||||
|
systems: Ubuntu 14.04, Fedora 20 and Mac OS X.
|
||||||
|
|
||||||
|
* Accompanying ThirdParty software:
|
||||||
|
- gcc compatibility up to 4.8.2
|
||||||
|
- Paraview 4.0.1
|
||||||
|
- qt 4.8.5
|
||||||
|
- openmpi 1.6.5
|
||||||
|
- cmake 2.8.12
|
||||||
|
- metis 5.1.0
|
||||||
|
- parmetis 4.0.3
|
||||||
|
- scotch 6.0.0
|
||||||
|
- ParMGridGen 1.0
|
||||||
|
- mesquite 2.1.2
|
||||||
|
- PyFoam 0.6.3
|
||||||
|
- swak4Foam 0.3.1
|
||||||
|
- zoltan 3.6
|
||||||
|
- bison 2.7
|
||||||
|
- hwloc 1.7.2
|
||||||
|
- libccmio 2.6.1
|
||||||
|
|
||||||
|
|
||||||
|
3 Compatibility
|
||||||
|
===============
|
||||||
|
|
||||||
|
Upstream features from the OpenFOAM® code base are merged into
|
||||||
|
foam-extend on regular basis. The interface format of foam-extend-3.1
|
||||||
|
is largely compatible to OpenFOAM-1.6-ext and OpenFOAM-1.7.x. In some
|
||||||
|
cases, the differences are caused by bug fixes and algorithmic
|
||||||
|
improvements, considered more important than inter-operability.
|
||||||
|
|
||||||
|
|
||||||
|
4 Main differentiators between foam-extend and OpenFOAM
|
||||||
|
=======================================================
|
||||||
|
|
||||||
|
A large number of features have been lost within the release of
|
||||||
|
OpenFOAM since version 1.3, the code base has shrunk by more than 40%.
|
||||||
|
While we understand the lack of technical ability of supporting
|
||||||
|
advanced CFD features, we feel that existing features and specifically
|
||||||
|
large-scale contributions should remain active and developed
|
||||||
|
further. Below is a list of main features of foam-extend which are
|
||||||
|
lacking, lost, deactivated or unusable in ESI releases:
|
||||||
|
|
||||||
|
* Turbomachinery features, including General Grid Interface (GGI),
|
||||||
|
partial overlap GGI, cyclic GGI, with improvements in parallel
|
||||||
|
scaling. First release of a mixing plane stage interface
|
||||||
|
|
||||||
|
* Dynamic mesh with topological changes Sliding interfaces, mesh
|
||||||
|
layering, attach-detach boundaries etc. In foam-extend, full
|
||||||
|
parallel support for topological changes is released for the first
|
||||||
|
time
|
||||||
|
|
||||||
|
* Finite Element Method with support for polyhedral meshes This is
|
||||||
|
mainly used in mesh deformation and over the last 15 years it has
|
||||||
|
proven vastly superior to all other dynamic mesh methods.
|
||||||
|
|
||||||
|
* Advanced mesh deformation technology Including tet FEM mesh
|
||||||
|
deformation, Radial Basis Function (RBF) mesh deformation,
|
||||||
|
tetrahedral remeshing dynamic mesh support and solid body motion
|
||||||
|
functions. All of the above include parallelisation support
|
||||||
|
|
||||||
|
* Library of dynamic meshes with topological changes with full second
|
||||||
|
order FVM discretisation support on moving meshes with topological
|
||||||
|
changes
|
||||||
|
|
||||||
|
* Internal combustion engine-specific dynamic mesh classes such as
|
||||||
|
two-stroke engine and various forms of 4-stroke and multi-valve
|
||||||
|
dynamic mesh classes
|
||||||
|
|
||||||
|
* Finite Area Method providing support for FVM-like discretisation on
|
||||||
|
a curved surface in 3-D, with examples of liquid film modelling
|
||||||
|
|
||||||
|
* Block-coupled matrix support, allowing fully implicit multi-equation
|
||||||
|
solution of NxN equation sets, with full parallelisation support.
|
||||||
|
First release of a block-AMG linear equation solver
|
||||||
|
|
||||||
|
* Fully implicit conjugate-coupled solution framework, allowing
|
||||||
|
implicit solution fo multiple equations over multiple meshes, with
|
||||||
|
parallelism
|
||||||
|
|
||||||
|
* Proper Orthogonal Decomposition data analysis tools, with
|
||||||
|
applications to FOAM field classes
|
||||||
|
|
||||||
|
* Equation reader classes and tutorials
|
||||||
|
|
||||||
|
* Multi-solver solution framework, allowing multiple field models to
|
||||||
|
be solved in a coupled manner
|
||||||
|
|
||||||
|
* A major contribution is solid mechanics modelling, including linear
|
||||||
|
and non-linear materials, contact, self-contact and friction, with
|
||||||
|
updated Lagrangian or absolute Lagrangian formulation. Solution of
|
||||||
|
damage models and crack propagation in complex materials via
|
||||||
|
topological changes
|
||||||
|
|
||||||
|
* CUDA solver release, provided in full source and as an example of
|
||||||
|
coupling external linear equation solvers with FOAM
|
||||||
|
|
||||||
|
* Library-level support for Immersed Boundary Method and Overset Mesh
|
||||||
|
|
||||||
|
* Major improvements in accuracy and stability of FVM discretisation
|
||||||
|
with options on convection and diffusion discretisation, deferred
|
||||||
|
correction or explicit schemes
|
||||||
|
|
||||||
|
* Algebraic multigrid solver framework
|
||||||
|
|
||||||
|
* 210 tutorials with automated run scripts
|
||||||
|
|
||||||
|
* Automatic test harness
|
||||||
|
|
||||||
|
|
||||||
|
5 New features in foam-extend-3.1, since foam-extend-3.0
|
||||||
|
========================================================
|
||||||
|
|
||||||
|
The list of features is a result of the work of numerous
|
||||||
|
contributors. The maintainers of foam-extend would formally like to
|
||||||
|
thank them all.
|
||||||
|
|
||||||
|
Get a full log of the updates by (either):
|
||||||
|
,----
|
||||||
|
| user@machine> git log 3.0.. > commitLog
|
||||||
|
`----
|
||||||
|
,----
|
||||||
|
| user@machine> git log 3.0.. --oneline > commitLog
|
||||||
|
`----
|
||||||
|
,----
|
||||||
|
| user@machine> gitg 3.0..
|
||||||
|
`----
|
||||||
|
|
||||||
|
* Major new features:
|
||||||
|
- Pressure-based compressible turbo functionalities
|
||||||
|
- Pressure-based coupled solver (block-coupling p and U)
|
||||||
|
|
||||||
|
* Licence: GPLv3
|
||||||
|
|
||||||
|
* Installation:
|
||||||
|
- Updated and bug-fixed installation procedures
|
||||||
|
- Removed need for gmake link in Ubuntu
|
||||||
|
- Scripts for minimizing installation after compilation
|
||||||
|
- ThirdParty/Allclean alsoPackage - new option
|
||||||
|
- wcleanAllButLibBinLnInclude
|
||||||
|
- Fixed problem with ParaView reader for Ubuntu 14.04
|
||||||
|
- foamToTecplot360: building tecio doesn't require X.org development
|
||||||
|
files
|
||||||
|
|
||||||
|
* Solvers:
|
||||||
|
- compressible/dbnsFoam
|
||||||
|
- compressible/dbnsTurbFoam
|
||||||
|
- compressible/steadyCompressibleFoam
|
||||||
|
- compressible/steadyCompressibleMRFFoam
|
||||||
|
- compressible/steadyCompressibleSRFFoam
|
||||||
|
- coupled/pUCoupledFoam (incl. core library changes)
|
||||||
|
|
||||||
|
- Update and cleanup of solvers/solidMechanics
|
||||||
|
- Update for segregated FEM matrix,
|
||||||
|
solvers/solidMechanics/stressFemFoam
|
||||||
|
|
||||||
|
* Utilities:
|
||||||
|
- convertPhi (for steadyCompressible solvers)
|
||||||
|
- foamMeshToElmer, fluent3DMeshToElmer
|
||||||
|
- transformPoints -cylToCart "origin axis direction" - new option
|
||||||
|
- blockMesh syntax update (see commit a78b12074)
|
||||||
|
|
||||||
|
* Libraries:
|
||||||
|
- General:
|
||||||
|
- Added Gauss-Seidel as asymmetric solver
|
||||||
|
- Block matrix agglomeration (for pUCoupledFoam)
|
||||||
|
- Block AMG solver
|
||||||
|
- dbns library (src/dbns)
|
||||||
|
- Boundary conditions:
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFFlowRateInletVelocity
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFSurfaceNormalVelocity
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFTotalPressure
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/SRFTotalTemperature
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/pulseFixedValue
|
||||||
|
- cfdTools/general/SRF/derivedFvPatchFields/waveTransmissiveInlet
|
||||||
|
- thermophysicalModels/basic/derivedFvPatchFields/isentropicTotalTemperature
|
||||||
|
- thermophysicalModels/basic/derivedFvPatchFields/temperatureDirectedInletOutletVelocity
|
||||||
|
- fvMesh/fvPatches/constraint/mixingPlane
|
||||||
|
- Turbulence modeling:
|
||||||
|
- Removed kOmegaSST_lowRe - USE WHAT INSTEAD???
|
||||||
|
|
||||||
|
- Tutorial updates (settings, initial conditions, bug fixes etc.):
|
||||||
|
- incompressible/icoDyMFoam/mixerGgi
|
||||||
|
- incompressible/icoDyMFoam/movingConeMotion
|
||||||
|
- incompressible/icoDyMFoam/movingConeTopo
|
||||||
|
- solidMechanics/elasticNonLinTLSolidFoam/largeStrainCantileverBeam
|
||||||
|
- solidMechanics/elasticNonLinTLSolidFoam/nonLinBlock
|
||||||
|
- solidMechanics/elasticNonLinTLSolidFoam/rotateSphereTL
|
||||||
|
- solidMechanics/elasticThermalSolidFoam/hotCylinder
|
||||||
|
- solidMechanics/stressFemFoam/plateHole
|
||||||
|
- Many other updates due to blockMesh syntax update
|
||||||
|
|
||||||
|
* New tutorials:
|
||||||
|
- compressible/dbnsFoam/forwardStep
|
||||||
|
- compressible/dbnsFoam/shockTube
|
||||||
|
- compressible/dbnsTurbFoam/naca0012
|
||||||
|
- compressible/steadyCompressibleFoam/2bump
|
||||||
|
- compressible/steadyCompressibleFoam/bumpBlockMesh
|
||||||
|
- compressible/steadyCompressibleFoam/bumpFine05
|
||||||
|
- compressible/steadyCompressibleMRFFoam/bentRotorStator
|
||||||
|
- compressible/steadyCompressibleMRFFoam/simpleRotorStator
|
||||||
|
- compressible/steadyCompressibleSRFFoam/bentBlade
|
||||||
|
- compressible/steadyCompressibleSRFFoam/simpleBlade
|
||||||
|
- coupled/pUCoupledFoam/cavity
|
||||||
|
- incompressible/MRFSimpleFoam/axialTurbine_ggi
|
||||||
|
- incompressible/MRFSimpleFoam/axialTurbine_mixingPlane
|
||||||
|
- incompressible/pimpleDyMFoam/axialTurbine
|
||||||
|
- incompressible/pimpleDyMFoam/movingCylinders
|
||||||
|
- incompressible/pUCoupledFoam/backwardFacingStepLaminar
|
||||||
|
- incompressible/pUCoupledFoam/backwardFacingStepTurbulent
|
||||||
|
- incompressible/pUCoupledFoam/cavity
|
||||||
|
- incompressible/simpleSRFFoam/axialTurbine
|
||||||
|
- mesh/moveDynamicMesh/movingCylinders
|
||||||
|
|
||||||
|
* Bug fixes: LinearUpwind no longer hangs in parallel execution on
|
||||||
|
empty patches
|
||||||
|
|
||||||
|
|
||||||
|
6 Recent sucessful compilations and tests
|
||||||
|
=========================================
|
||||||
|
|
||||||
|
* Ubuntu 14.04:
|
||||||
|
|
||||||
|
[http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=736]
|
||||||
|
|
||||||
|
* Ubuntu 12.04:
|
||||||
|
|
||||||
|
[http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=738]
|
||||||
|
|
||||||
|
* CentOS 6.4:
|
||||||
|
|
||||||
|
[http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=734]
|
||||||
|
|
||||||
|
* Mac OX X & CLang:
|
||||||
|
|
||||||
|
[http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=733]
|
||||||
|
|
||||||
|
* Mac OX X & gcc
|
||||||
|
|
||||||
|
[http://openfoam-extend.sourceforge.net/CDash/viewTest.php?buildid=737]
|
||||||
|
|
||||||
|
|
||||||
|
7 Reporting bugs
|
||||||
|
================
|
||||||
|
|
||||||
|
To report bugs, please use the MantisBT bugtracker at
|
||||||
|
[http://sourceforge.net/apps/mantisbt/openfoam-extend]
|
||||||
|
|
||||||
|
|
||||||
|
8 How to contribute
|
||||||
|
===================
|
||||||
|
|
||||||
|
All your contributions are highly welcome: New solvers, utilities and
|
||||||
|
models; bug fixes; documentation. The many ways of contributing and
|
||||||
|
the contribution process are described in detail in the file
|
||||||
|
"HowToContribute" and at
|
||||||
|
[http://sourceforge.net/p/openfoam-extend/wiki/Home/]
|
||||||
|
|
||||||
|
|
||||||
|
9 List of Contributors:
|
||||||
|
=======================
|
||||||
|
|
||||||
|
See file ListOfContributors
|
Reference in a new issue