Introduction

The Wind Energy Toolbox (or wetb, pronounce as wee-tee-bee) is a collection of Python scripts that facilitate working with (potentially a lot) of HAWC2, HAWCStab2, FAST or other text input based simulation tools.

Note that this toolbox is very much a WIP (work in progress). For example, some of the functions in the prepost module have a similar functions in Hawc2io. These different implementations will be merged in due time.

Both Python2 and Python3 are supported.

Installation

See documentation.

Documentation

https://toolbox.pages.windenergy.dtu.dk/WindEnergyToolbox/

Contents of WindEnergyToolbox, wetb

Overview

• hawc2
• gtsdf
• fatigue_tools
• wind
• dlc
• prepost
• fast
• utils

hawc2

• Hawc2io: Read binary, ascii and flex result files
• sel_file: Read/write *.sel (sensor list) files
• htc_file: Read/write/manipulate htc files
• ae_file: Read/write/manipulate AE (aerodynamic blade layout) files
• pc_file: Read/write/manipulate PC (profile coefficient) files
• st_file: Read/write/manipulate ST (structural properties) files
• shear_file: Create user defined shear file
• at_time_file: Read at output_at_time files
• log_file: Read and interpret log files
• ascii2bin: Compress HAWC2 ascii result files to binary

gtsdf

General Time Series Data Format, a binary hdf5 data format for storing time series data.

• gtsdf: read/write/append gtsdf files
• unix_time: convert between datetime and unix time (seconds since 1/1/1970)

fatigue_tools

• fatigue: Rainflow counting, cycle matrix and equivalent loads
• bearing_damage: Calculate a comparable measure of bearing damage

wind

• shear: Calculate and fit wind shear

dlc

Module for working with "Design load cases" (Code independent)

• high_level Class for working with the highlevel dlc excell sheet

prepost

Module for creating an arbitrary number of HAWC2 simulations, and optionally corresponding execution scripts for a PBS Torque cluster (Linux), simple bash (Linux), or Windows batch scripts. A post-processing module is also included that calculates statistical parameters, performs rainflow counting for fatigue load calculations, and create load envelopes.

Additional documentation can be found here:

• Getting started with DLBs
  • Generate DLB spreadsheets
  • Auto-generation of Design Load Cases
  • House rules for storing results on mimer/hawc2sim
  • How to use the Statistics DataFrame

fast

Tools for working with NREL's FAST code (An aeroelastic computer-aided engineering (CAE) tool for horizontal axis wind turbines)

• fast_io: Read binary and ascii result files

utils

Other functions

• geometry: Different kind of geometry conversion functions
• process_exec: Run system command in subprocess
• timing: Decorators for evaluating execution time of functions
• caching: Decorators to create cached (calculate once) functions and properties