Object hierarchy

From Gerris

Revision as of 14:52, 2 November 2009 Popinet (Talk | contribs) (→Source terms) ← Previous diff		Revision as of 14:54, 2 November 2009 Popinet (Talk | contribs) (→Introduction) Next diff →
Line 15:		Line 15:
	}		}
-	which in turns means that this object is a descendant of [[GfsOutput]] but also takes the additional arguments described. Similarly [[GfsOutput]] is a descendent of [[GfsEvent]] and finally [[GfsEvent]] is a "root object class" which has no parent. Putting it all together an example of use of [[GfsOutputScalarSum]] is	+	which in turns means that this object is a descendant of [[GfsOutput]] but also takes the additional arguments described. Similarly [[GfsOutput]] is a descendent of [[GfsEvent]] and finally [[GfsEvent]] is a "root object class" which has no parent. Putting it all together, an example of use of [[GfsOutputScalarSum]] is
	GfsOutputScalarSum <font color=red>{ istep = 1 }</font> <font color=blue>sum</font> <font color=green>{ v = U }</font>		GfsOutputScalarSum <font color=red>{ istep = 1 }</font> <font color=blue>sum</font> <font color=green>{ v = U }</font>

---

Revision as of 14:54, 2 November 2009

Contents 1 Introduction 2 Common objects 2.1 Solvers 2.2 Functions and macros 2.3 Variables 2.4 Parameters 2.5 Solid boundaries 2.6 General orthogonal coordinates 2.7 Topology 2.8 Boundary conditions 2.9 Initial mesh refinement 2.10 Initialisation of fields 2.11 Adaptive mesh refinement 2.12 Various events 2.13 Source terms 2.14 Outputs 3 Modules 3.1 Map 3.2 Terrain 3.3 Wavewatch 3.4 Tide 3.5 Lagrangian

Introduction

This page describes all the objects which can be used in Gerris parameter files. The syntax of each object is given using a simple convention which expresses "inheritance" from the parent object. This is more simply explained using an example e.g. GfsOutputScalarSum. The syntax of this object is described as

[ GfsOutputScalar ]

which means that this object is a descendant of GfsOutputScalar. Following the link gives the syntax of GfsOutputScalar as

[ GfsOutput ] {
  v = [ GfsFunction ]
  maxlevel = 6
  min = -12.1
  max = 1e3
  box = -0.1,-0.1,0.1,0.1
}

which in turns means that this object is a descendant of GfsOutput but also takes the additional arguments described. Similarly GfsOutput is a descendent of GfsEvent and finally GfsEvent is a "root object class" which has no parent. Putting it all together, an example of use of GfsOutputScalarSum is

GfsOutputScalarSum { istep = 1 } sum { v = U }

where the red text is "inherited" from the GfsEvent great-grandparent, the blue text from the GfsOutput grandparent and the green text from the GfsOutputScalar parent.

Common objects

Note that the way the following list is indented reflects the inheritance hierarchy of each object.

Solvers

• GfsSimulation
  • GfsSimulationMoving — Integration of moving solid boundaries
  • GfsOcean
  • GfsAdvection
  • GfsPoisson
  • GfsWave
  • GfsRiver — Solves the Saint-Venant equations

Functions and macros

• GfsGlobal — Global functions

• GfsFunction — Numerical constants and expressions

• GfsDefine — Text macros

Variables

• GfsVariable — Scalar fields
  • GfsVariableTracer — Advected scalar fields
    • GfsVariableTracerVOF — Volume-Of-Fluid advection
  • GfsVariableResidual
  • GfsVariableFiltered — Spatial filtering
  • GfsVariableFunction — Optimising function evaluations
    • GfsVariableStreamFunction — Maintaining a velocity field defined by a stream function
  • GfsVariableCurvature — Curvature of an interface
    • GfsVariablePosition — Coordinates of a VOF interface
  • GfsVariableDistance — Signed distance to a VOF interface

Parameters

• GfsPhysicalParams
• GfsProjectionParams — Tuning the Poisson solver
• GfsAdvectionParams

Solid boundaries

• GfsSolid — Solid boundaries
  • GfsSolidMoving — Moving solid boundaries

• GfsSurfaceBc — Boundary conditions for diffusion equations

General orthogonal coordinates

• GfsMetricLonLat
• GfsMetricCubed

• GfsMap — Coordinates transformations
  • GfsMapFunction

Topology

• GfsBox
• GfsGedge

Boundary conditions

• GfsBcDirichlet — Dirichlet boundary condition (i.e. value)
• GfsBcNeumann — Neumann boundary condition (i.e. value of the normal derivative)
• GfsBcNavier — Navier slip/Robin boundary condition
• GfsBcFlather — "Flather" boundary conditions for barotropic flows
• GfsBcSubcritical

• GfsBoundary
  • GfsBoundaryInflowConstant
  • GfsBoundaryOutflow
  • GfsBoundaryPeriodic
    • GfsBoundaryMpi

Initial mesh refinement

• GfsRefine — Simple definition of the refinement levels
  • GfsRefineSolid — Refine embedded solid surfaces
  • GfsRefineSurface — Refine cells cut by a surface
    • GfsRefineDistance — Refine cells as a function of the distance from a surface
    • GfsRefineHeight

Initialisation of fields

• GfsEvent — Any action to be performed at a given time
  • GfsInit — Initialising variables
  • GfsInitFraction — Initialising volume fractions from interface shapes
  • GfsInitVorticity — Initialising a vorticity field
  • GfsInitWave — Initial wave spectrum for wave model

