Not sure what this newest black formatting is actually changing

Author: jmcvey3

mhkit/acoustics/__init__.py

@@ -1,17 +1,17 @@
 """
 The passive acoustics module provides a set of functions
-for analyzing and visualizing passive acoustic monitoring 
+for analyzing and visualizing passive acoustic monitoring
 data deployed in water bodies. This package reads in raw
-*.wav* files and conducts basic acoustics analysis and 
+*.wav* files and conducts basic acoustics analysis and
 visualization.
 
 To start using the module, import it directly from MHKiT:
 ``from mhkit import acoustics``. The analysis functions
-are available directly from the main import, while the 
-I/O and graphics submodules are available from 
+are available directly from the main import, while the
+I/O and graphics submodules are available from
 ``acoustics.io`` and  ``acoustics.graphics``, respectively.
-The base functions are intended to be used on top of the I/O submodule, and 
-include functionality to calibrate data, create spectral densities, sound 
+The base functions are intended to be used on top of the I/O submodule, and
+include functionality to calibrate data, create spectral densities, sound
 pressure levels, and time or band aggregate spectral data.
 """
 

mhkit/acoustics/analysis.py

@@ -337,7 +337,7 @@ def sound_pressure_spectral_density_level(spsd: xr.DataArray) -> xr.DataArray:
 
 
 def _validate_method(
-    method: Union[str, Dict[str, Union[float, int]]]
+    method: Union[str, Dict[str, Union[float, int]]],
 ) -> Tuple[str, Optional[Union[float, int]]]:
     """
     Validates the 'method' parameter and returns the method name and its argument (if any)

mhkit/acoustics/graphics.py

@@ -1,6 +1,6 @@
 """
-This submodule provides essential plotting functions for visualizing passive acoustics 
-data. The functions allow for customizable plotting of sound pressure spectral density 
+This submodule provides essential plotting functions for visualizing passive acoustics
+data. The functions allow for customizable plotting of sound pressure spectral density
 levels across time and frequency dimensions.
 
 Each plotting function leverages the flexibility of Matplotlib, allowing for passthrough
@@ -11,12 +11,12 @@
 -------------
 1. **plot_spectrogram**:
 
-   - Generates a spectrogram plot from sound pressure spectral density level data, 
+   - Generates a spectrogram plot from sound pressure spectral density level data,
      with a logarithmic frequency scale by default for improved readability of acoustic data.
 
 2. **plot_spectra**:
 
-   - Produces a spectral density plot with a log-transformed x-axis, allowing for clear 
+   - Produces a spectral density plot with a log-transformed x-axis, allowing for clear
      visualization of spectral density across frequency bands.
 """
 

mhkit/acoustics/io.py

@@ -1,7 +1,7 @@
 """
 This submodule provides input/output functions for passive acoustics data,
 focusing on hydrophone recordings stored in WAV files. The main functionality
-includes reading and processing hydrophone data from various manufacturers 
+includes reading and processing hydrophone data from various manufacturers
 and exporting audio files for easy playback and analysis.
 
 Supported Hydrophone Models
@@ -14,28 +14,28 @@
 
 1. **Data Reading**:
 
-   - `read_hydrophone`: Main function to read a WAV file from a hydrophone and 
-     convert it to either a voltage or pressure time series, depending on the 
+   - `read_hydrophone`: Main function to read a WAV file from a hydrophone and
+     convert it to either a voltage or pressure time series, depending on the
      availability of sensitivity data.
 
-   - `read_soundtrap`: Wrapper for reading Ocean Instruments SoundTrap hydrophone 
+   - `read_soundtrap`: Wrapper for reading Ocean Instruments SoundTrap hydrophone
      files, automatically using appropriate metadata.
 
-   - `read_iclisten`: Wrapper for reading Ocean Sonics icListen hydrophone files, 
-     including metadata processing to apply hydrophone sensitivity for direct 
+   - `read_iclisten`: Wrapper for reading Ocean Sonics icListen hydrophone files,
+     including metadata processing to apply hydrophone sensitivity for direct
      sound pressure calculation.
 
 2. **Audio Export**:
 
-   - `export_audio`: Converts processed sound pressure data back into a WAV file 
+   - `export_audio`: Converts processed sound pressure data back into a WAV file
      format, with optional gain adjustment to improve playback quality.
 
 3. **Data Extraction**:
 
-   - `_read_wav_metadata`: Extracts metadata from a WAV file, including bit depth 
+   - `_read_wav_metadata`: Extracts metadata from a WAV file, including bit depth
      and other header information.
 
-   - `_calculate_voltage_and_time`: Converts raw WAV data into voltage values and 
+   - `_calculate_voltage_and_time`: Converts raw WAV data into voltage values and
      generates a time index based on the sampling frequency.
 """
 

mhkit/dolfyn/adv/clean.py

@@ -1,5 +1,4 @@
-"""Module containing functions to clean data
-"""
+"""Module containing functions to clean data"""
 
 import warnings
 import numpy as np

mhkit/loads/__init__.py

@@ -1,7 +1,7 @@
 """
 The `loads` package of the MHKiT (Marine and Hydrokinetic Toolkit) library
 provides tools and functionalities for analyzing and visualizing loads data
-from marine and hydrokinetic (MHK) devices. This package is designed to 
+from marine and hydrokinetic (MHK) devices. This package is designed to
 assist engineers, researchers, and analysts in understanding the forces and
 stresses applied to MHK devices under various operational and environmental
 conditions.

mhkit/loads/extreme/__init__.py

