MHKiT logo

Overview

MHKiT is open-source software, developed in Python and MATLAB, that provides the international marine renewable energy (MRE) community with tools for:

  • Data processing

  • Data visualization

  • Data quality control

  • Resource assessment

  • Device performance

  • Device loads

The software is developed for MRE data, including measurements from field and laboratory environments, and datasets produced by numerical simulations (e.g. WEC-Sim). MHKiT is intended to supplement analysis using functions readily available within software languages (e.g MATLAB, Python) and public repositories (e.g. WAFO, Pecos) by providing functions that are needed by the MRE community and that is not otherwise available. Calculations in MHKiT adhere to the International Electrotechnical Committee’s Technical Committee’s, IEC TC 114 technical specifications (TS) and recommendations, as well as follow best practices within the MRE and other fields.

MHKiT Modules

MHKiT-Python and MHKiT-MATLAB are organized into the following modules:

  • QC Module: Perform quality control analysis

  • Wave Module: Calculate quantities of interest for wave energy converters (WEC)

  • River Module: Calculate quantities of interest for river energy converters (REC)

  • Tidal Module: Calculate quantities of interest for tidal energy converters (TEC)

  • Power Module: Calculate quantities of interest for power production and power quality

  • Loads Module: Calculate quantities of interest for mechanical loads assessments

  • Utils Module: Includes helper functions

These modules provide functionality for calculating metrics needed by the MRE community as well as those required for conformity with IEC TS and recommendations. MHKiT was intentionally divided into modules that map directly to each IEC TS, such as power performance, resource assessment and characterization, and mechanical load measurements, for ease of use. Each module contains a set of functions that have been rigorously tested and well documented.

To ensure consistent results between MHKiT-Python and MHKiT-MATLAB and reduce version control issues, all functions are written in Python and housed in the MHKiT-Python repository. MHKiT-MATLAB then wraps these functions so they can be called from MATLAB. As such, MHKiT-Python and MHKiT-MATLAB provide identical functions in each language.

MHKiT-Python is rigorously tested using a continuous integration framework that is applied every time changes are made to the repository. These tests check functionality and accuracy. MHKiT-MATLAB is tested by the core development team to ensure that the wrapped MHKiT-Python functions are performing as expected.

MHKiT-Python Python logo

MHKiT-Python is intended to be used by researchers and practitioners who prefer Python. MHKiT-Python uses Pandas data objects to store data with labeled columns and rows. This allows the user to keep track of timestamp indexes and the type of data that is in each column. Pandas includes many options to analyze data, including methods to slice, query, upscale, and plot data. Additionally, Pandas includes many options to load data from a wide range of formats into Pandas data objects. MHKiT-Python users that are new to Pandas are encouraged to review the Pandas getting started guide.

The MHKiT-Python repository is located at: https://github.com/MHKiT-Software/MHKiT-Python.

MHKiT-MATLAB MATLAB logo

MHKiT-MATLAB is intended to be used by researchers and practitioners that prefer MATLAB. To ensure consistency between MHKiT-MATLAB and MHKiT-Python, MHKiT-MATLAB runs the MHKiT-Python functions by wrapping them in MATLAB. Conversions to Python data types happen within the wrappers, allowing MATLAB users to deal with MATLAB data types only.

MHKiT-MATLAB uses structures to store data. A structure array is a data type that groups related data using data containers called fields. For more information about MATLAB structures, refer to the MATLAB structures documentation.

The MHKiT-MATLAB repository is located at: https://github.com/MHKiT-Software/MHKiT-MATLAB.