3. Testing OpenFAST

The OpenFAST test suite consists of glue code and module level regression tests and unit tests. The regression tests compare locally generated solutions to a set of baseline solutions. The unit tests ensure that individual subroutines are functioning as intended.

All of the necessary files corresponding to the regression tests are contained in the reg_tests directory. The unit test framework is housed in unit_tests while the actual tests are contained in the directory corresponding to the tested module.

3.1. Configuring the test suite

Portions of the test suite are linked to the OpenFAST repository through a git submodule. Specifically,


Be sure to clone the repo with the --recursive flag or execute git submodule update --init --recursive after cloning.

The test suite can be configured with CMake similar to OpenFAST. The default CMake configuration is suitable for most systems, but may need customization for particular build environments. See the Understanding CMake section for more details on configuring the CMake targets. While the unit tests must be built with CMake due to its external dependencies, the regression test may be executed without CMake.

3.2. Test specific documentation

3.3. Continuous integration

A TravisCI configuration file is included with the OpenFAST source code at openfast/.travis.yml. The continuous integration infrastructure is still under development, but the status for all branches and pull requests can be found on the TravisCI OpenFAST page.

For development and testing purposes, a version of the TravisCI test can be run locally with Docker. The code snippet below outlines starting a TravisCI image on Docker.

# Running a travis ci image on docker locally

# Run this on your local machine's command line
docker run --name $BUILDID -dit $INSTANCE /sbin/init
docker exec -it $BUILDID bash -l

# Now you're inside your docker image
sudo apt-get update
sudo apt-get install python3-pip
sudo -E apt-get -yq --no-install-suggests --no-install-recommends install gfortran libblas-dev liblapack-dev
git clone --depth=50 https://github.com/OpenFAST/openfast.git OpenFAST/openfast
cd OpenFAST/openfast

# Modify this line for the commit or pull request to build
git fetch origin +refs/pull/203/merge:

git checkout -qf FETCH_HEAD
git submodule update --init --recursive

export FC=/usr/bin/gfortran-7
export CC=gcc
gcc --version
pyenv shell 3.6.3

source ~/.bashrc
pip3 install numpy
mkdir build && cd build
make -j 8 install