Initialize at openlb-1-3

6 files changed, 783 insertions, 0 deletions

diff --git a/examples/laminar/cavity2d/sequential/Makefile b/examples/laminar/cavity2d/sequential/Makefile
new file mode 100644
index 0000000..a953954
--- /dev/null
+++ b/examples/laminar/cavity2d/sequential/Makefile
@@ -0,0 +1,105 @@
+#  This file is part of the OpenLB library
+#
+#  Copyright (C) 2007 Mathias Krause
+#  E-mail contact: info@openlb.net
+#  The most recent release of OpenLB can be downloaded at
+#  <http://www.openlb.net/>
+#
+#  This program 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.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public
+#  License along with this program; if not, write to the Free
+#  Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+#  Boston, MA  02110-1301, USA.
+
+###########################################################################
+## definitions
+
+include definitions.mk
+
+include $(ROOT)/global.mk
+
+OBJECTS    := $(foreach file, $(SRC), $(PWD)/$(file:.cpp=.o))
+DEPS       := $(foreach file, $(SRC), $(PWD)/$(file:.cpp=.d))
+
+###########################################################################
+## all
+
+all : depend compile link
+
+
+###########################################################################
+## dependencies
+
+depend : $(DEPS)
+
+$(PWD)/%.d : %.cpp
+	@echo Create dependencies for $<
+	@$(SHELL) -ec '$(CXX) -M $(CXXFLAGS) $(IDIR) $< \
+                       | sed -e "s!$*\.o!$(PWD)\/$*\.o!1" > .tmpfile; \
+                       cp -f .tmpfile $@;'
+
+###########################################################################
+## compile
+
+compile : $(OBJECTS)
+
+$(PWD)/%.o: %.cpp
+	@echo Compile $<
+	$(CXX) $(CXXFLAGS) $(IDIR) -c $< -o $@
+
+###########################################################################
+## clean
+
+clean : cleanrub cleanobj cleandep
+
+cleanrub:
+	@echo Clean rubbish files
+	@rm -f *~ core .tmpfile tmp/*.* $(OUTPUT)
+	@rm -f tmp/vtkData/*.* tmp/vtkData/data/*.* tmp/imageData/*.* tmp/gnuplotData/*.* tmp/gnuplotData/data/*.*
+
+cleanobj:
+	@echo Clean object files
+	@rm -f $(OBJECTS)
+
+cleandep:
+	@echo Clean dependencies files
+	@rm -f $(DEPS)
+
+cleanbuild:
+	@cd $(ROOT); \
+	 $(MAKE) cleanlib;
+
+###########################################################################
+## update lib
+
+$(ROOT)/$(LIBDIR)/lib$(LIB).a :
+	@cd $(ROOT); \
+	$(MAKE) all
+
+###########################################################################
+## link
+
+link: $(OUTPUT)
+
+$(OUTPUT): $(OBJECTS) $(ROOT)/$(LIBDIR)/lib$(LIB).a
+	@echo Link $@
+	$(CXX) $(foreach file, $(SRC), $(file:.cpp=.o)) $(LDFLAGS) -L$(ROOT)/$(LIBDIR) -l$(LIB) -lz -o $@
+
+###########################################################################
+## include dependencies
+
+ifneq "$(strip $(wildcard *.d))" ""
+   include $(foreach file,$(DEPS),$(file))
+endif
+
+###########################################################################
+###########################################################################
diff --git a/examples/laminar/cavity2d/sequential/cavity2d.cpp b/examples/laminar/cavity2d/sequential/cavity2d.cpp
new file mode 100644
index 0000000..c31433e
--- /dev/null
+++ b/examples/laminar/cavity2d/sequential/cavity2d.cpp
@@ -0,0 +1,230 @@
+/*  Lattice Boltzmann sample, written in C++, using the OpenLB
+ *  library
+ *
+ *  Copyright (C) 2006 - 2012 Mathias J. Krause, Jonas Fietz,
+ *  Jonas Latt, Jonas Kratzke
+ *  E-mail contact: info@openlb.net
+ *  The most recent release of OpenLB can be downloaded at
+ *  <http://www.openlb.net/>
+ *
+ *  This program 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.
+ *
+ *  This program is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public
+ *  License along with this program; if not, write to the Free
+ *  Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ *  Boston, MA  02110-1301, USA.
+ */
+
+/* cavity2d.cpp:
+ * This example illustrates a flow in a cuboid, lid-driven cavity.
+ * It also shows how to use the XML parameter files and has an
+ * example description file for OpenGPI. This version is for sequential
+ * use. A version for parallel use is also available.
+ */
+
+
+#include "olb2D.h"
+#ifndef OLB_PRECOMPILED // Unless precompiled version is used,
+#include "olb2D.hh"   // include full template code
+#endif
+#include <cmath>
+#include <iostream>
+
+using namespace olb;
+using namespace olb::descriptors;
+using namespace olb::graphics;
+using namespace olb::util;
+using namespace std;
+
+typedef double T;
+#define DESCRIPTOR D2Q9<>
+
+void prepareLattice( UnitConverter<T,DESCRIPTOR> const& converter,
+                     BlockLatticeStructure2D<T,DESCRIPTOR>& lattice,
+                     Dynamics<T, DESCRIPTOR>& bulkDynamics,
+                     OnLatticeBoundaryCondition2D<T,DESCRIPTOR>& bc ) {
+
+  const int nx = lattice.getNx();
+  const int ny = lattice.getNy();
+  const T omega = converter.getLatticeRelaxationFrequency();
+
+  // link lattice with dynamics for collision step
+  lattice.defineDynamics( 0,nx-1, 0,ny-1, &bulkDynamics );
+
+  // left boundary
+  bc.addVelocityBoundary0N(   0,   0,   1,ny-2, omega );
+  // right boundary
+  bc.addVelocityBoundary0P( nx-1,nx-1,   1,ny-2, omega );
+  // bottom boundary
+  bc.addVelocityBoundary1N(   1,nx-2,   0,   0, omega );
+  // top boundary
+  bc.addVelocityBoundary1P(   1,nx-2,ny-1,ny-1, omega );
+
+  // corners
+  bc.addExternalVelocityCornerNN(   0,   0, omega );
+  bc.addExternalVelocityCornerNP(   0,ny-1, omega );
+  bc.addExternalVelocityCornerPN( nx-1,   0, omega );
+  bc.addExternalVelocityCornerPP( nx-1,ny-1, omega );
+}
+
+void setBoundaryValues( UnitConverter<T,DESCRIPTOR> const& converter,
+                        BlockLatticeStructure2D<T,DESCRIPTOR>& lattice, int iT ) {
+
+  if ( iT==0 ) {
+
+    const int nx = lattice.getNx();
+    const int ny = lattice.getNy();
+
+    // set initial values: v = [0,0]
+    for ( int iX=0; iX<nx; ++iX ) {
+      for ( int iY=0; iY<ny; ++iY ) {
+        T vel[] = { T(), T()};
+        lattice.get( iX,iY ).defineRhoU( ( T )1, vel );
+        lattice.get( iX,iY ).iniEquilibrium( ( T )1, vel );
+      }
+    }
+
+    // set non-zero velocity for upper boundary cells
+    for ( int iX=1; iX<nx-1; ++iX ) {
+      T u = converter.getCharLatticeVelocity();
+      T vel[] = { u, T() };
+      lattice.get( iX,ny-1 ).defineRhoU( ( T )1, vel );
+      lattice.get( iX,ny-1 ).iniEquilibrium( ( T )1, vel );
+    }
+
+    // Make the lattice ready for simulation
+    lattice.initialize();
+  }
+}
+
+void getResults( BlockLatticeStructure2D<T,DESCRIPTOR>& lattice,
+                 UnitConverter<T,DESCRIPTOR> const& converter, int iT, Timer<T>* timer,
+                 const T logT, const T imSave, const T vtkSave,
+                 std::string filenameGif, std::string filenameVtk,
+                 const int timerPrintMode, const int timerTimeSteps, bool converged ) {
+
+  // Get statistics
+  if ( iT%converter.getLatticeTime( logT )==0 || converged ) {
+    lattice.getStatistics().print( iT, converter.getPhysTime( iT ) );
+  }
+
+//  if ( iT%timerTimeSteps==0 || converged ) {
+  if ( iT%timerTimeSteps==0 ) {
+    timer->print( iT,timerPrintMode );
+  }
+
+  BlockVTKwriter2D<T> vtkWriter( filenameVtk );
+  BlockLatticePhysVelocity2D<T,DESCRIPTOR> velocity( lattice,converter );
+  BlockLatticePhysPressure2D<T,DESCRIPTOR> pressure( lattice,converter );
+  vtkWriter.addFunctor( velocity );
+  vtkWriter.addFunctor( pressure );
+
+  // Writes the Gif files
+  if ( ( iT%converter.getLatticeTime( imSave )==0 && iT>0 ) || converged ) {
+    BlockEuklidNorm2D<T,DESCRIPTOR> normVel( velocity );
+    BlockGifWriter<T> gifWriter;
+    gifWriter.write( normVel, 0, 3, iT, filenameVtk );
+//    gifWriter.write(normVel, iT, "vel");
+  }
+
+  // Writes the VTK files
+  if ( ( iT%converter.getLatticeTime( vtkSave )==0 && iT>0 ) || converged ) {
+    vtkWriter.write( iT );
+  }
+}
+
+
+int main( int argc, char* argv[] ) {
+
+  // === 1st Step: Initialization ===
+  olbInit( &argc, &argv );
+  OstreamManager clout( std::cout,"main" );
+
+  string fName( "cavity2d.xml" );
+  XMLreader config( fName );
+
+  std::string olbdir = "../../";  //config["Application"]["OlbDir"].get<std::string>();
+  std::string outputdir = "./tmp/"; //config["Output"]["OutputDir"].get<std::string>();
+  singleton::directories().setOlbDir( olbdir );
+  singleton::directories().setOutputDir( outputdir );
+
+  // call creator functions using xml data
+  UnitConverter<T,DESCRIPTOR>* converter = createUnitConverter<T,DESCRIPTOR>( config );
+  // Prints the converter log as console output
+  converter->print();
+  // Writes the converter log in a file
+  converter->write("cavity2d");
+
+  int N = converter->getLatticeLength(1) + 1; // number of voxels in x,y,z direction
+  Timer<T>* timer = createTimer<T>( config, *converter, N*N );
+
+  // === 3rd Step: Prepare Lattice ===
+  T logT = 0.1;   //config["Output"]["Log"]["SaveTime"].get<T>();
+  T imSave = 1;   //config["Output"]["VisualizationImages"]["SaveTime"].get<T>();
+  T vtkSave = 1;  //config["Output"]["VisualizationVTK"]["SaveTime"].get<T>();
+  T maxPhysT = 100; //config["Application"]["PhysParam"]["MaxTime"].get<T>();
+  int timerSkipType = 0;  //config["Output"]["Timer"]["SkipType"].get<T>();
+  int timerPrintMode = 0; //config["Output"]["Timer"]["PrintMode"].get<int>();
+  int timerTimeSteps = 1;
+
+  if ( timerSkipType == 0 ) {
+    timerTimeSteps = converter->getLatticeTime( .1 );
+  }
+//  else {
+//    config["Output"]["Timer"]["TimeSteps"].read( timerTimeSteps );
+//  }
+
+
+  std::string filenameGif = "cavity2dimage";  //config["Output"]["VisualizationImages"]["Filename"].get<std::string>();
+  std::string filenameVtk = "cavity2dvtk";    //config["Output"]["VisualizationVTK"]["Filename"].get<std::string>();
+
+  BlockLattice2D<T, DESCRIPTOR> lattice( N, N );
+
+  ConstRhoBGKdynamics<T, DESCRIPTOR> bulkDynamics (
+    converter->getLatticeRelaxationFrequency(),
+    instances::getBulkMomenta<T,DESCRIPTOR>()
+  );
+
+  OnLatticeBoundaryCondition2D<T,DESCRIPTOR>*
+  boundaryCondition = createInterpBoundaryCondition2D<T,DESCRIPTOR,ConstRhoBGKdynamics<T,DESCRIPTOR> >( lattice );
+
+  prepareLattice( *converter, lattice, bulkDynamics, *boundaryCondition );
+
+  // === 4th Step: Main Loop with Timer ===
+
+  int interval = converter->getLatticeTime( 1 /*config["Application"]["ConvergenceCheck"]["interval"].get<T>()*/ );
+  T epsilon = 1e-3; //config["Application"]["ConvergenceCheck"]["residuum"].get<T>();
+  util::ValueTracer<T> converge( interval, epsilon );
+
+  timer->start();
+  for ( int iT=0; iT <= converter->getLatticeTime( maxPhysT ); ++iT ) {
+    if ( converge.hasConverged() ) {
+      clout << "Simulation converged." << endl;
+      getResults( lattice, *converter, iT, timer, logT, imSave, vtkSave, filenameGif, filenameVtk, timerPrintMode, timerTimeSteps, converge.hasConverged() );
+
+      break;
+    }
+
+    // === 5th Step: Definition of Initial and Boundary Conditions ===
+    setBoundaryValues( *converter, lattice, iT );
+    // === 6th Step: Collide and Stream Execution ===
+    lattice.collideAndStream();
+    // === 7th Step: Computation and Output of the Results ===
+    getResults( lattice, *converter, iT, timer, logT, imSave, vtkSave, filenameGif, filenameVtk, timerPrintMode, timerTimeSteps, converge.hasConverged() );
+    converge.takeValue( lattice.getStatistics().getAverageEnergy(), true );
+  }
+
+  timer->stop();
+  timer->printSummary();
+  delete converter;
+  delete timer;
+  delete boundaryCondition;
+}
diff --git a/examples/laminar/cavity2d/sequential/cavity2d.xml b/examples/laminar/cavity2d/sequential/cavity2d.xml
new file mode 100644
index 0000000..54250f0
--- /dev/null
+++ b/examples/laminar/cavity2d/sequential/cavity2d.xml
@@ -0,0 +1,44 @@
+<Param>
+  <Application>
+    <Name>cavity2d</Name>
+    <dim>2</dim>
+    <OlbDir>../../</OlbDir>
+    <Discretization>
+      <Resolution>128</Resolution>
+      <LatticeRelaxationTime>0.5384</LatticeRelaxationTime>
+    </Discretization>
+    <PhysParameters>
+      <PhysMaxTime>100</PhysMaxTime>
+      <CharPhysLength>1</CharPhysLength>
+      <CharPhysVelocity>1</CharPhysVelocity>
+      <PhysViscosity>0.001</PhysViscosity>
+      <PhysDensity>1</PhysDensity>
+    </PhysParameters>
+    <ConvergenceCheck>
+      <interval>1</interval>
+      <residuum>1e-3</residuum>
+    </ConvergenceCheck>
+  </Application>
+  <Output>
+    <OutputDir>./tmp/</OutputDir>
+    <MultiOutput>false</MultiOutput>
+    <Log>
+      <Filename>cavity2d.log</Filename>
+      <SaveTime>0.1</SaveTime>
+    </Log>
+    <VisualizationVTK>
+      <Filename>cavity2dvtk</Filename>
+      <SaveTime>1</SaveTime>
+    </VisualizationVTK>
+    <VisualizationImages>
+      <Filename>cavity2dimage</Filename>
+      <SaveTime>1</SaveTime>
+    </VisualizationImages>
+    <Timer>
+      <PrintMode>0</PrintMode>
+      <SkipType>0</SkipType>
+      <PhysTime>.1</PhysTime>
+      <PrintSummary>true</PrintSummary>
+    </Timer>
+  </Output>
+</Param>
diff --git a/examples/laminar/cavity2d/sequential/definitions.mk b/examples/laminar/cavity2d/sequential/definitions.mk
new file mode 100644
index 0000000..84ffdca
--- /dev/null
+++ b/examples/laminar/cavity2d/sequential/definitions.mk
@@ -0,0 +1,30 @@
+#  This file is part of the OpenLB library
+#
+#  Copyright (C) 2007 Mathias Krause
+#  E-mail contact: info@openlb.net
+#  The most recent release of OpenLB can be downloaded at
+#  <http://www.openlb.net/>
+#
+#  This program 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.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public
+#  License along with this program; if not, write to the Free
+#  Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+#  Boston, MA  02110-1301, USA.
+
+
+###########################################################################
+###########################################################################
+## DEFINITIONS TO BE CHANGED
+
+ROOT            := ../../../..
+SRC             := cavity2d.cpp
+OUTPUT          := cavity2d
diff --git a/examples/laminar/cavity2d/sequential/description_cavity2d.xml b/examples/laminar/cavity2d/sequential/description_cavity2d.xml
new file mode 100644
index 0000000..63874e1
--- /dev/null
+++ b/examples/laminar/cavity2d/sequential/description_cavity2d.xml
@@ -0,0 +1,345 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<description xmlns="http://numhpc.math.kit.edu">
+  <version>0.1</version>
+  <block>
+    <name>Application</name>
+    <displayname>Application: Cavity 2D</displayname>
+    <enabled>true</enabled>
+    <key>
+      <name>Name</name>
+      <enabled>true</enabled>
+      <type>text</type>
+      <default>cavity2d</default>
+      <info>Name of the application</info>
+    </key>
+    <key>
+      <name>dim</name>
+      <displayname>Dimension</displayname>
+      <enabled>true</enabled>
+      <type>spinbox</type>
+      <default>2</default>
+      <min>2</min>
+      <max>2</max>
+      <info>Dimension of the domain</info>
+    </key>
+    <key>
+      <name>OlbDir</name>
+      <enabled>true</enabled>
+      <type>file</type>
+      <default>../../</default>
+      <info>Path to OpenLB directory</info>
+    </key>
+    <block>
+      <name>DiscParam</name>
+      <displayname>Discretization Parameters</displayname>
+      <enabled>true</enabled>
+      <key>
+        <name>latticeL</name>
+        <displayname>Lattice Length [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>0.0078125</default>
+        <info>
+          Length of a lattice cell in meter (proportional to Knudsen number)
+          (*obligatory)
+        </info>
+      </key>
+      <key>
+        <name>latticeU</name>
+        <displayname>Lattice Velocity</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>0.1</default>
+        <info>
+          Dimensionless lattice velocity (proportional to Mach number)
+        </info>
+      </key>
+    </block>
+    <block>
+      <name>PhysParam</name>
+      <displayname>Physical Parameters</displayname>
+      <enabled>true</enabled>
+      <key>
+        <name>MaxTime</name>
+        <displayname>MaxTime [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>15</default>
+        <info>
+          Maximal simulation time in seconds
+        </info>
+      </key>
+      <key>
+        <name>charL</name>
+        <displayname>Characteristical Length [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>1</default>
+        <info>Characteristical length in meter</info>
+      </key>
+      <key>
+        <name>charU</name>
+        <displayname>Characteristical Velocity [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>1</default>
+        <info>Characteristical speed in m/s</info>
+      </key>
+      <key>
+        <name>viscosityType</name>
+        <displayname>Describe viscosity by</displayname>
+        <enabled>true</enabled>
+        <type>combobox</type>
+        <defaultlist>
+          <item>Kinematic viscosity</item>
+          <item>Reynolds-Number</item>
+        </defaultlist>
+        <default>Kinematic viscosity</default>
+        <dep>
+          <value>Kinematic viscosity</value>
+          <target>
+            <targetblock>Application</targetblock>
+            <targetblock>PhysParam</targetblock>
+            <targetkey>charNu</targetkey>
+            <action>
+              <enablekey>true</enablekey>
+            </action>
+          </target>
+          <target>
+            <targetblock>Application</targetblock>
+            <targetblock>PhysParam</targetblock>
+            <targetkey>Re</targetkey>
+            <action>
+              <enablekey>false</enablekey>
+            </action>
+          </target>
+        </dep>
+        <dep>
+          <value>Reynolds-Number</value>
+          <target>
+            <targetblock>Application</targetblock>
+            <targetblock>PhysParam</targetblock>
+            <targetkey>Re</targetkey>
+            <action>
+              <enablekey>true</enablekey>
+            </action>
+          </target>
+          <target>
+            <targetblock>Application</targetblock>
+            <targetblock>PhysParam</targetblock>
+            <targetkey>charNu</targetkey>
+            <action>
+              <enablekey>false</enablekey>
+            </action>
+          </target>
+        </dep>
+        <info>Choose, whether you want to specify either characteristical kinematic viscosity or Reynolds-Number.</info>
+      </key>
+      <key>
+        <name>charNu</name>
+        <displayname>Characteristical Viscosity [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>0.001</default>
+        <info>
+          Kinematic viscosity in m^2/s
+        </info>
+      </key>
+      <key>
+        <name>Re</name>
+        <displayname>Reynolds-Number</displayname>
+        <enabled>false</enabled>
+        <type>decimal</type>
+        <default>100</default>
+        <info>
+          Reynolds number
+        </info>
+      </key>
+      <key>
+        <name>charRho</name>
+        <displayname>Characteristical Density [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>1</default>
+        <info>
+          Density factor rho in kg/m^d. As average latticeRho is always around 1, specify the average physical density here.
+          At some point latticeRho can be multplied by this factor to get the local physical density.
+        </info>
+      </key>
+      <key>
+        <name>charPressure</name>
+        <displayname>Characteristical Pressure [Si]</displayname>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>0</default>
+        <info>
+          This additive pressure constant in Pa is added to the relative pressure result of the computation
+          to get the absolute value.
+        </info>
+      </key>
+    </block>
+  </block>
+  <block>
+    <name>Output</name>
+    <displayname>Output Settings</displayname>
+    <enabled>true</enabled>
+    <key>
+      <name>OutputDir</name>
+      <enabled>true</enabled>
+      <type>file</type>
+      <default>./tmp/</default>
+      <info>Directory for output data</info>
+    </key>
+    <key>
+      <name>MultiOutput</name>
+      <displayname>Multi-Output Mode</displayname>
+      <enabled>true</enabled>
+      <type>checkbox</type>
+      <default>false</default>
+      <info>Chooses whether output will be activated per program (false) or per mpi process (true)</info>
+    </key>
+    <block>
+      <name>Log</name>
+      <displayname>Logging</displayname>
+      <enabled>true</enabled>
+      <key>
+        <name>Filename</name>
+        <enabled>true</enabled>
+        <type>file</type>
+        <default>cavity2d.log</default>
+        <info>Converter information will be stored in this file.</info>
+      </key>
+      <key>
+        <name>SaveTime</name>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>0.1</default>
+        <info>Time intervall for console output</info>
+      </key>
+    </block>
+    <block>
+      <name>VisualizationVTK</name>
+      <enabled>true</enabled>
+      <key>
+        <name>Filename</name>
+        <enabled>true</enabled>
+        <type>file</type>
+        <default>cavity2dvtk</default>
+        <info>No info</info>
+      </key>
+      <key>
+        <name>SaveTime</name>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>1</default>
+        <info>No info</info>
+      </key>
+    </block>
+    <block>
+      <name>VisualizationImages</name>
+      <enabled>true</enabled>
+      <key>
+        <name>Filename</name>
+        <enabled>true</enabled>
+        <type>file</type>
+        <default>cavity2dimage</default>
+        <info>No info</info>
+      </key>
+      <key>
+        <name>SaveTime</name>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>1</default>
+        <info>No info</info>
+      </key>
+    </block>
+    <block>
+      <name>Timer</name>
+      <enabled>true</enabled>
+      <key>
+        <name>PrintMode</name>
+        <displayname>Mode of Output</displayname>
+        <enabled>true</enabled>
+        <type>combobox</type>
+        <defaultlist>
+          <item value="0">csv-style</item>
+          <item value="1">one-line</item>
+          <item value="2">two-line-layout</item>
+        </defaultlist>
+        <default>0</default>
+        <info>Displays timer informations about current calculation with different output modes.</info>
+      </key>
+      <key>
+        <name>SkipType</name>
+        <displayname>Skip output by</displayname>
+        <enabled>true</enabled>
+        <type>combobox</type>
+        <defaultlist>
+          <item value="0">Physical time</item>
+          <item value="1">Time steps</item>
+        </defaultlist>
+        <default>0</default>
+        <dep>
+          <value>0</value>
+          <target>
+            <targetblock>Output</targetblock>
+            <targetblock>Timer</targetblock>
+            <targetkey>PhysTime</targetkey>
+            <action>
+              <enablekey>true</enablekey>
+            </action>
+          </target>
+          <target>
+            <targetblock>Output</targetblock>
+            <targetblock>Timer</targetblock>
+            <targetkey>TimeSteps</targetkey>
+            <action>
+              <enablekey>false</enablekey>
+            </action>
+          </target>
+        </dep>
+        <dep>
+          <value>1</value>
+          <target>
+            <targetblock>Output</targetblock>
+            <targetblock>Timer</targetblock>
+            <targetkey>PhysTime</targetkey>
+            <action>
+              <enablekey>false</enablekey>
+            </action>
+          </target>
+          <target>
+            <targetblock>Output</targetblock>
+            <targetblock>Timer</targetblock>
+            <targetkey>TimeSteps</targetkey>
+            <action>
+              <enablekey>true</enablekey>
+            </action>
+          </target>
+        </dep>
+        <info>Choose, whether timer information should displayed either by physical or computational time steps.</info>
+      </key>
+      <key>
+        <name>PhysTime</name>
+        <enabled>true</enabled>
+        <type>decimal</type>
+        <default>.1</default>
+        <info>No info</info>
+      </key>
+      <key>
+        <name>TimeSteps</name>
+        <enabled>false</enabled>
+        <type>text</type>
+        <default>128</default>
+        <info>1 will print every step, 2 each second, etc.</info>
+      </key>
+      <key>
+        <name>PrintSummary</name>
+        <enabled>true</enabled>
+        <type>checkbox</type>
+        <default>true</default>
+        <info>Determines whether a summary after calculation should be displayed or not.</info>
+      </key>
+    </block>
+  </block>
+</description>
diff --git a/examples/laminar/cavity2d/sequential/module.mk b/examples/laminar/cavity2d/sequential/module.mk
new file mode 100644
index 0000000..1190482
--- /dev/null
+++ b/examples/laminar/cavity2d/sequential/module.mk
@@ -0,0 +1,29 @@
+#  This file is part of the OpenLB library
+#
+#  Copyright (C) 2017 Markus Mohrhard
+#  E-mail contact: info@openlb.net
+#  The most recent release of OpenLB can be downloaded at
+#  <http://www.openlb.net/>
+#
+#  This program 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.
+#
+#  This program is distributed in the hope that it will be useful,
+#  but WITHOUT ANY WARRANTY; without even the implied warranty of
+#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#  GNU General Public License for more details.
+#
+#  You should have received a copy of the GNU General Public
+#  License along with this program; if not, write to the Free
+#  Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+#  Boston, MA  02110-1301, USA.
+
+current_dir := $(dir $(word $(words $(MAKEFILE_LIST)),$(MAKEFILE_LIST)))
+
+include global.mk
+include rules.mk
+include $(addsuffix definitions.mk, $(current_dir))
+
+$(eval $(call sample,$(current_dir)$(OUTPUT),$(addprefix $(current_dir), $(SRC))))