Skip to main content

Framework for studying fluid dynamics.

Project description

alt:Travis CI status

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

To try fluiddyn without installation: Binder notebook

Installation

The simplest way to install fluiddyn is by using pip:

pip install fluiddyn [--user]

Add --user flag if you are installing without setting up a virtual environment.

You can also get the source code from Bitbucket or from the Python Package Index. It is recommended to install numpy before installing fluiddyn. The development mode is often useful if you intend to modify fluiddyn. From the root directory:

python setup.py develop

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

From the root directory:

make tests

Or, from the root directory or any of the “test” directories:

python -m unittest discover

Citing

If you need to cite a FluidDyn paper, feel free to use: https://arxiv.org/abs/1807.09224

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fluiddyn, version 0.3.1
Filename, size File type Python version Upload date Hashes
Filename, size fluiddyn-0.3.1-py2.py3-none-any.whl (142.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size fluiddyn-0.3.1.tar.gz (173.5 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page