Tree [a29b96] verification /

Read Only access

File Date Author Commit
 Examples 2015-07-22 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [6d7645] Making the 2.x-branch the new develop
 Libraries 2015-07-23 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [6fe3f0] Bump up version number for next release
 Utilities 2015-05-31 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [d9f3c9] Merge in the 1.x release
 debian 2015-05-31 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [51a785] Prepare Ubuntu-packages
 .hgignore 2014-02-28 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [f537bd] Merge in private bison
 .hgtags 2015-07-22 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [17bbe3] Added tag v0.3.2 for changeset 876ec587d4c3
 Allwclean 2013-08-09 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [40c8f3] Merge in bunch of fixes
 Allwmake 2015-05-04 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [b8808a] Merge in latest developments. Fix compilation o...
 COPYING 2010-12-14 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [a26d85] Adding GPL
 Doxyfile 2012-12-13 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [f762a1] Now the documentation links to the OpenFOAM-dox...
 Makefile 2014-01-15 bgschaid bgschaid [f837e7] Now Python-support is correctly packaged on mac...
 README 2015-07-23 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [c3f58c] flow: Promoted <develop> 'trunk' (6fe3f0a9ec01)... 2010-12-15 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [97762d] Added scripts to make libraries and utilities g... 2011-03-03 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [9d2469] Now the simpleFunctionObjects can be compiled w...
 gtags.conf 2011-01-02 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [667af4] Generate documentation 2011-01-02 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [667af4] Generate documentation 2010-12-15 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [97762d] Added scripts to make libraries and utilities g... 2011-03-17 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [96416a] Added another maintainance script 2014-07-11 Bernhard F.W. Gschaider Bernhard F.W. Gschaider [cf2281] Merge from the 1.x-release

Read Me

# -*- mode: org -*-
* Description
  A collection of libraries and tools that let the user handle
  OpenFOAM-data based on expressions
