Provided by: freefoam_0.1.0+dfsg-1build1_amd64 
NAME
freefoam - The Cross-Platform CFD Toolkit
SYNOPSIS
freefoam [-b <baseDir>] [-P] [-V | -version] [-h | -help] [--] <application> [<args>]
DESCRIPTION
FreeFOAM is a cross-platform toolkit for computational fluid dynamics (CFD). It consists
of a large collection of C++ libraries, allowing the user to write new solvers for partial
differential equations using a notation very close to the mathematical one. FreeFOAM comes
with a comprehensive set of solvers for a wide range of problems and accompanying pre-/and
post-processing utilities.
FreeFOAM is based on the fantastic Open-Source OpenFOAM software. The goal of the FreeFOAM
project is to remove the system-dependencies from OpenFOAM and make it generally more
useable and easier to install.
The freefoam(1) command is used to invoke the actual FreeFOAM applications. It was mainly
created to avoid putting a large number of binaries on the system PATH, cluttering the
namespace unnecessarily. It also allows for the user to easily add her own applications to
the search path, without having to extend the PATH variable or being root.
freefoam(1) uses the following mechanism to find the application <name>:
• It searches in the directory <libexecDir> for an executable with the name
freefoam-<name>. <libexecDir> defaults to /usr/local/libexec/FreeFOAM-0.1.0. This can
be overridden using the -b option.
• If the FREEFOAM_PATH variable is set, it is prepended to the above described search
path. It is a colon-separated list of directories.
• The -P option can be used to append the system PATH to the search path.
OPTIONS
-b <baseDir>
Specify a different directory to search for applications (default is
/usr/local/libexec/FreeFOAM-0.1.0)
-P
Also search the system PATH variable first
--
Separates options for this program from the application and its arguments (useful if
the application name should start with a -)
-V | -version
Display the version of FreeFOAM and exit
-h | -help
Display an option summary
<application>
The short name of the application to run (i.e. for the freefoam-ico application the
short name would be ico)
<args>
Arguments and options to be passed to the application
environment variables: FREEFOAM_PATH specify an alternative path where to search for
applications
FREEFOAM STANDARD APPLICATIONS
The following sections give a short description for all the available standard solvers and
utilities. More information is available from the individual manual pages.
SOLVERS
DNS
freefoam-dns(1)
Direct numerical simulation solver for boxes of isotropic turbulence.
Basic Solvers
freefoam-laplacian(1)
Solves a simple Laplace equation, e.g. for thermal diffusion in a solid.
freefoam-scalarTransport(1)
Solves a transport equation for a passive scalar.
freefoam-potential-app(1)
Simple potential flow solver which can be used to generate starting fields for full
Navier-Stokes codes.
Combustion Solvers
freefoam-PDR(1)
Solver for compressible premixed/partially-premixed combustion with turbulence
modelling.
freefoam-PDRAutoRefine(1)
Solver for compressible premixed/partially-premixed combustion with turbulence
modelling.
freefoam-Xi(1)
Solver for compressible premixed/partially-premixed combustion with turbulence
modelling.
freefoam-coldEngine(1)
Solver for cold-flow in internal combustion engines.
freefoam-dieselEngine(1)
Solver for diesel engine spray and combustion.
freefoam-diesel(1)
Solver for diesel spray and combustion.
freefoam-engine-app(1)
Solver for internal combustion engines.
freefoam-reacting(1)
Solver for combustion with chemical reactions.
freefoam-rhoReacting(1)
Solver for combustion with chemical reactions using density based thermodynamics
package.
freefoam-fire(1)
Transient Solver for Fires and turbulent diffusion flames.
Compressible Flow Solvers
freefoam-rhoCentralDyM(1)
Density-based compressible flow solver based on central-upwind schemes of Kurganov and
Tadmor.
freefoam-rhoCentral(1)
Density-based compressible flow solver based on central-upwind schemes of Kurganov and
Tadmor.
freefoam-rhoPimple(1)
Transient solver for laminar or turbulent flow of compressible fluids for HVAC and
similar applications.
freefoam-rhoPorousMRFPimple(1)
Transient solver for laminar or turbulent flow of compressible fluids with support for
porous media and MRF for HVAC and similar applications.
freefoam-rhoPorousSimple(1)
Steady-state solver for turbulent flow of compressible fluids with RANS turbulence
modelling, and implicit or explicit porosity treatment.
freefoam-rhoSimple(1)
Steady-state SIMPLE solver for laminar or turbulent RANS flow of compressible fluids.
freefoam-rhoPiso(1)
Transient PISO solver for compressible, laminar or turbulent flow.
freefoam-sonic(1)
Transient solver for trans-sonic/supersonic, laminar or turbulent flow of a
compressible gas.
freefoam-sonicLiquid(1)
Transient solver for trans-sonic/supersonic, laminar flow of a compressible liquid.
freefoam-sonicDyM(1)
Transient solver for trans-sonic/supersonic, laminar or turbulent flow of a
compressible gas with mesh motion.
Electromagnetic Solvers
freefoam-electrostatic(1)
Solver for electrostatics.
freefoam-mhd(1)
Solver for magnetohydrodynamics (MHD): incompressible, laminar flow of a conducting
fluid under the influence of a magnetic field.
Financial Solvers
freefoam-financial(1)
Solves the Black-Scholes equation to price commodities.
Heat Transfer Solvers
freefoam-buoyantBoussinesqPimple(1)
Transient solver for buoyant, turbulent flow of incompressible fluids.
freefoam-buoyantBoussinesqSimple(1)
Steady-state solver for buoyant, turbulent flow of incompressible fluids.
freefoam-buoyantPimple(1)
Transient solver for buoyant, turbulent flow of compressible fluids for ventilation
and heat-transfer.
freefoam-buoyantSimple(1)
Steady-state solver for buoyant, turbulent flow of compressible fluids.
freefoam-buoyantSimpleRadiation(1)
Steady-state solver for buoyant, turbulent flow of compressible fluids, including
radiation, for ventilation and heat-transfer.
freefoam-chtMultiRegion(1)
Combination of heatConductionFoam and buoyantFoam for conjugate heat transfer between
a solid region and fluid region.
freefoam-chtMultiRegionSimple(1)
Steady-state version of chtMultiRegionFoam.
Incompressible Flow Solvers
freefoam-boundary(1)
Steady-state solver for 1D turbulent flow, typically to generate boundary layer
conditions at an inlet, for use in a simulation.
freefoam-channel(1)
Incompressible LES solver for flow in a channel.
freefoam-ico(1)
Transient solver for incompressible, laminar flow of Newtonian fluids.
freefoam-nonNewtonianIco(1)
Transient solver for incompressible, laminar flow of non-Newtonian fluids.
freefoam-simple(1)
Steady-state solver for incompressible, turbulent flow.
freefoam-pimpleDyM(1)
Transient solver for incompressible, flow of Newtonian fluids on a moving mesh using
the PIMPLE (merged PISO-SIMPLE) algorithm.
freefoam-pimple(1)
Large time-step transient solver for incompressible, flow using the PIMPLE (merged
PISO-SIMPLE) algorithm.
freefoam-piso(1)
Transient solver for incompressible flow.
freefoam-shallowWater(1)
Transient solver for inviscid shallow-water equations with rotation.
freefoam-porousSimple(1)
Steady-state solver for incompressible, turbulent flow with implicit or explicit
porosity treatment.
Discrete Methods Solvers
freefoam-md(1)
Molecular dynamics solver for fluid dynamics.
freefoam-mdEquilibration(1)
Equilibrates and/or preconditions molecular dynamics systems.
freefoam-dsmc-app(1)
Direct simulation Monte Carlo (DSMC) solver for 3D, transient, multi- species flows.
Lagrangian Solvers
freefoam-coalChemistry(1)
Transient solver for compressible, turbulent flow with coal and limestone parcel
injections, and combustion.
freefoam-porousExplicitSourceReactingParcel(1)
Transient PISO solver for compressible, laminar or turbulent flow with reacting
multiphase Lagrangian parcels for porous media, including explicit sources for mass,
momentum and energy.
freefoam-reactingParcel(1)
Transient PISO solver for compressible, laminar or turbulent flow with reacting
Lagrangian parcels.
freefoam-uncoupledKinematicParcel(1)
Transient solver for the passive transport of a single kinematic particle cloud.
Multiphase Solvers
freefoam-bubble(1)
Solver for a system of 2 incompressible fluid phases with one phase dispersed, e.g.
gas bubbles in a liquid.
freefoam-compressibleInter(1)
Solver for 2 compressible, isothermal immiscible fluids using a VOF (volume of fluid)
phase-fraction based interface capturing approach.
freefoam-compressibleInterDyM(1)
Solver for 2 compressible, isothermal immiscible fluids using a VOF (volume of fluid)
phase-fraction based interface capturing approach, with optional mesh motion and mesh
topology changes including adaptive re-meshing.
freefoam-inter(1)
Solver for 2 incompressible, isothermal immiscible fluids using a VOF (volume of
fluid) phase-fraction based interface capturing approach.
freefoam-interDyM(1)
Solver for 2 incompressible, isothermal immiscible fluids using a VOF (volume of
fluid) phase-fraction based interface capturing approach, with optional mesh motion
and mesh topology changes including adaptive re-meshing.
freefoam-MRFInter(1)
Solver for 2 incompressible, isothermal immiscible fluids.
freefoam-porousInter(1)
Solver for 2 incompressible, isothermal immiscible fluids.
freefoam-interPhaseChange(1)
Solver for 2 incompressible, isothermal immiscible fluids with phase-change (e.g.
cavitation).
freefoam-cavitating(1)
Transient cavitation code based on the homogeneous equilibrium model from which the
compressibility of the liquid/vapour "mixture" is obtained.
freefoam-MRFMultiphaseInter(1)
Solver for n incompressible fluids which captures the interfaces and includes
surface-tension and contact-angle effects for each phase.
freefoam-multiphaseInter(1)
Solver for n incompressible fluids which captures the interfaces and includes
surface-tension and contact-angle effects for each phase.
freefoam-settling(1)
Solver for 2 incompressible fluids for simulating the settling of the dispersed phase.
freefoam-twoLiquidMixing(1)
Solver for mixing 2 incompressible fluids.
freefoam-twoPhaseEuler(1)
Solver for a system of 2 incompressible fluid phases with one phase dispersed, e.g.
gas bubbles in a liquid.
freefoam-interMixing(1)
Solver for 3 incompressible fluids, two of which are miscible, using a VOF method to
capture the interface.
Stress-Analysis
freefoam-solidDisplacement(1)
Transient segregated finite-volume solver of linear-elastic, small-strain deformation
of a solid body, with optional thermal diffusion and thermal stresses.
freefoam-solidEquilibriumDisplacement(1)
Steady-state segregated finite-volume solver of linear-elastic, small-strain
deformation of a solid body, with optional thermal diffusion and thermal stresses.
UTILITIES
Advanced Mesh Manipulation
freefoam-autoRefineMesh(1)
Utility to refine cells near to a surface.
freefoam-collapseEdges(1)
Collapse short edges and combines edges that are in line.
freefoam-combinePatchFaces(1)
Checks for multiple patch faces on same cell and combines them.
freefoam-modifyMesh(1)
Manipulates mesh elements.
freefoam-refineHexMesh(1)
Refines a hex mesh by 2x2x2 cell splitting.
freefoam-refineWallLayer(1)
Utility to refine cells next to patches.
freefoam-refinementLevel(1)
Tries to figure out what the refinement level is on refined cartesian meshes. Run
BEFORE snapping.
freefoam-removeFaces(1)
Utility to remove faces (combines cells on both sides).
freefoam-selectCells(1)
Select cells in relation to surface.
freefoam-splitCells(1)
Utility to split cells with flat faces.
Mesh Conversion
freefoam-ansysToFoam(1)
Converts an ANSYS input mesh file, exported from I-DEAS, to FOAM format.
freefoam-cfx4ToFoam(1)
Converts a CFX 4 mesh to FOAM format.
freefoam-fluent3DMeshToFoam(1)
Converts a Fluent mesh to OpenFOAM format.
freefoam-fluentMeshToFoam(1)
Converts a Fluent mesh to FOAM format including multiple region and region boundary
handling.
freefoam-foamMeshToFluent(1)
Writes out the FOAM mesh in Fluent mesh format.
freefoam-foamToStarMesh(1)
Reads an OpenFOAM mesh and writes a pro-STAR (v4) bnd/cel/vrt format.
freefoam-gambitToFoam(1)
Converts a GAMBIT mesh to FOAM format.
freefoam-gmshToFoam(1)
Reads .msh file as written by Gmsh.
freefoam-ideasUnvToFoam(1)
I-Deas unv format mesh conversion.
freefoam-kivaToFoam(1)
Converts a KIVA3v grid to FOAM format.
freefoam-mshToFoam(1)
Converts .msh file generated by the Adventure system.
freefoam-netgenNeutralToFoam(1)
Converts neutral file format as written by Netgen v4.4.
freefoam-plot3dToFoam(1)
Plot3d mesh (ascii/formatted format) converter.
freefoam-polyDualMesh(1)
Calculate the dual of a polyMesh. Adheres to all the feature and patch edges.
freefoam-sammToFoam(1)
Converts a STAR-CD SAMM mesh to FOAM format.
freefoam-star4ToFoam(1)
Converts a Star-CD (v4) pro-STAR mesh into OpenFOAM format.
freefoam-starToFoam(1)
Converts a STAR-CD PROSTAR mesh into FOAM format.
freefoam-tetgenToFoam(1)
Converts .ele and .node and .face files, written by tetgen.
freefoam-writeMeshObj(1)
For mesh debugging: writes mesh as three separate OBJ files which can be viewed with
e.g. javaview.
Mesh Generation
freefoam-extrudeMesh(1)
Extrude mesh from existing patch or from patch read from file.
freefoam-blockMesh(1)
A multi-block mesh generator.
freefoam-snappyHexMesh(1)
Automatic split hex mesher. Refines and snaps to surface.
freefoam-extrude2DMesh(1)
Takes 2D mesh (all faces 2 points only, no front and back faces) and creates a 3D mesh
by extruding with specified thickness.
Mesh Manipulation
freefoam-attachMesh(1)
Attach topologically detached mesh using prescribed mesh modifiers.
freefoam-autoPatch(1)
Divides external faces into patches based on (user supplied) feature angle.
freefoam-cellSet(1)
Selects a cell set through a dictionary.
freefoam-checkMesh(1)
Checks validity of a mesh.
freefoam-createBaffles(1)
Makes internal faces into boundary faces.
freefoam-createPatch(1)
Utility to create patches out of selected boundary faces.
freefoam-deformedGeom(1)
Deforms a polyMesh using a displacement field U and a scaling factor supplied as an
argument.
freefoam-faceSet(1)
Selects a face set through a dictionary.
freefoam-flattenMesh(1)
Flattens the front and back planes of a 2D cartesian mesh.
freefoam-insideCells(1)
Picks up cells with cell centre inside of surface.
freefoam-mergeMeshes(1)
Merge two meshes.
freefoam-mergeOrSplitBaffles(1)
Detects faces that share points (baffles). Either merge them or duplicate the points.
freefoam-mirrorMesh(1)
Mirrors a mesh around a given plane.
freefoam-moveDynamicMesh(1)
Mesh motion and topological mesh changes utility.
freefoam-moveEngineMesh(1)
Solver for moving meshes for engine calculations.
freefoam-moveMesh(1)
Solver for moving meshes.
freefoam-objToVTK(1)
Read obj line (not surface!) file and convert into vtk.
freefoam-pointSet(1)
Selects a point set through a dictionary.
freefoam-refineMesh(1)
Utility to refine cells in multiple directions.
freefoam-renumberMesh(1)
Renumbers the cell list in order to reduce the bandwidth, reading and renumbering all
fields from all the time directories.
freefoam-rotateMesh(1)
Rotates the mesh and fields from the direcion n1 to the direction n2.
freefoam-setSet(1)
Manipulate a cell/face/point/ set or zone interactively.
freefoam-setsToZones(1)
Add pointZones/faceZones/cellZones to the mesh from similar named
pointSets/faceSets/cellSets.
freefoam-splitMesh(1)
Splits mesh by making internal faces external.
freefoam-splitMeshRegions(1)
Splits mesh into multiple regions.
freefoam-stitchMesh(1)
Stitches a mesh.
freefoam-subsetMesh(1)
Selects a section of mesh based on a cellSet.
freefoam-transformPoints(1)
Transforms the mesh points in the polyMesh directory according to the translate,
rotate and scale options.
freefoam-zipUpMesh(1)
Reads in a mesh with hanging vertices and zips up the cells to guarantee that all
polyhedral cells of valid shape are closed.
Error Estimation
freefoam-momentScalarError(1)
Estimates the error in the solution for a scalar transport equation in the standard
form.
freefoam-icoErrorEstimate(1)
Estimates error for the incompressible laminar CFD application icoFoam.
freefoam-estimateScalarError(1)
Estimates the error in the solution for a scalar transport equation in the standard
form.
freefoam-icoMomentError(1)
Estimates error for the incompressible laminar CFD application icoFoam.
Miscellaneous Utilities
freefoam-expandDictionary(1)
Read the dictionary provided as an argument, expand the macros etc. and write the
resulting dictionary to standard output.
freefoam-debugSwitches(1)
Write out all library debug switches.
freefoam-formatConvert(1)
Converts all IOobjects associated with a case into the format specified in the
controlDict.
freefoam-infoExec(1)
Interrogates a case and prints information to screen.
freefoam-patchSummary(1)
Writes fields and boundary condition info for each patch at each requested time
instance.
Parallel Processing
freefoam-redistributeMeshPar(1)
Redistributes existing decomposed mesh and fields according to the current settings in
the decomposeParDict file.
freefoam-reconstructParMesh(1)
Reconstructs a mesh using geometric information only.
freefoam-decomposePar(1)
Automatically decomposes a mesh and fields of a case for parallel execution of
OpenFOAM.
freefoam-reconstructPar(1)
Reconstructs a mesh and fields of a case that is decomposed for parallel execution of
OpenFOAM.
Post-Processing
freefoam-calc(1)
Generic wrapper for calculating a quantity at each time.
freefoam-dsmcFieldsCalc(1)
Calculate intensive fields (U and T) from averaged extensive fields from a DSMC
calculation.
freefoam-particleTracks(1)
Generates a VTK file of particle tracks for cases that were computed using a
tracked-parcel-type cloud.
Data Conversion
freefoam-foamDataToFluent(1)
Translates FOAM data to Fluent format.
freefoam-foamToEnsight(1)
Translates FOAM data to EnSight format.
freefoam-foamToEnsightParts(1)
Translates OpenFOAM data to Ensight format. An Ensight part is created for each
cellZone and patch.
freefoam-foamToFieldview9(1)
Write out the OpenFOAM mesh in Version 3.0 Fieldview-UNS format (binary).
freefoam-foamToGMV(1)
Translates foam output to GMV readable files.
freefoam-foamToVTK(1)
Legacy VTK file format writer.
freefoam-smapToFoam(1)
Translates a STAR-CD SMAP data file into FOAM field format.
Miscellaneous
freefoam-engineCompRatio(1)
Calculate the geometric compression ratio. Note that if you have valves and/or
extra volumes it will not work, since it calculates the volume at BDC and TCD.
freefoam-execFlowFunctionObjects(1)
Execute the set of functionObjects specified in the selected dictionary (which
defaults to system/controlDict) for the selected set of times.
freefoam-pdfPlot(1)
Generates an .obj file to plot a probability distribution function.
freefoam-postChannel(1)
Post-processes data from channel flow calculations.
freefoam-ptot(1)
For each time: calculate the total pressure.
freefoam-wdot(1)
Calculates and writes wdot for each time.
freefoam-writeCellCentres(1)
Write the three components of the cell centres as volScalarFields so they can be
used in postprocessing in thresholding.
Data Sampling, Averaging and Integration
freefoam-patchIntegrate(1)
Calculates the integral of the specified field over the specified patch.
freefoam-patchAverage(1)
Calculates the average of the specified field over the specified patch.
freefoam-sample(1)
Sample field data with a choice of interpolation schemes, sampling options and
write formats.
freefoam-probeLocations(1)
Probe locations.
freefoam-pPrime2(1)
Calculates and writes the scalar field of pPrime2 (sqr(p - pMean)) at each time.
Stress Analysis
freefoam-stressComponents(1)
Calculates and writes the scalar fields of the six components of the stress tensor
sigma for each time.
Turbulence Quantities
freefoam-createTurbulenceFields(1)
Creates a full set of turbulence fields.
freefoam-R(1)
Calculates and writes the Reynolds stress R for the current time step.
Flow Field Quantities
freefoam-Co(1)
Calculates and writes the Co number as a surfaceScalarField obtained from field
phi.
freefoam-Lambda2(1)
Calculates and writes the second largest eigenvalue of the sum of the square of
the symmetrical and anti-symmetrical parts of the velocity gradient tensor.
freefoam-Mach(1)
Calculates and optionally writes the local Mach number from the velocity field U
at each time.
freefoam-Pe(1)
Calculates and writes the Pe number as a surfaceScalarField obtained from field
phi.
freefoam-Q(1)
Calculates and writes the second invariant of the velocity gradient tensor.
freefoam-enstrophy(1)
Calculates and writes the enstrophy of the velocity field U.
freefoam-flowType(1)
Calculates and writes the flowType of velocity field U.
freefoam-streamFunction(1)
Calculates and writes the stream function of velocity field U at each time.
freefoam-uprime(1)
Calculates and writes the scalar field of uprime (sqrt(2/3 k)).
freefoam-vorticity(1)
Calculates and writes the vorticity of velocity field U.
Wall Quantities
freefoam-wallGradU(1)
Calculates and writes the gradient of U at the wall.
freefoam-wallHeatFlux(1)
Calculates and writes the heat flux for all patches as the boundary field of a
volScalarField and also prints the integrated flux for all wall patches.
freefoam-wallShearStress(1)
Calculates and writes the wall shear stress, for the specified times.
freefoam-yPlusLES(1)
Calculates and reports yPlus for all wall patches, for the specified times.
freefoam-yPlusRAS(1)
Calculates and reports yPlus for all wall patches, for the specified times when
using RAS turbulence models.
Pre-Processing
freefoam-applyBoundaryLayer(1)
Apply a simplified boundary-layer model to the velocity and turbulence fields based on
the 1/7th power-law.
freefoam-applyWallFunctionBoundaryConditions(1)
Updates OpenFOAM RAS cases to use the new (v1.6) wall function framework.
freefoam-boxTurb(1)
Makes a box of turbulence which conforms to a given energy spectrum and is divergence
free.
freefoam-changeDictionary(1)
Utility to change dictionary entries.
freefoam-dsmcInitialise(1)
Initialise a case for dsmcFoam by reading the initialisation dictionary
system/dsmcInitialise.
freefoam-engineSwirl(1)
Generates a swirling flow for engine calulations.
freefoam-upgradeFvSolution(1)
Simple tool to upgrade the syntax of system/fvSolution::solvers.
freefoam-mapFields(1)
Maps volume fields from one mesh to another.
freefoam-mdInitialise(1)
Initialises fields for a molecular dynamics (MD) simulation.
freefoam-setFields(1)
Selects a cell set through a dictionary.
Surface File Manipulation
freefoam-surfaceAdd(1)
Add two surfaces. Does geometric merge on points. Does not check for
overlapping/intersecting triangles.
freefoam-surfaceAutoPatch(1)
Patches surface according to feature angle. Like autoPatch.
freefoam-surfaceCheck(1)
Performs various checks on surface.
freefoam-surfaceClean(1)
Collapses small edges, removing triangles and converts sliver triangles into split
edges by projecting point onto base of triangle.
freefoam-surfaceCoarsen(1)
Surface coarsening using bunnylod.
freefoam-surfaceConvert(1)
Converts from one surface mesh format to another.
freefoam-surfaceFeatureConvert(1)
Extracts and writes surface features to file.
freefoam-surfaceFeatureExtract(1)
Extracts and writes surface features to file.
freefoam-surfaceFind(1)
Finds nearest triangle and vertex.
freefoam-surfaceMeshConvert(1)
Convert between surface formats with optional scaling or transformations
(rotate/translate) on a coordinateSystem.
freefoam-surfaceMeshConvertTesting(1)
Converts from one surface mesh format to another, but primarily used for testing
functionality.
freefoam-surfaceMeshExport(1)
Export from surfMesh to various third-party surface formats with optional scaling or
transformations (rotate/translate) on a coordinateSystem.
freefoam-surfaceMeshImport(1)
Import from various third-party surface formats into surfMesh with optional scaling or
transformations (rotate/translate) on a coordinateSystem.
freefoam-surfaceMeshTriangulate(1)
Extracts triSurface from a polyMesh.
freefoam-surfaceOrient(1)
Set normal consistent with respect to a user provided outside point.
freefoam-surfacePointMerge(1)
Merges points on surface if they are within absolute distance.
freefoam-surfaceRedistributePar(1)
(Re)distribution of triSurface. Either takes an undecomposed surface or an already
decomposed surface and redistribute it so each processor has all triangles that
overlap its mesh.
freefoam-surfaceRefineRedGreen(1)
Refine by splitting all three edges of triangle (red refinement). Neighbouring
triangles (which are not marked for refinement get split in half (green) refinement.
freefoam-surfaceSmooth(1)
Example of simple laplacian smoother.
freefoam-surfaceSplitByPatch(1)
Writes regions of triSurface to separate files.
freefoam-surfaceSplitNonManifolds(1)
Takes multiply connected surface and tries to split surface at multiply connected
edges by duplicating points.
freefoam-surfaceSubset(1)
A surface analysis tool which sub-sets the triSurface to choose only a part of
interest.
freefoam-surfaceToPatch(1)
Reads surface and applies surface regioning to a mesh.
freefoam-surfaceTransformPoints(1)
Transform (scale/rotate) a surface.
Thermophysical Utilities
freefoam-adiabaticFlameT(1)
Calculates the adiabatic flame temperature for a given fuel over a range of unburnt
temperatures and equivalence ratios.
freefoam-chemkinToFoam(1)
Converts CHEMKINIII thermodynamics and reaction data files into FOAM format.
freefoam-equilibriumCO(1)
Calculates the equilibrium level of carbon monoxide.
freefoam-equilibriumFlameT(1)
Calculates the equilibrium flame temperature.
freefoam-mixtureAdiabaticFlameT(1)
Calculates the adiabatic flame temperature for a given mixture at a given temperature.
freefoam-IFCLookUpTableGen(1)
Calculate the the infinitely-fast chemistry relationships in function of ft. for a
given fuel.
FreeFOAM Helper Scripts
Below you find an overview of the small helper scripts provided by FreeFOAM.
freefoam-clearPolyMesh(1)
Remove the contents of the constant/polyMesh directory.
freefoam-copySettings(1)
Copy settings from one case directory to another, without copying the mesh or results.
freefoam-graphExecTime(1)
Computes the time used per iteration.
freefoam-graphResKE(1)
Extract the residuals of k and epsilon at each time step.
freefoam-graphResUVWP(1)
Extract the residuals of U, V, W and p at each time step.
freefoam-job(1)
Runs a FreeFOAM job in the background.
freefoam-log(1)
Extracts xy files from Foam logs.
freefoam-para(1)
Start ParaView3 to visualize a case.
freefoam-solverSweeps(1)
Extract solver statistics from a log file.
CONFIGURATION MECHANISM
FreeFOAM offers a number of global configuration options. These include
• location of the API documentation and the method to display it
• debug, info and optimisation switches
• physical constants
• plugin search paths
• parallel communications method
• starting of a parallel job
Global Configuration Files
Unfortunately the OpenFOAM library (on which FreeFOAM builds) and some applications
require the following files to be present for start-up:
• cellModels
• controlDict
• thermoData/BurcatCpData
• thermoData/therm.dat
It finds them in the following places (in the specified order, picking the first hit):
1. Under the directory specified in the $FREEFOAM_CONFIG_DIR environment variable
2. In $HOME/.FreeFOAM/0.1
3. In $HOME/.FreeFOAM
4. In the installation directory of the configuration files,
/usr/local/etc/FreeFOAM/0.1.0
where the versions in above directory names depend on the version of the FreeFOAM
application to be run.
Locating the API documentation
All FreeFOAM applications accept the options -doc and -srcDoc. The former locates and
displays the API documentation of the application, the latter the source code. This,
however, requires that FreeFOAM is able to locate the API documentation and knows which
program to use for display.
By default FreeFOAM uses the API documentation provided on http://freefoam.sf.net/doc/API
because most users will not want to install the sizeable documentation package. The method
FreeFOAM uses to locate the documentation files is via index files which are conventional
FreeFOAM dictionaries. Each of them contains an entry docDir specifying the documentation
root location (such as http://freefoam.sf.net/doc/API) and a dictionary called docFiles
mapping the application name to the names of the corresponding HTML documentation and
source page.
These documentation indices are found by querying the list Documentation::doxyDocIndices
in the global controlDict file. If multiple documentation indices are specified, the first
index that provides documentation for the given application is picked.
Displaying the API documentation
FreeFOAM can automatically open a browser window displaying the HTML documentation for
you. The entry Documentation::docBrowser in the global controlDict can be used to change
which program is used for this. In this string the token %f gets replaced by the filename
to open.
Debug, Info and Optimisation Switches
The lists DebugSwitches, InfoSwitches and OptimisationSwitches in the global controlDict
file determine some global run-time behaviour of FreeFOAM. The entries in DebugSwitches
can be set to 1 for more verbose output in the specified class.
The InfoSwitches::writePrecision setting determines the write precision in the output to
the terminal (i.e. not the output written to files). Whether a job-info file should be
created can be specified by enabling InfoSwitches::writeJobeInfo.
For files that are modifieable during run-time (e.g. to change the interval at which the
output is created), FreeFOAM compares the modification times of these files in order to
determine whether they have to be re-read. The setting
OptimisationSwitches::fileModificationSkew determines the minimum modification-time
difference in seconds for a file to be considered changed.
The setting OptimisationSwitches::commsType determines whether inter-process
communications are either blocking, scheduled or nonBlocking.
OptimisationSwitches::floatTransfer causes to convert double values to float before
transferring them through the communications library. This saves some bandwidth at the
loss of accuracy.
The sum operation across processors can be executed either in a linear or a tree fashion.
Especially for a large number of processors, tree-summation is significantly faster. The
threshold at which to switch from linear to tree-summation is determined by
OptimisationSwitches::nProcsSimpleSum.
Physical Constants
DimensionedConstants::R
Universal gas constant
DimensionedConstants::Pstd
Standard pressure
DimensionedConstants::Tstd
Standard temperature
DimensionedConstants::sigmaSB
Stefan-Boltzmann constant
Plugin Search Path
FreeFOAM very often relies on dynamically loading libraries (a.k.a plugins). If the
library name is given as an absolute path, FreeFOAM tries to load it directly. To locate
libraries specified just by their name or with a relative path, FreeFOAM first tries to
find the library in one of the directories specified in the list LibrarySearchPaths in the
global controlDict and, if the library was not found, falls back to the mechanism provided
by your operating system (i.e. for Linux systems this would be the LD_LIBRARY_PATH and the
default search path).
Selecting the Parallel Communications Library
Both, FreeFOAM and OpenFOAM abstract the parallel operations into the Pstream library,
making it rather simple to firstly switch between parallel implementations and secondly
port the software to a new communications library. However, FreeFOAM uses a much more
flexible mechanism of determining which Pstream implementation library to use than
OpenFOAM. The latter does this by adjusting the LD_LIBRARY_PATH environment variable. As
FreeFOAM wants to be a well behaved Linux citizen, this is not an option. Instead,
FreeFOAM dynamically loads the desired Pstream library at startup (i.e. as a plug-in). The
following list details how FreeFOAM determines what library to load (if at all):
1. If the environment variable FREEFOAM_PSTREAM_LIBRARY is set, FreeFOAM will try to load
the library specified by it.
2. If the sub-dictionary PstreamImplementation exists in the global controlDict file (see
above), it reads the value of the entry PstreamImplementation::configName therein.
This entry can be overridden by setting the FREEFOAM_PSTREAM_CONFIG environment
variable. It then expects that a sub-dictionary of PstreamImplementation with the name
specified in FREEFOAM_PSTREAM_CONFIG or PstreamImplementation::configName exists. If
that sub-dictionary contains the entry PstreamImplementation::library, it will try to
load a library specified by the value of that entry.
Please note that this library is also considered to be a plugin, and thus is located in
the same way as described above.
After FreeFOAM (possibly) loaded the library, it will try to instantiate concrete
implementations of the abstract base classes PstreamImpl, IPstreamImpl and OPstreamImpl.
Which classes are to be instantiated is determined as follows:
1. FreeFOAM queries the environment variables FREEFOAM_PSTREAM_CLASS,
FREEFOAM_IPSTREAM_CLASS and FREEFOAM_OPSTREAM_CLASS for the class names to be
instantiated.
2. For any of the variables not set, it requires the sub-dictionary PstreamImplementation
to be present in the global controlDict, reads the value of FREEFOAM_PSTREAM_CONFIG or
the entry PstreamImplementation::configName and similarly to the library loading,
loads the sub-dictionary specified by that value. It then expects to find the entries
PstreamImplementation::Pstream, PstreamImplementation::IPstream and
PstreamImplementation::OPstream which specify the names of the classes to load.
This means that one can create a global controlDict file containing (among other things)
something like the following:
PstreamImplementation
{
//configName dummy;
configName mpi;
dummy
{
library libdummyPstream.so;
Pstream dummyPstreamImpl;
OPstream dummyOPstreamImpl;
IPstream dummyIPstreamImpl;
}
mpi
{
library libmpiPstream.so;
Pstream mpiPstreamImpl;
OPstream mpiOPstreamImpl;
IPstream mpiIPstreamImpl;
}
}
This way the administrator can provide a global controlDict in the FreeFOAM installation.
Every user can then override that controlDict by supplying her own file in her home
directory as detailed above. In order to select a particular Pstream implementation for a
specific communications library, the user can then either adjust the
PstreamImplementation::configName entry in the global controlDict file, set the
FREEFOAM_PSTREAM_CONFIG variable or, for full control, set the variables
FREEFOAM_PSTREAM_LIBRARY, FREEFOAM_PSTREAM_CLASS, FREEFOAM_IPSTREAM_CLASS and
FREEFOAM_OPSTREAM_CLASS.
Starting of a Parallel Job
Some of the tutorial scripts need to run FreeFOAM applications in parallel. However, how
to do so differs strongly from system to system and between parallel communication
libraries. This is why the command line to start an application in parallel is
configureable in the parRunTemplate setting. ${NPROCS}, ${PAROPTS}, ${APPLICATION} and
${ARGS} are placeholders for the number of processors to use, options for the parallel
communications system, the application to run and its arguments, respectively. Note that
the -parallel option is NOT included in ${ARGS}.
ENVIRONMENT VARIABLES
FREEFOAM_CONFIG_DIR
Directory containing the global configuration files
FREEFOAM_PATH
Additional, colon separated paths in which to first search for FreeFOAM executables
FREEFOAM_PSTREAM_CONFIG
Name of the Pstream configuration in the global controlDict file to use
FREEFOAM_PSTREAM_LIBRARY
The Pstream library to load
FREEFOAM_PSTREAM_CLASS
Name of the concrete PstreamImpl class to instantiate
FREEFOAM_IPSTREAM_CLASS
Name of the concrete IPstreamImpl class to instantiate
FREEFOAM_OPSTREAM_CLASS
Name of the concrete OPstreamImpl class to instantiate
SEE ALSO
The user guide is available from http://freefoam.sourceforge.net/doc/UserGuide and the
Doxygen-generated API documentation can be accessed at
http://freefoam.sourceforge.net/doc/API.
AUTHOR
Michael Wild <themiwi@users.sourceforge.net>
FREEFOAM
Part of the freefoam(1) suite
COPYRIGHT
• Copyright © 1991-2010 OpenCFD Ltd.
• Copyright © 2008-2012 Michael Wild.