WEIS, Wind Energy with Integrated Servo-control, performs multifidelity co-design of wind turbines. WEIS is a framework that combines multiple NREL-developed tools to enable design optimization of floating offshore wind turbines.
Author: NREL WISDEM & OpenFAST & Control Teams
This software is a version 0.0.1.
See local documentation in the
docs-directory or access the online version at https://weis.readthedocs.io/en/latest/
WEIS integrates in a unique workflow four models:
- WISDEM is a set of models for assessing overall wind plant cost of energy (COE).
- OpenFAST is the community model for wind turbine simulation to be developed and used by research laboratories, academia, and industry.
- TurbSim is a stochastic, full-field, turbulent-wind simulator.
- ROSCO provides an open, modular and fully adaptable baseline wind turbine controller to the scientific community.
In addition, three external libraries are added:
- pCrunch is a collection of tools to ease the process of parsing large amounts of OpenFAST output data and conduct loads analysis.
- pyOptSparse is a framework for formulating and efficiently solving nonlinear constrained optimization problems.
Software Model Versions:
The core WEIS modules are:
- aeroelasticse is a wrapper to call OpenFAST
- control contains the routines calling the ROSCO_Toolbox and the routines supporting distributed aerodynamic control devices, such trailing edge flaps
- gluecode contains the scripts glueing together all models and libraries
- multifidelity contains the codes to run multifidelity design optimizations
- optimization_drivers contains various optimization drivers
- schema contains the YAML files and corresponding schemas representing the input files to WEIS
On laptop and personal computers, installation with Anaconda is the recommended approach because of the ability to create self-contained environments suitable for testing and analysis. WEIS requires Anaconda 64-bit. WEIS is currently supported on Linux, MAC and Windows Sub-system for Linux (WSL). Installing WEIS on native Windows is not supported.
The installation instructions below use the environment name, "weis-env," but any name is acceptable. For those working behind company firewalls, you may have to change the conda authentication with
conda config --set ssl_verify no. Proxy servers can also be set with
conda config --set proxy_servers.http http://id:pw@address:port and
conda config --set proxy_servers.https https://id:pw@address:port.
On the DOE HPC system eagle, make sure to start from a clean setup and type
module purge module load conda
Setup and activate the Anaconda environment from a prompt (WSL terminal on Windows or Terminal.app on Mac)
conda env create --name weis-env -f https://raw.githubusercontent.com/WISDEM/WEIS/main/environment.yml python=3.9 conda activate weis-env # (if this does not work, try source activate weis-env) sudo apt update # (WSL only, assuming Ubuntu)
Use conda to add platform specific dependencies.
conda config --add channels conda-forge conda install -y petsc4py mpi4py # (Mac / Linux only) conda install -y compilers # (Mac only) sudo apt install gcc g++ gfortran libblas-dev liblapack-dev -y # (WSL only, assuming Ubuntu)
Clone the repository and install the software
git clone https://github.com/WISDEM/WEIS.git cd WEIS git checkout branch_name # (Only if you want to switch branches, say "develop") python setup.py develop # (The common "pip install -e ." will not work here)
Instructions specific for DOE HPC system Eagle. Before executing the setup script, do:
module load comp-intel intel-mpi mkl module unload gcc python setup.py develop
NOTE: To use WEIS again after installation is complete, you will always need to activate the conda environment first with
conda activate weis-env (or
source activate weis-env). On Eagle, make sure to reload the necessary modules
If you plan to contribute code to WEIS, please first consult the developer guide.
For software issues please use https://github.com/WISDEM/WEIS/issues.