* Contributors etc
** Original Author
   Bernhard Gschaider (
** Current Maintainer
   Bernhard Gschaider (
** Contributors
   /None yet/
** Documentation
* Installation/Compilation
** Requirements
   - Version 1.7 or 1.6-ext of OpenFOAM (1.6 should work, too)
     - The =finiteArea=-stuff will only work with version 1.6-ext
   - the compiler generators =bison= and =flex=
   - =simpleSwakFunctionObjects= needs the =simpleFunctionObjects=
     all other functionality has no additional requirements
     (=simpleSwakFunctionObjects= is only required by some examples)
     It is assumed that the sources are installed at

     A script is provided that
     automatically downloads the =simpleFunctionObjects= into the
     Libraries-directory and compiles it. *Warning:* Don't mix this
     with an installation at =$WM_PROJECT_USER_DIR/Libraries/= unless
     you know what you're doing
** Building
  =wmake all= at the base directory should build all the libraries and

  The main library =swak4FoamParsers= can't be built in parallel (no
  values of =WM_NCOMPPROCS= bigger than 1)
** Global installation
   If the libraries and utilities are considered stable and the should
   be available to everyone (without having to recompile them) the
   script can be used to copy them to the
   global directories.

   The script removes all these files
   from the global directories. The does
   the same for the user directories (this makes sure that no
   self-compiled version /shadows/ the global version (which would
   lead to strange results)

   There is a =Makefile= attached. =make install= compiles =swak4Foam=
   and installs it into the global directories
** Packaging
*** Debian
    The command =build dpkg= builds a Debian/Ubuntu package for 
    the *currently enabled* OpenFOAM-package. Note:
    - it is assumed that the currently used OF-version was also
      installed by the package manager
    - the =dev= package is built but poorly maintained
    - =simpleFunctionOjects= are automatically included in the
      package. To avoid this remove the =simpleFunctionObjects= from
      the =Libraries= directory and do =make dpkg-only=
    Changes in the packaging should be done in the branch
      =debianPackaging= of the Mercurial-repository
* Contents
** Libraries
   Collection of Libraries
*** =swak4FoamParsers=
    The basis of =swak4Foam=: the expression parsers with the logic to
    access the /OpenFOAM/ data-structures.

    None of the other software pieces compile without it
*** =groovyBC=
    Implements the infamous =groovyBC=. A boundary condition that
    allows arbitrary expressions in the field-file
*** =swakFunctionObjects=
    Function objects that have no additional requirements. Mainly used
    for manipulating and creating fields with expressions
*** =simpleSwakFunctionObjects=
    Function objects based on the =simpleFunctionObjects=-library
    (which is a prerequisite for compiling it).

    Evaluate expressions and output the results
*** =swakSourceFields=
    These classes allow to manipulate the solution. To use these the
    solver has to be modified.
    - expressionSource :: Field that is calculated from an
         expression. To be used as source-term or coefficient in some
    - forceEquation :: force an equation to fixed values in selected
                       locations. Has to be used after constructing
                       the equation and before solving
*** =swakTopoSources=
    =topoSources= for =cellSet= and =faceSet=. Can be used with the
    =cellSet= and =faceSet=-utilities 
*** =swakFiniteArea=
    Implements parsers for the =finiteArea=-stuff in 1.6-ext. Also
    implements =groovyBC= for =areaField= and =expressionField=
*** =groovyStandardBCs=
    Collection of boundary conditions that give standard boundary
    conditions the possibility to use expression for the coefficients

    Contributions to this library are explicitly encouraged. Please
    use the Mercurial-branch =groovyStandardBCs= to /groovyify/
    standard boundary conditions.
** Utilities
*** =funkySetFields=
    Utility that allows creation and manipulation of files with
*** =funkySetAreaFields=
    Utility like =funkySetFields= for =areaFields= (only works with
*** =funkySetBoundaryField=
    Sets any field on a boundary to a non-uniform value based on an

    Acts without deeper understanding of the underlying boundary condition
*** =replayTransientBC=
    Utility to quickly test whether a groovyBC gives the expected
    results. Writes the specified fields with the applied boundary
    condition but doesn't do anything else.

    Can be used for other BCs as well
*** =funkyDoCalc=
    Evaluates expressions that are listed in a dictionary using data
    that is found on the disc and prints summarized data (min, max,
    average, sum) to the screen
** Examples
   If not otherwise noted cases are prepared by a simple

   *All the cases here are strictly for demonstration purposes and
    resemble nothing from the 'real world'*
*** groovyBC
    The old =groovyBC=-Demos
**** pulsedPitzDaily
    - Solver :: pisoFoam
    - Also demonstrates :: =manipulateField=, =expressionField= and
         =clearField= from the
         =swakFunctionObjects=. =patchExpression= from
**** wobbler
    - Solver :: solidDisplacementFoam
**** circulatingSplash 
    - Solver :: interDyMFoam 
    - Remark :: this one crashes halfway through the calculation. If
                you can fix it: Be my guest
**** movingConeDistorted
    - Solver :: pimpleDyMFoam
    - Also demonstrates :: =swakExpression= with =surface=. Due to a
      problem described below this currently doesn't work
**** average-t-junction
    - Solver :: pimpleFoam
**** multiRegionHeaterFeedback
    - Solver :: chtMultiRegionFoam
    - Mesh preparation :: Execute the script in that
    - Also demonstrated :: =patchExpression= and =swakExpression= from
**** fillingTheDam
     - Solver :: interFoam
     - Also demonstrates :: Usage of a =sampledSet= defined in the
          =controlDict= do determine the average filling height. Also
          stored variables for not switching back once the criterion
          is reached
*** FunkySetFields
    Example dictionary for =funkySetFields=
*** FunkySetBoundaryFields
    Example dictionary for =funkySetBoundaryFields=. Sets nonsense
    boundary conditions for the world famous =damBreak=-case
*** InterFoamWithSources
    Demonstrates usage of =expressionSource=
*** InterFoamWithFixed
    Demonstrates usage of =forceEquation=
**** =interFoamWithSources=
     Slightly modified version of =interFoam=. Adds a source term to
     the momentum equation. The source term is an expression that is
     defined at run-time
**** =mixingThing=
     Demonstration case for it.
     - Preparation :: Run the script to prepare the case
*** FiniteArea
    Demonstration of the =finiteArea=-stuff that works with 1.6-ext
**** =swakSurfactantFoam=
     Variation of =surfactantFoam= that adds an =expressionSource=
**** =planeTransport=
     Demonstration case
     - Preparation :: Use =blockMesh= and =makeFaMesh=
     - Solver :: =surfactantFoam= (without source term) or
     - Demonstrates :: FAM-specific =swakExpressions= and =groovyBC=
                       (as well as the =expressionSource=)
*** other
    Cases that don't have a =groovyBC=
**** =angledDuctImplicit=
     - Solver :: rhoPorousSimpleFoam
     - Mesh preparation :: Execute the in that
          directory. If you want to run in parallel call the
 with the number of processors as
          an argument
     - Demonstrates :: Usage of the =swakTopoSources=. Compares
          different approaches to evaluating with the
          =swakExpression=-functionObject. Also an example dictionary
          that demonstrates the use of =funkyDoCalc=
**** =capillaryRise=
     - Solver :: interFoam
     - Case preparation :: run the supplied script
     - Demonstrates :: Usage of a sampled surface to track the
                       interface in a VOF-simulation
* Copyright
  =swak4Foam= is free software; you can redistribute it and/or modify it
  under the terms of the GNU General Public License as published by the
  Free Software Foundation; either version 2 of the License, or (at your
  option) any later version.  See the file COPYING in this directory,
  for a description of the GNU General Public License terms under which 
  you can copy the files.
* Known bugs
** Moving meshes and =sampledSurfaces= 
   It seems that with moving meshes =sampledSurfaces= don't get
   updated. This seems to be a problem with OpenFOAM itself (the
   regular =surfaces=-functionObject doesn't get updated. This is
   currently investigated
** Missing support for interpolation and point-Fields
   Apart from patches and internal fields the support for
   interpolation from cells to faces (and vice versa) is incomplete as
   well as point fields (although they are supported in the grammar)
** Caching of loaded fields not working
   This is especially evident for the =funkyDoCalc=-example
** Possible enhancements of the code
   Not really bugs, but stuff that bugs me
*** Pointers in the driver code
    This is necessary because of =bison=. Investigate possibilities to
    replace these by =tmp= and =autoPtr= 
** Possible memory loss
   =valgrind= reports some lost memory for stuff that is not directly
   allocated by =swak4Foam= (in OpenFOAM-sources)

   Will investigate. Relevant places are marked by comments in the
   code. Also the construction of =sampledSet= seems to loose memory
* History
** 2010-09-13
   First Release
** 2010-12-18
   New release
   Most important changes
*** Parser for =sampledSurfaces=
    Now expressions for the field on a sampled surface can be
    evaluated. All =sampledSurfaces= offered by OpenFOAM now can be
*** Multiline =variables=
    The =variables= entry (most notably used in =groovyBC= and
    =swakExpression=) now can be a list of strings. This allows some
    kind of "formatting" (one expression per line) and should improve
*** Two maintainance-scripts were added 
    These can copy the libraries and utilities to the global
    installation (for those who think that the swak4Foam-stuff is
    stable enough and want to 'bless' all users at their site with
    it). Note that any local installation still takes precedence
    (because =$FOAM_USER_APPBIN= is before =$FOAM_APPBIN= in the
*** Parsers using 'external variables' are now run-time selectable
    This allows the inclusion of other parsers with the regular
    =swak4Foam= parsers and include them seamlessly with the
    =variables=-mechanism for 'externals' (in other words: you can add
    your own parser in a separate library without having to change
    anything about the overall =swak4Foam=, but it behaves as if it
    was part of it)
** 2011-01-30
*** Support for /Finite Area/-stuff
    Now there is support for the =finiteArea=-library found in
    1.6-dev. The support is found in a separate library
    =swakFiniteArea=. It has
    - a parser =faField= for =areaFields=
    - a parser =faPatch= for patches of =areaFields=
    - a variant of =groovyBC= for these patches
    - a computed source =faExpressionSource=
    - Function-object-variants for =areaFields=: =clearExpression=,
      =expressionField= and =manipulateField=. These work the same as
      their =volField=-counterparts
*** Bugfix for compiling in single precision
*** New function =nearDist=

Get latest updates about Open Source Projects, Conferences and News.

Sign up for the SourceForge newsletter:

No, thanks