Installation

Warning

The instructions in this page, after this warning box, will install the latest version of WEIS, which may not be the same version of WEIS used to develop scube. If the user is savvy enough to be able to update/adapt the scube scripts to the newer version of WEIS, use the instructions prvided in this page, after this warning box. If not, please use the following instructions:

  1. Install the version of WEIS provided in the shared folder

    1. Expand the WEIS zipped folder in a location of choice

    2. In a miniforge prompt, do the following:

      cd WEIS
conda env create --name weis-scube-env -f environment.yml
conda activate weis-scube-env
conda install -y mpi4py
pip install -e.
conda install openfast=4.0.4 openfast-io=4.0.2 rosco=2.9.7 moorpy=1.1.0 # This command realigns some of the dependencies to the version used when developing SCUBE

  2. Install the scube version provided in in the shared folder (See installation instruction from step 5 onward below)

Pre-requisites

Requires the installation of WEIS by NREL.

Info on how to install it can be found here.

It is recommended to use miniforge to create conda environments and install WEIS. Miniforge can be obtained here.

Note

In the following, it is assumed that you named the environment where SCUBE will be run weis-env.

Installation instructions

  1. Make sure to have the zip file “scube.zip” provided

  2. Expand the file in the desired place in your disk

  3. Open a conda command prompt (if you are using miniforge, use the Miniforge Prompt)

  4. Make sure to activate the conda environment you have created to run WEIS and SCUBE (e.g., weis-env)

conda activate weis-env

Note

If you do not remember what name you gave to the environment, you can run the following to list the names of all the environments

conda info --envs

  1. Navigate, within the command prompt, to the folder scube\dist

cd "path-to-scube\dist"

  1. Install the latest version of the SCUBE from the .whl file in that folder. For example, for SCUBE v1.0.0

pip install scube-1.0.0-py3-none-any.whl

This should install all the SCUBE scripts and all the required packages.

Note

If you have installed a previous version of SCUBE, make sure to uninstall that first with the command below, and then install the new version of SCUBE.

pip uninstall scube

Warning

The scube.zip file provided comes with the following folders:

  • scube\data\01_aeroelasticse

  • scube\data\ref_turbines

These have been copied from the WEIS package available at the time of the development of the scube package (before August 2025).

Depending on when you will be installing scube, these may be obsolete with respect to the version of OpenFAST, ROSCO, and other packages within the WEIS version installed by you, and may need to be updated. To avoid conflicts, after installing WEIS and scube, do the following:

  • copy the folder WEIS\examples\01_aeroelasticse into scube\data\01_aeroelasticse (overwriting),

  • copy the folder WEIS\examples\00_setup\ref_turbines into scube\data\ref_turbines.

Testing

After installation, you can run a quick check to verify the correct installation.

  1. Open a conda prompt (miniforge prompt, for example), navigate to the folder scube\tests

  2. Run the following command

python test_ALL.py

This runs a demonstration of a series of typical wind turbine analyses and writes results into the scube\tests\output folder. In the miniforge prompt command window, the following should appear (multiple times, once for each analysis).

N.B. Some WEIS “Warnings” may appear. They are not critical.

Running: test.py A03 L2
Output:
Using weis.aeroelasticse in rosco.toolbox...

 ******* SCUBE: preprocessing - updating tower geometry *******

 ******* SCUBE: postprocessing - results VS constraints analysis *******

         ******* Constraint definitions imported *******

         ******* Simulation output xlsx and yaml files data loaded *******

         ******* Constraint verification started *******

                 Check of constraint Min_twr_1st_fa_freq_L2

                 Check of constraint Min_twr_1st_ss_freq_L2

         ******* Constraint verification completed *******
               Constraint  ...                                      Description
0  Min_twr_1st_fa_freq_L2  ...   Min tower natural frequency, 1st fore-aft mode
1  Min_twr_1st_ss_freq_L2  ...  Min tower natural frequency, 1st side-side mode

[2 rows x 7 columns]

******* SCUBE: Validation report with formatting exported successfully *******

[INFO] Time taken: 0:00:03

  1. Check in the folder scube\tests\output the validation reports created (e.g., validation_report_A03_L2.xlsx).