oofem-wiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

==== Input File Description ====

Here, general description of OOFEM input files for solving flow problems can be found. Fully general description of OOFEM input file (for all problems) can be found here: [[http://www.oofem.org|www.oofem.org]]

As a sample input file, input file for V-funnel simulation is choosen:

In general, OOFEM input file can be (imaginary) divided into three main sections. In the first section specifications about type of problem under consideration, type of solver and exported variables are specified. In the second section there is a mesh descriptions. That means list of nodes with its numbers, coordinates and boundary conditions and list of elements specifying its type, numbers of connecting nodes, it's appropriate material and eventually its load. In the third section description of materials, boundary conditions and related entities is done.

===First section===
 In first section (first seven lines), there is description of type of problem under consideration, type of solver and exported variables are specified.

First line specifies the location of OOFEM output file. Note, that the path must be an absolute path.

Second line is for user comment. There can be any description of solved problem, OOFEM ignores that line.

Third line describes type of solver and it's parameters. Some of them are genereal and necessary for all solvers, some of them are specific for concrete solver.
Note, that order of keywords is not determined!!!

^  Keyword   ^  Possible values   ^   Description of function   ^
|  supg  |   -   | The type of solved problem/type of solving (numerical) scheme. Here, **//supg//** represents name of solver for incompressible Navier-Stokes equations. It is a fully stabilized numerical scheme with Stramline-Upwind/Petrov-Galerkin and Pressure-Stabilizing/Petrov-Galerkin stabilizations. |
|  nsteps  |  integer number  | Number of time steps.|
|  lstype  |  0, 1  | Determines "linear solver type". For example "0" is for direct solver, "1" is for iterative solver. |
|  smtype  |  0, 1,..,10  | Determines "storage of matrix". Number "0" is symmetric skyline, "1" is unsymmetric skyline (note, that supg scheme leads to unsymmetric "stiffness" matrix), "2" is for "compressed column" storage etc. See OOFEM documentation for details.|
|  stype  |  0, 1  | Concrete choice of ITERATIVE solver. Here, "0" is for Cojugate Gradients, "1" is for GMRES (note, that since "stifness matrix" is unsymmetric, Conjugate Gradients doesn't work).|
|  lsprecond  |  0, 1, 2...  | Determines type of preconditioner for solving linear algebraic system. With "0", void preconditioner is used, "1" is for diagonal preconditioner, "2" is for ILU (incomplete LU decomposition).|
|  deltaT  |  real number  | Length of time step|
|  renumber  |  0, 1  | Is the "flag" which cause renumbering of equations due to improve efficiency of solving the system of equations.|
|  renumberflag  |  0, 1  | Is the same as **//renumber//**, but it is done at each time step. This is useful for example when boundary conditions are changing (opening of the gate of L-Box).|
|  alpha  |  0 - 1  | Different numerical scheme for time integration can be chosen(generalized mid-point family). For example "0" means "Forward Euler", "0.5" is for "trapezoidal rule", "2/3" for "Galerkin method", or "1" for "Backward Euler method". Note that for "alpha" greater that 0.5 the method is unconditionally stable but requires matrix inversion. |
|  maxiter  |  integer number  | Determines number of iterations of non-linear solver (Newton-Raphson method).|
|  lsiter  |  integer number  | Determines number of iterations for solver of system of linear algebraic equations (iterative solver).|
|  miflag  |  1, 2  |Governs handling with interface. It can be equal to "1" for "Volume Of Fluid" method, or "2" for "Level Set Method".|
|  nmodules  |  1  |Is a flag for creating *.vtk output (Paraview).|
|  refmatpolyx and refmatpolyy  |  vector valued  |By these variables, polygon describing initial position of interface between fluids can be entered. These parameters are vector valued, while first number governs number of columns. Rest of the numbers are coordinates of that polygon|

Next line, starting vtkxml determines number and type of variables for export to *.vtk file for postprocessing (Paraview). Here, **//primvars//** means primary variables. Again, it is a vector and therefore the first number indicates number of columns, while the rest of numbers determines type of variables. In presented file, "4" means velocity vector, "5" means pressure. **//vars//** means other variables (not directly computed). Here, "43" means Volume Of Fluid, "45" Level set function.

On the next line, type of the domain is specified. It determines the number of dofs per node etc. Next line, the last one from first section, describes number of time_steps etc for printing into oofem output file.

===Second section ===

In the second section mesh geometry is specified. In first line of second section (globally counting it is 8. line) number of mesh entities (elements, nodes...) and other items.

^  Keyword   ^  Possible values   ^   Description of function   ^
|  ndofman  |  integer number  |Number of mesh nodes|
|  nelem  |  integer number  | Number of elements in the mesh|
|  ncsrosssect  |  integer number  | Number of crosssections. This is important for structural mechanics. In fluid mechanics it is meaningless. However, it has to be specified|
|  nmat  |  integer number  | Number of materials. Note, that for two-fluid flow there has to be 3 materials. One master material, so called "twofluidmat" which governs tho slave materials, for instance Binghamfluid (for concrete) and newtonianfluid (for air)|
|  nbc  |  integer number  | Number of boundary conditions. This means number of types of BC. Here, different type means not just Dirichlet or Neumann. Each value of Dirichlet BC has to be specified independently. Similarly fo Neumann BC.|
|  nic  |  integer number  | Number of initial conditions. Same rules as for BC.|
|  nltf  |  integer number  | Number of "load time functions". Useful for time depending load and BC's. |

After that, list of nodes and elements is specified. Basic syntax is always the same.

**node:** node 1 coords 3 2.250000e+02 0.000000e+00 0.000000e+00 bc 3 1 4 0

^  Keyword   ^  Possible values   ^   Description of function   ^
|  node  |  integer number  |Serial number of the node.|
|  coords  |  vector valued  |Coordinates of the node. It is a vector, first number determines number of columns, the rest are x,y,z coordinates.|
|  bc  |  vector valued  |Boundary condition corresponding to the node. Again, first number determines number of columns, the rest specifies concrete choice of BC for each degree of freedom.|

Similarly for the elements:

**element:** tr1supg 1 nodes 3 9 41 340 crosssect 1 mat 1 bodyloads 1 3 boundaryLoads 2 5 1

===Third section===

In the third section, specification of **//crosssections, materials, boundary//** and **//initial conditions//** and **//loadtimefunctions//** is done.

Since general description of these parameters is little bit complicated, we refer interested reader to [[http://www.oofem.org|www.oofem.org]] for further details. Here, only quick description of lines in presented file will be given.

^  Entity  ^  parameters in presented file  ^  Description  ^
|  emptycs  |  1  |Emptycs means "void crosssection". (it has no meaning in fluid dynamics, but it has to be specified)|
|  twofluidmat  |  1 mat 2 2 3  |Twofluidmat is name of "master material" for two fluid flow. It coordinates compilation of diffusive temrs depending where the gausspoint is (concrete or air). Number "1" means that it is a first material. Parameter **//mat//** is a vector containing numbers of materials governed by twofluidmat (note, that the first number specifies number of columns). Here, Twofluidmat has two "slaves materials with numbers "2" and "3".|
|  newtonianfluid  |  2 d 0.000001 mu 0.001  |Description of newtonian fluid. It is the second material, **//d//** is density, **//mu//** means viscosity.|
|  binghamfluid2  |   3 d 0.0000023 mu0 0.02 tau0 0.04 muinf 0.001  |Description of Bingham fluid. It is the third material, **//d//** is for density, **//mu0//** is plastic viscosity and **//tau0//** is yield stress. **//muinf//** is some minimal value of mu due to numerical problems.|
|  BoundaryCondition  |  1 loadtimefunction 1 prescribedvalue 0.0 valtype 5  | Description of first type of BC (Dirichlet BC). It uses loadtimefunction no. 1 and the prescribed value is 0.0. **//valtype//** is specification of physical meaning of BC. Number "5" means velocity.|
|  Deadweight  |  3 components 2 0.0 -9810 loadTimeFunction 1 valtype 2  |This is type of body load. It is considered as a boundary condition, so it shares the numbering with previous item. It is the third BC. **//components//** is the body load vector with 2 components (x and z direction).|
|  ConstantEdgeLoad  |  5 ndofs 2 loadtype 4 loadTimeFunction 1 components 2 0 0 properties 1 a 0.2  |This is specification of boundary load. Numbering is shared with all boundary conditions, this is fifth one. **//ndofs//** must be equal to the number of corresponding dofs, in this case it is 2 (components of velocity). **//loadtype//** specifies type of BC, for example flux, convection, etc. Number "4" means "Slip with friction" boundary condition. **//loadtimefunction//** and **//components//** are the same meaning like before. **//properties//** stores coefficient of friction, here it is equal 0.2|
|  ConstantFunction  |  1 f(t) 1.0  | Specification od loadtime function. This is just constant function, sine there are BC's not depending on time. It is the first function with value equal to "1" |
| UsrDefLTF  |  2 f(t) "1-(t>0.04)"  | User defined load time function. It is the second load time function. "1-(t>0.04)" means, that it is active for time greater than 0.04.|

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International