Adaptive mesh refinement

• GfsEvent
  • GfsAdapt — Base class for adaptive refinement criteria
    • GfsAdaptVorticity — Adapting cells depending on the local vorticity
    • GfsAdaptGradient — Adapting cells depending on the local gradient of a variable
      • GfsAdaptError — Adapting using an a posteriori error estimate
    • GfsAdaptStreamlineCurvature
    • GfsAdaptFunction — Adapting cells depending on the value of a function

Various events

• GfsEvent
  • GfsEventSum — Time-integral of a variable or function
  • GfsEventHarmonic — Harmonic decomposition of a variable
  • GfsEventStop — Stopping when steady-state is reached
  • GfsEventScript — Executing a shell-script at given times
  • GfsEventBalance — Dynamic load-balancing
  • GfsRemoveDroplets — Controlling the topology of interfaces
  • GfsRemovePonds — Controlling the domain topology
  • GfsEventFilter — Exponential filtering of variables

Source terms

• GfsEvent
  • GfsSourceGeneric — Abstract class for source terms
    • GfsSourceScalar — Source terms for scalar variables
      • GfsSource — Source defined by a function
      • GfsSourceControl — Controlling the spatially-averaged value of a scalar
        • GfsSourceControlField — Controlling the value of a scalar averaged at a given spatial scale
        • GfsSourceFlux — Adding a flux on a given area or volume
      • GfsSourceDiffusion — Scalar diffusion
        • GfsSourceDiffusionExplicit
    • GfsSourceVelocity — Source terms for velocity
      • GfsSourceViscosity — Viscous terms
        • GfsSourceViscosityExplicit
      • GfsSourceFriction
      • GfsSourceCoriolis — Coriolis acceleration and linear friction
        • GfsSourceTension — Surface tension
        • GfsSourceTensionCSS
      • GfsSourceHydrostatic

Outputs

• GfsEvent
  • GfsOutput — Writing simulation data
    • GfsOutputTime — Model time, timestep and computing times
    • GfsOutputProgress
    • GfsOutputProjectionStats
    • GfsOutputDiffusionStats
    • GfsOutputSolidStats
    • GfsOutputAdaptStats — Information about the mesh adaptation
    • GfsOutputTiming
    • GfsOutputBalance — Writing simulation size statistics
    • GfsOutputSolidForce — Forces and moments on the embedded solid boundaries
    • GfsOutputLocation — Writing the values of variables at specified locations
    • GfsOutputSimulation — Writing the whole simulation
    • GfsOutputBoundaries
    • GfsOutputParticle — Tracking Lagrangian particles
    • GfsOutputScalar — Generic output of scalar fields
      • GfsOutputScalarNorm — Computing the norms of a scalar field
      • GfsOutputScalarStats — Computing simple statistics for a scalar field
      • GfsOutputScalarSum — Computing the sum of a scalar field
      • GfsOutputScalarMaxima
      • GfsOutputScalarHistogram — Computing histograms
      • GfsOutputDropletSums — Computing sums for each droplet
      • GfsOutputErrorNorm — Computing differences to a reference solution
        • GfsOutputCorrelation
      • GfsOutputSquares
      • GfsOutputStreamline
      • GfsOutputPPM — Writing 2D images

Modules

Map

The Map module defines the objects used to perform cartographic projections within Gerris. As all modules, it is optional and depends on the availability of the PROJ.4 cartographic projections library on your system. The module is initialised in parameter files using

GModule map

and defines the GfsMapProjection object with the following inheritance hierarchy

• GfsMap
  • GfsMapProjection — Geographic transformations of model coordinates

Terrain

The Terrain module contains a set of objects which can be used to define solid boundaries using large Digital Terrain Model (DTM) databases. The databases are only limited in size by the amount of disk space available and include an R*-tree spatial index for efficient retrieval of subsets of the original data. The module is initialised in parameter files using

GModule terrain

and defines the GfsRefineTerrain and GfsTerrain objects with the following inheritance hierarchy

• GfsRefine
  • GfsRefineTerrain — Refines the mesh and creates the corresponding terrain model

• GfsSolid
  • GfsTerrain — Creates a solid boundary following a given terrain model

• GfsVariable
  • GfsVariableTerrain — Defines a variable containing the terrain height

Real terrains are often defined in a geographic coordinate system (e.g. longitude, latitude and height) and in practice this module is often combined with the Map module.

The terrain databases used by GfsRefineTerrain need to be created in a pre-processing step using the xyz2rsurface command-line utility.

Wavewatch

The Wavewatch module can be used only in GfsWave simulations. When this module is included, the GfsWave simulation will call the source terms routines (wind, wave breaking etc...) of the WaveWatch III spectral wave model. The module is initialised in parameter files using

GModule wavewatch

The wind field is defined by the U10 and V10 variables: the coordinates of the local wind vector (in m/sec and at a reference height of 10 m).

If the AS field is defined an "atmospheric stability correction" is applied to the wind field (see Section 2.3.5 of WaveWatch manual version 3.12). The AS field must be initialised with the air/sea temperature difference in degree Celsius.

Tide

Lagrangian

GModule lagrangian

• GfsEvent
  • GfsLagrangianParticles — Creates Lagrangian particles moving under fluid forces, namely, drag, lift, inertial, added mass force(AMF) and external forces.