@@ -3,7 +3,7 @@
 and wave data statistics.
 
 It includes methods for calculating peaks over threshold, estimating
-short-term extreme distributions,and performing wave amplitude 
+short-term extreme distributions,and performing wave amplitude
 normalization for most likely extreme response analysis.
 """
 

mhkit/loads/extreme/extremes.py

@@ -1,29 +1,29 @@
 """
 This module provides functionality for estimating the short-term and
-long-term extreme distributions of responses in a time series. It 
-includes methods for analyzing peaks, block maxima, and applying 
-statistical distributions to model extreme events. The module supports 
-various methods for short-term extreme estimation, including peaks 
-fitting with Weibull, tail fitting, peaks over threshold, and block 
-maxima methods with GEV (Generalized Extreme Value) and Gumbel 
-distributions. Additionally, it offers functionality to approximate 
-the long-term extreme distribution by weighting short-term extremes 
+long-term extreme distributions of responses in a time series. It
+includes methods for analyzing peaks, block maxima, and applying
+statistical distributions to model extreme events. The module supports
+various methods for short-term extreme estimation, including peaks
+fitting with Weibull, tail fitting, peaks over threshold, and block
+maxima methods with GEV (Generalized Extreme Value) and Gumbel
+distributions. Additionally, it offers functionality to approximate
+the long-term extreme distribution by weighting short-term extremes
 across different sea states.
 
 Functions:
-- ste_peaks: Estimates the short-term extreme distribution from peaks 
+- ste_peaks: Estimates the short-term extreme distribution from peaks
     distribution using specified statistical methods.
 - block_maxima: Finds the block maxima in a time-series data to be used
     in block maxima methods.
-- ste_block_maxima_gev: Approximates the short-term extreme distribution 
+- ste_block_maxima_gev: Approximates the short-term extreme distribution
     using the block maxima method with the GEV distribution.
-- ste_block_maxima_gumbel: Approximates the short-term extreme 
+- ste_block_maxima_gumbel: Approximates the short-term extreme
     distribution using the block maxima method with the Gumbel distribution.
-- ste: Alias for `short_term_extreme`, facilitating easier access to the 
+- ste: Alias for `short_term_extreme`, facilitating easier access to the
     primary functionality of estimating short-term extremes.
-- short_term_extreme: Core function to approximate the short-term extreme 
+- short_term_extreme: Core function to approximate the short-term extreme
     distribution from a time series using chosen methods.
-- full_seastate_long_term_extreme: Combines short-term extreme 
+- full_seastate_long_term_extreme: Combines short-term extreme
     distributions using weights to estimate the long-term extreme distribution.
 """
 

mhkit/loads/extreme/mler.py

@@ -1,16 +1,16 @@
 """
-This module provides functionalities to calculate and analyze Most 
+This module provides functionalities to calculate and analyze Most
 Likely Extreme Response (MLER) coefficients for wave energy converter
 design and risk assessment. It includes functions to:
 
   - Calculate MLER coefficients (`mler_coefficients`) from a sea state
     spectrum and a response Amplitude Response Operator (ARO).
   - Define and manipulate simulation parameters (`mler_simulation`) used
     across various MLER analyses.
-  - Renormalize the incoming amplitude of the MLER wave 
+  - Renormalize the incoming amplitude of the MLER wave
     (`mler_wave_amp_normalize`) to match the desired peak height for more
     accurate modeling and analysis.
-  - Export the wave amplitude time series (`mler_export_time_series`) 
+  - Export the wave amplitude time series (`mler_export_time_series`)
     based on the calculated MLER coefficients for further analysis or
     visualization.
 """

mhkit/loads/extreme/peaks.py

@@ -1,15 +1,15 @@
 """
 This module provides utilities for analyzing wave data, specifically
 for identifying significant wave heights and estimating wave peak
-distributions using statistical methods. 
+distributions using statistical methods.
 
 Functions:
-- _calculate_window_size: Calculates the window size for peak 
+- _calculate_window_size: Calculates the window size for peak
   independence using the auto-correlation function of wave peaks.
-- _peaks_over_threshold: Identifies peaks over a specified 
+- _peaks_over_threshold: Identifies peaks over a specified
   threshold and returns independent storm peak values adjusted by
   the threshold.
-- global_peaks: Identifies global peaks in a zero-centered 
+- global_peaks: Identifies global peaks in a zero-centered
   response time-series based on consecutive zero up-crossings.
 - number_of_short_term_peaks: Estimates the number of peaks within a
  specified short-term period.
@@ -20,13 +20,13 @@
 - automatic_hs_threshold: Determines the best significant wave height
  threshold for the peaks-over-threshold method.
 - peaks_distribution_peaks_over_threshold: Estimates the peaks
- distribution using the peaks over threshold method by fitting a 
+ distribution using the peaks over threshold method by fitting a
  generalized Pareto distribution.
 
 References:
-- Neary, V. S., S. Ahn, B. E. Seng, M. N. Allahdadi, T. Wang, Z. Yang, 
- and R. He (2020). "Characterization of Extreme Wave Conditions for 
- Wave Energy Converter Design and Project Risk Assessment.” J. Mar. 
+- Neary, V. S., S. Ahn, B. E. Seng, M. N. Allahdadi, T. Wang, Z. Yang,
+ and R. He (2020). "Characterization of Extreme Wave Conditions for
+ Wave Energy Converter Design and Project Risk Assessment.” J. Mar.
  Sci. Eng. 2020, 8(4), 289; https://doi.org/10.3390/jmse8040289.
 
 """