Download LBHydra User Manual (Version 0.1)

CHAPTER 1
Introduction
This manual is a concise and self-contained guide to LBHydra, a software package for conducting lattice-Boltzmann fluid-mechanics simulations. It is primarily
targeted at an audience with a basic knowledge of lattice-Boltzmann models
and some experience with Matlab, Python or similar scientific programming environments. The more advanced capabilities of the package outlined in the later
chapters require an understanding of the C or C++ programming languages,
however, this will not be necessary for most users.
The manual has two main goals. First, it outlines the basic capabilities of
the LBHydra package, and provides the tools necessary to run new simulations
(Chapter 1 to Chapter 5). Second, it describes how to incorporate LBHydra’s
functionality into other programs, and extend the capabilities of the basic package
by introducing new types of lattice-Boltzmann simulations, models and lattices
(Chapter 6 to Chapter 8).
The remainder of the chapter gives a brief summary of the contents of the
manual, followed by instructions for installing LBHydra, and finishes with a
step-by-step quick-start guide for running the example simulations included in
the LBHydra package.
We hope you enjoy this manual.
1