4.1 File structure of OpenFOAM cases

The basic directory structure of an OpenFOAM case, containing the minimum set of files required to run an application, is shown in Figure 4.1 and described as follows:


<case> system controlDict see section 4.4 fvSchemes see section 4.5 fvSolution see section 4.6 constant ...Properties see chapter 8 polyMesh see section 5.2 points faces owner neighbour boundary time directories see subsection 4.2.9 \relax \special {t4ht=


Figure 4.1: Case directory structure



constant directory

that contains a full description of the case mesh in a subdirectory polyMesh and files specifying properties and models for the application concerned, e.g. physicalProperties and momentumTransport.


system directory

for setting parameters associated with the solution procedure itself. It contains at least the following three files: controlDict where run control parameters are set including start/end time, time step and parameters for data output; fvSchemes where discretisation schemes used in the solution are selected; and, fvSolution where the equation solvers, tolerances and other algorithm controls are set for the run.


‘time’ directories

containing individual files of data for particular fields, e.g. velocity and pressure. The data can be: either, initial values and boundary conditions that the user must specify to define the problem; or, results written to file by OpenFOAM. Fields must always be initialised, even when the solution does not strictly require it, as in steady-state problems. The name of each time directory is based on the simulated time at which the data is written and is described fully in section 4.4 . Since we usually start our simulations at time eqn, the initial conditions are usually stored in a directory named 0. For example, in the motorBike tutorial, the velocity field eqn and pressure field eqn are initialised from files 0/U and 0/p respectively.

OpenFOAM v12 User Guide - 4.1 File structure of OpenFOAM cases