Fluidity

From AMCGMedia

Jump to: navigation, search


Introduction

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.

Salt fingering on an adaptive mesh Grand Banks tsunami simulation Palaeo-hydrodynamics Density currents with rotation
Salt fingering on an adaptive mesh. Grand Banks tsunami simulation. Palaeo-hydrodynamics. Density currents with rotation.

Distribution

Source Archives

Fluidity can be obtained via Launchpad as source archives; the latest version is Fluidity 4.1.8.2.

Please note that the fluidity-4.1.8.2 archive should be expanded first, and that fluidity-tests-4.1.8.2 should be expanded into the directory created by fluidity-4.1.8.2, populating the tests/ directory.

For full instructions on unpacking and building fluidity, see the manual.

Bazaar

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

HECToR

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.

Documentation

Fluidity Manual

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.

Cook Book

This contains walkthrough examples of how to use Fluidity

Fluidity Developers' Cook Book

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
Day 2: Fluidity - Theory
Day 3: Fluidity - Hands on

Mailing list

There is a mailing list which all users and developers of Fluidity are highly encouraged to subscribe to, at:

https://mailman.ic.ac.uk/mailman/listinfo/fluidity

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.

This page was last modified on 12 December 2012, at 16:59. This page has been accessed 36,437 times.