Fluidity is an open source, general purpose, multi-phase computational fluid dynamics code capable of numerically solving the Navier-Stokes equation and accompanying field equations on arbitrary unstructured finite element meshes in one, two and three dimensions. It is used in a number of different scientific areas including geophysical fluid dynamics, computational fluid dynamics, ocean modelling and mantle convection. It uses a finite element/control volume method which allows arbitrary movement of the mesh with time dependent problems, allowing mesh resolution to increase or decrease locally according to the current simulated state. It has a wide range of element choices including mixed formulations. Fluidity is parallelised using MPI and is capable of scaling to many thousands of processors on the UK national HPC service, HECToR. Other innovative and novel features are a user-friendly GUI and a python interface which can be used to calculate diagnostic fields, set prescribed fields or set user-defined boundary conditions.
Please note that the fluidity-18.104.22.168 archive should be expanded first, and that fluidity-tests-22.214.171.124 should be expanded into the directory created by fluidity-126.96.36.199, populating the tests/ directory.
For full instructions on unpacking and building fluidity, see the manual.
Fluidity is available as a community-supported development code and may be downloaded using bazaar (bzr) over http. Non-development users are encouraged to download the most recent release version from the 4.1 series, using:
bzr co lp:fluidity/4.1
Developers with read/write access via a Launchpad account registered with the fluidity-core group can download the latest bleeding-edge version from:
bzr co lp:fluidity
The latest version of Fluidity is available as pre-built binaries on HECToR.
Local workstation install
We also have a quick start guide for Ubuntu and Debian-based systems to get you started.
On other systems, a list of dependencies is available, which must be installed first.
Uses and Examples
Examples and Tests
Fluidity is distributed with a number of example scenarios ranging from simple 1D advection problems to full, 3D, adaptive, parallel simulations. These form part of AMCG's user training programme and are a useful aid to learning how to use Fluidity.
In addition, an extensive test suite is provided which ranges from short, simple tests to full simulations which can be used as the basis for setting up new simulations.
Available online here. This version is aimed at users on Fluidity release version 4.1.
An up to date manual is also available in the manual/ subdirectory of the fluidity trunk on launchpad as LaTeX source.
This contains walkthrough examples of how to use Fluidity
A number of pages aimed at developers of fluidity
Fluidity Training Sessions
Fluidity training sessions are run once a year, or on significant demand. To register your interest, contact Dr.Matthew Piggott.
Slides and details of the 2012 Fluidity Training session can be found here
The usual structure of the 3-day Fluidity training event:
Day 1: Finite Element Method in Fluidity
There is a mailing list which all users and developers of Fluidity are highly encouraged to subscribe to, at:
Use of the list to ask questions about installing and running Fluidity is actively encouraged, and support will be given by developers and other users on a best-effort basis. The list will also be used to disseminate important information about releases, upcoming changes to Fluidity, and important events within the Fluidity community. AMCG also has an IRC channel, details of which can be found here.