Framework for studying fluid dynamics.
Project description
- alt:
Heptapod CI
FluidDyn project is an ecosystem of packages for research and teaching in fluid dynamics. The Python package fluiddyn contains:
basic utilities to manage: File I/O for some esoteric formats, publication quality figures, job submission on clusters, MPI
powerful classes to handle: parameters, arrays, series of files
simplified interfaces to calculate: FFT, spherical harmonics
and much more. It is used as a library in the other specialized packages of the FluidDyn project (in particular in fluidfft, fluidsim, fluidlab and fluidimage).
Documentation: https://fluiddyn.readthedocs.io
Getting started
Installation
The simplest way to install fluiddyn is by using pip:
pip install fluiddyn
You can also get the source code from https://foss.heptapod.net/fluiddyn/fluiddyn or from the Python Package Index. The development mode is often useful if you intend to modify fluiddyn. From the root directory:
pip install -e .[dev]
Requirements
Minimum |
Python (>=3.6), numpy matplotlib h5py psutil |
Full functionality |
h5py h5netcdf pillow imageio mpi4py scipy pyfftw (requires FFTW library), SHTns |
Optional |
OpenCV with Python bindings, scikit-image |
Note: Detailed instructions to install the above dependencies using Anaconda / Miniconda or in a specific operating system such as Ubuntu, macOS etc. can be found here.
Tests
With an editable installation, you can run the tests with:
pytest
Metapaper and citation
If you use any of the FluidDyn packages to produce scientific articles, please cite our metapaper presenting the FluidDyn project and the fluiddyn package:
@article{fluiddyn,
doi = {10.5334/jors.237},
year = {2019},
publisher = {Ubiquity Press, Ltd.},
volume = {7},
author = {Pierre Augier and Ashwin Vishnu Mohanan and Cyrille Bonamy},
title = {{FluidDyn}: A Python Open-Source Framework for Research and Teaching in Fluid Dynamics
by Simulations, Experiments and Data Processing},
journal = {Journal of Open Research Software}
}
History
The FluidDyn project started in 2015 as the evolution of two packages previously developed by Pierre Augier (CNRS researcher at LEGI, Grenoble): solveq2d (a numerical code to solve fluid equations in a periodic two-dimensional space with a pseudo-spectral method, developed at KTH, Stockholm) and fluidlab (a toolkit to do experiments, developed in the G. K. Batchelor Fluid Dynamics Laboratory at DAMTP, University of Cambridge).
Keywords and ambitions: fluid dynamics research with Python (>= 3.6), modular, object-oriented, collaborative, tested and documented, free and open-source software.
License
FluidDyn is distributed under the CeCILL-B License, a BSD compatible french license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.