/FourierFlows.jl

Tools for building fast, hackable, pseudospectral partial differential equation solvers on periodic domains

Primary LanguageJuliaMIT LicenseMIT

FourierFlows.jl

Buildkite CPU+GPU build status Build Status for Windows stable docs latest docs ColPrac: Contributor's Guide on Collaborative Practices for Community Packages doi

Overview

This software provides tools for partial differential equations on periodic domains using Fourier-based pseudospectral methods. A central intent of the software's design is also to provide a framework for writing new, fast solvers for new physical problems. The code is written in Julia.

For more details refer to the documentation.

Installation

To install, use Julia's built-in package manager to add the package and also to instantiate/build all the required dependencies

julia> using Pkg
julia> Pkg.add("FourierFlows")
julia> Pkg.instantiate()

The most recent version of FourierFlows.jl requires Julia v1.6 (the current long-term-release) or later.

Last version that works with Julia v1.5 is FourierFlows.jl v0.7.2.

Usage

See the documentation for tutorials on (i) how construct grids and use Fourier transform to compute derivatives and (ii) how to set up a PDE, time-step it forward, and visualize the output, (iii) how to add diagnostics, and (iv) how to write and read output from disk.

Scalability

For now, FourierFlows.jl is restricted to run on either a single CPU or single GPU. Multi-threading can enhance performance for the Fourier transforms. By default, FourierFlows.jl will use the maximum number of threads available on your machine. You can set the number of threads used by FourierFlows.jl by setting the environment variable, e.g.,

$ export JULIA_NUM_THREADS=4

For more information on multi-threading users are directed to the Julia Documentation.

If your machine has more than one GPU available, then functionality within CUDA.jl package enables the user to choose the GPU device that FourierFlows.jl should use. The user is referred to the CUDA.jl Documentation; in particular, CUDA.devices and CUDA.CuDevice.

Example(s)

An example for coding up and solving the linear shallow water equations is documented.

See also the child packages GeophysicalFlows.jl for example usage of FourierFlows.jl for problems in Geophysical Fluid Dynamics.

Getting help

Interested in using FourierFlows.jl or trying to figure out how to use it? Please feel free to ask us questions and get in touch! The documentation is always the best place to start. Check out the examples and open an issue or start a discussion if you have any questions, comments, suggestions, etc.

Developers

FourierFlows is currently being developed by Gregory L. Wagner (@glwagner) and Navid C. Constantinou (@navidcy).

Citing

The code is citable via zenodo. Please cite as:

Gregory L. Wagner, Navid C. Constantinou, and contributors. (2022). FourierFlows/FourierFlows.jl: FourierFlows v0.10.1 (Version v0.10.1). Zenodo. http://doi.org/10.5281/zenodo.1161724

Contributing

We are excited to get more people involved in contributing to the development of FourierFlows.jl! We welcome any contribution, no matter how big or small! It's always great to have new people look at the code with fresh eyes: you will see errors that other developers have missed.

Let us know by open an issue or start a discussion if you'd like to work on a new feature or implement a new module, if you're new to open-source and want to find a cool little project or issue to work on that fits your interests! We're more than happy to help along the way.

For more information, check out our contributor's guide.