/amr-wind

AMReX-based structured wind solver

Primary LanguageC++OtherNOASSERTION

AMR-Wind

Website | User manual | API docs | Nightly test dashboard

Powered by AMReX Build Status

AMR-Wind is a massively parallel, block-structured adaptive-mesh, incompressible flow solver for wind turbine and wind farm simulations. The codebase is a wind-focused fork of incflo. The solver is built on top of the AMReX library. AMReX library provides the mesh data structures, mesh adaptivity, as well as the linear solvers used for solving the governing equations. AMR-Wind is actively developed and maintained by a dedicated multi-institutional team from Lawrence Berkeley National Laboratory, National Renewable Energy Laboratory, and Sandia National Laboratories.

The primary applications for AMR-Wind are: performing large-eddy simulations (LES) of atmospheric boundary layer (ABL) flows, simulating wind farm turbine-wake interactions using actuator disk or actuator line models for turbines, and as a background solver when coupled with a near-body solver (e.g., Nalu-Wind) with overset methodology to perform blade-resolved simulations of multiple wind turbines within a wind farm. For offshore applications, the ability to model the air-sea interaction effects and its impact on the ABL characteristics is another focus for the code development effort. As with other codes in the Exawind ecosystem, AMR-wind shares the following objectives:

  • an open, well-documented implementation of the state-of-the-art computational models for modeling wind farm flow physics at various fidelities that are backed by a comprehensive verification and validation (V&V) process;

  • be capable of performing the highest-fidelity simulations of flowfields within wind farms; and

  • be able to leverage the high-performance leadership class computating facilities available at DOE national laboratories.

Documentation

Documentation is organized into a user manual and a developer-focused API documentation. You can either browse the docs online by following the links, or you can generate them locally after downloading the code. Please follow the instructions in user manual to build documentation locally.

Compilation and usage

AMR-Wind is built upon the AMReX library. A snapshot of the AMReX library is distributed along with the AMR-Wind source code as a git-submodule. In addition to the AMReX library, you will require a modern C++ compiler that supports the C++17 standard. Users wishing to execute the code on high-performance computing (HPC) systems will also need MPI libraries installed on their system. The code can also be compiled using MPI+X, where X can be OpenMP for CPU shared memory parallelism, CUDA to target NVIDIA GPUs, HIP for AMD GPUs, or DPC++ for Intel GPUs.

Contributing, reporting bugs, and requesting help

To report issues or bugs please create a new issue on GitHub.

We welcome contributions from the community in form of bug fixes, feature enhancements, documentation updates, etc. All contributions are processed through pull-requests on GitHub.

License

AMR-Wind is licensed under BSD 3-clause license. Please see the LICENSE included in the source code repository for more details.