Skip to content

Conversation

@simmsa
Copy link
Contributor

@simmsa simmsa commented Sep 30, 2025

Version 1.0.0

Release Highlights

  • New acoustics, and mooring modules
  • Improvements to Wave, WDRT, and DOLFYN modules
  • New examples for acoustics, mooring, and WEC-sim, and improved examples for DOLFYN and wave modules
  • Multiple bug fixes and performance improvements

PR #174 - Acoustics Module

  • Authors: @hivanov-nrel
  • Reviewer: @simmsa
  • Addition of acoustics module:
    • Reading and standardization of of OceanSonics icListen and OceanInstruments Soundtrap hydrophone files
    • Implementation of numerical computation sections IEC 62600-40 "Acoustic characterization of marine energy converters" standard
    • Spectrogram data visualizations using plot_spectrogram
    • Sound exposure level calculations with auditory weighting functions for 5 groups of marine mammals
    • Complete example livescript in examples/acoustics_example.mlx

PR #176 - Wave Module Native MATLAB Implementation

  • Authors: @MShabara
  • Reviewer: @simmsa
  • Convert wave module functions to native MATLAB code:
    • wave/resource/standardize_wave_spectra_frequency.m:
    • wave/resource/frequency_moment.m:
    • wave/resource/energy_period.m:
    • wave/resource/significant_wave_height.m:
    • wave/resource/jonswap_spectrum.m:
    • wave/resource/pierson_moskowitz_spectrum.m:
    • wave/resource/surface_elevation.m:

PR #153 - Mooring Module

  • Author: @hivanov-nrel
  • Reviewer: @simmsa
  • Addition of the mooring module, which includes
    • Read in MoorDyn files into MATLAB
    • Function to calculate mooring line lay length
    • Functions to visualize mooring line dynamics in 2D or 3D.
    • Example LiveScript demonstrating the functionality of the mooring module

PR #173 - Dolfyn Turbulence Functionality

  • Author: @simmsa
  • Reviewer: @browniea
  • Addition of turbulence calculations for acoustic doppler instruments
    • Turbulence intensity, noise, and reynolds stress calculations
    • Updates to examples/adcp_example.mlx live script

PR #175 - WEC-Sim Power Performance Example

  • Author: @akeeste
  • Reviewer: @simmsa
  • Addition of examples/wecsim_example.mlx
    • Analysis of WEC-Sim output mat file using MHKiT
    • Leverage MHKiT wave module to calculate spectra and statistics on surface elevation

PR #170 - WDRT Final Tasks

  • Author: @hivanov-nrel
  • Reviewer: @simmsa
  • Expanded WDRT functionality by adding automatic_hs_threshold and return_year_value functions

PR #169 - Code Compatibility Improvements

Bug Fixes

hivanov-nrel and others added 30 commits December 18, 2024 20:11
Fixing:

```
Python Error: ImportError: DLL load failed while importing pyexpat: The operating system cannot run %1.
```
Fix Failing Tests:

* Unix/MacOS: 
  * Pin Ubuntu version to `ubuntu-22.04`
  * Explicitly set LD_PRELOAD environment variable
  * Skip Failing:
    * Ubuntu, python 3.10, matlab R2023a
  * All other matrix tests pass
* Windows:
  * Set PYBIND11_NO_ASSERT_GIL_HELD_INCREF_DECREF=1
    * Attempt to fix python call from MATLAB
  * Skip:
    * Python 3.10 R2023a
The get(0,'Format') calls were originally added to support debugging
printf statements (now removed). Since format only affects display
and not calculation precision, these commands are unnecessary for
the programmatic numerical comparisons performed by these methods.
…onversion

- Replace datestr() with string() for datetime formatting
- Replace datenum(datestr()) with direct datenum() conversion for performance
- Maintains same output formats while using modern MATLAB functions
…iles

- Remove unused datenum variables in QC_Test.m
- Replace datenum arithmetic with datetime operations and seconds() conversion
- Replace Unix epoch conversion with posixtime in River_TestIO.m
- Update plot_joint_probability_distribution.m to use colormap(CMaPType, 256)
- Update plot_rose.m to use colormap(CMaPType, 256)
- Update plot_matrix.m to use colormap(flipud(hot(256)))

This ensures consistent behavior across MATLAB versions and uses the modern
256-color standard instead of the legacy 64-color default.
simmsa and others added 26 commits September 28, 2025 20:15
WEC-Sim Power performance example
Feature: Add Dolfyn Turbulence Functionality
@simmsa simmsa requested a review from hivanov-nrel September 30, 2025 21:21
Copy link
Contributor

@hivanov-nrel hivanov-nrel left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

At a high level, looks good to me. In the future, we should figure out a solid method for keeping track of all the changes to make release note generation easier. I think we are good to merge assuming all the tests pass!

@simmsa
Copy link
Contributor Author

simmsa commented Sep 30, 2025

@hivanov-nrel, thank you for reviewing! Agreed on the release notes. It seems possible to create a template for each pull request. I can look into that.

@simmsa simmsa merged commit 3f0336e into master Sep 30, 2025
61 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants