NREL · RHammond2 · Aug 31, 2023 · Jul 6, 2023 · Jul 6, 2023 · Jul 10, 2023
diff --git a/.github/workflows/ci-tests.yml b/.github/workflows/ci-tests.yml
@@ -26,8 +26,7 @@ jobs:
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
-        pip install -r requirements.txt
-        pip install -e .
+        pip install -e ".[develop]"
       shell: bash
     - name: Test with pytest
       run: |

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,8 @@
 All notable changes to this project will be documented in this file. If you make a notable change to the project, please add a line describing the change to the "unreleased" section. The maintainers will make an effort to keep the [Github Releases](https://github.com/NREL/OpenOA/releases) page up to date with this changelog. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
 
 ## Unreleased
+- A static yaw misalignment analysis class `StaticYawMisalignment` has been added to estimate static yaw misalignment as a function of wind speed for individual wind turbines using turbine-level SCADA data
+  - The new `07_static_yaw_misalignment` example notebook demonstrates the application of the yaw misalignment method using the example La Haute Borne data
 - Added downloader utils module containing functions for downloading generic files from the web, downloading files from Zenodo, and downloading monthly-resolution ERA5 and MERRA2 data
 - Added example notebook "02c_plant_aep_analysis_cubico.ipynb" that demonstrates creating a `PlantData` object and running AEP analysis for two Cubico wind plants (Kelmarsh and Penmanshiel) using open data downloaded from Zenodo
 - Hard-coded reanalyis product abbreviation requirements in the analysis classes have been moved to check that the provided abbreviations match the reanalysis abbreviations used for the `PlantData.reanalysis` dictionary keys.

diff --git a/examples/06_wake_loss_analysis.ipynb b/examples/06_wake_loss_analysis.ipynb
diff --git a/examples/07_static_yaw_misalignment.ipynb b/examples/07_static_yaw_misalignment.ipynb
diff --git a/examples/data/plant_meta.json b/examples/data/plant_meta.json
@@ -44,6 +44,7 @@
   "scada": {
     "WMET_EnvTmp": "Ot_avg",
     "WMET_HorWdDir": "Wa_avg",
+    "WMET_HorWdDirRel": "Va_avg",
     "WMET_HorWdSpd": "Ws_avg",
     "WROT_BlPthAngVal": "Ba_avg",
     "WTUR_W": "P_avg",

diff --git a/examples/data/plant_meta.yml b/examples/data/plant_meta.yml
@@ -42,4 +42,5 @@ scada:
   WMET_EnvTmp: Ot_avg  # temperature, C
   time: Date_time  # timestamps
   WMET_HorWdDir: Wa_avg  # wind direction, degrees
+  WMET_HorWdDirRel: Va_avg  # wind direction relative to nacelle orientation, degrees
   WMET_HorWdSpd: Ws_avg  # non-directional windspeed, m/s
diff --git a/openoa/__init__.py b/openoa/__init__.py
@@ -10,14 +10,16 @@ def __attach_methods():
     from openoa.analysis.aep import create_MonteCarloAEP
     from openoa.analysis.wake_losses import create_WakeLosses
     from openoa.analysis.eya_gap_analysis import create_EYAGapAnalysis
+    from openoa.analysis.yaw_misalignment import create_StaticYawMisalignment
     from openoa.analysis.electrical_losses import create_ElectricalLosses
     from openoa.analysis.turbine_long_term_gross_energy import create_TurbineLongTermGrossEnergy
 
     setattr(PlantData, "MonteCarloAEP", create_MonteCarloAEP)
+    setattr(PlantData, "WakeLosses", create_WakeLosses)
     setattr(PlantData, "EYAGapAnalysis", create_EYAGapAnalysis)
     setattr(PlantData, "ElectricalLosses", create_ElectricalLosses)
+    setattr(PlantData, "StaticYawMisalignment", create_StaticYawMisalignment)
     setattr(PlantData, "TurbineLongTermGrossEnergy", create_TurbineLongTermGrossEnergy)
-    setattr(PlantData, "WakeLosses", create_WakeLosses)
 
 
 __attach_methods()

diff --git a/openoa/analysis/__init__.py b/openoa/analysis/__init__.py
@@ -1,5 +1,6 @@
 from openoa.analysis.aep import MonteCarloAEP
 from openoa.analysis.wake_losses import WakeLosses
 from openoa.analysis.eya_gap_analysis import EYAGapAnalysis
+from openoa.analysis.yaw_misalignment import StaticYawMisalignment
 from openoa.analysis.electrical_losses import ElectricalLosses
 from openoa.analysis.turbine_long_term_gross_energy import TurbineLongTermGrossEnergy
diff --git a/openoa/analysis/wake_losses.py b/openoa/analysis/wake_losses.py
@@ -6,6 +6,13 @@
 # steps to estimate wake losses during the period of record. Methods for calclating the
 # long-term wake losses using reanalaysis data and quantifying uncertainty are provided as well.
 
+# The general approach for estimating wake losses and quantifying uncertainty using bootstrapping
+# is based in part on the following publications:
+# 1. N. G. Nygaard, "Systematic quantification of wake model uncertainty,"" Proc. EWEA Offshore,
+#    Copenhagen, Denmark, 2015.
+# 2. J. Xue and L. Wang, “Online data-driven approach of yaw error estimation and correction of
+#    horizontal axis wind turbine,” IET J. Eng., 2019(18), 4937–4940, 2019.
+
 from __future__ import annotations
 
 import random

diff --git a/openoa/analysis/yaw_misalignment.py b/openoa/analysis/yaw_misalignment.py
diff --git a/openoa/schema/base_electrical_losses_schema.json b/openoa/schema/base_electrical_losses_schema.json
@@ -6,19 +6,19 @@
       "units": "kWh"
     },
     "frequency": [
-      "H",
-      "min",
-      "T",
-      "S",
       "D",
+      "T",
+      "L",
+      "min",
       "ms",
-      "U",
+      "H",
+      "N",
       "M",
       "us",
-      "N",
       "MS",
+      "U",
       "W",
-      "L"
+      "S"
     ]
   },
   "scada": {
@@ -33,16 +33,16 @@
       "units": null
     },
     "frequency": [
-      "T",
-      "S",
       "D",
-      "ms",
-      "U",
-      "us",
-      "N",
+      "L",
       "min",
+      "ms",
       "H",
-      "L"
+      "N",
+      "us",
+      "T",
+      "U",
+      "S"
     ]
   }
 }
diff --git a/openoa/schema/base_electrical_losses_schema.yml b/openoa/schema/base_electrical_losses_schema.yml
@@ -8,32 +8,32 @@ scada:
     dtype: float
     units: kW
   frequency:
-  - T
-  - S
   - D
-  - ms
-  - U
-  - us
-  - N
+  - L
   - min
+  - ms
   - H
-  - L
+  - N
+  - us
+  - T
+  - U
+  - S
 meter:
   MMTR_SupWh:
     name: MMTR_SupWh
     dtype: float
     units: kWh
   frequency:
-  - H
-  - min
-  - T
-  - S
   - D
+  - T
+  - L
+  - min
   - ms
-  - U
+  - H
+  - N
   - M
   - us
-  - N
   - MS
+  - U
   - W
-  - L
+  - S
diff --git a/openoa/schema/base_monte_carlo_aep_schema.json b/openoa/schema/base_monte_carlo_aep_schema.json
@@ -11,19 +11,19 @@
       "units": "kWh"
     },
     "frequency": [
-      "H",
-      "min",
-      "T",
-      "S",
       "D",
+      "T",
+      "L",
+      "min",
       "ms",
-      "U",
+      "H",
+      "N",
       "M",
       "us",
-      "N",
       "MS",
+      "U",
       "W",
-      "L"
+      "S"
     ]
   },
   "meter": {
@@ -33,19 +33,19 @@
       "units": "kWh"
     },
     "frequency": [
-      "H",
-      "min",
-      "T",
-      "S",
       "D",
+      "T",
+      "L",
+      "min",
       "ms",
-      "U",
+      "H",
+      "N",
       "M",
       "us",
-      "N",
       "MS",
+      "U",
       "W",
-      "L"
+      "S"
     ]
   },
   "reanalysis": {
@@ -60,19 +60,19 @@
       "units": "m/s"
     },
     "frequency": [
-      "H",
-      "min",
-      "T",
-      "S",
       "D",
+      "T",
+      "L",
+      "min",
       "ms",
-      "U",
+      "H",
+      "N",
       "M",
       "us",
-      "N",
       "MS",
+      "U",
       "W",
-      "L"
+      "S"
     ]
   }
 }
diff --git a/openoa/schema/base_monte_carlo_aep_schema.yml b/openoa/schema/base_monte_carlo_aep_schema.yml
@@ -4,19 +4,19 @@ meter:
     dtype: float
     units: kWh
   frequency:
-  - H
-  - min
-  - T
-  - S
   - D
+  - T
+  - L
+  - min
   - ms
-  - U
+  - H
+  - N
   - M
   - us
-  - N
   - MS
+  - U
   - W
-  - L
+  - S
 curtail:
   IAVL_ExtPwrDnWh:
     name: IAVL_ExtPwrDnWh
@@ -27,19 +27,19 @@ curtail:
     dtype: float
     units: kWh
   frequency:
-  - H
-  - min
-  - T
-  - S
   - D
+  - T
+  - L
+  - min
   - ms
-  - U
+  - H
+  - N
   - M
   - us
-  - N
   - MS
+  - U
   - W
-  - L
+  - S
 reanalysis:
   WMETR_HorWdSpd:
     name: WMETR_HorWdSpd
@@ -50,16 +50,16 @@ reanalysis:
     dtype: float
     units: kg/m^3
   frequency:
-  - H
-  - min
-  - T
-  - S
   - D
+  - T
+  - L
+  - min
   - ms
-  - U
+  - H
+  - N
   - M
   - us
-  - N
   - MS
+  - U
   - W
-  - L
+  - S
diff --git a/openoa/schema/base_tie_schema.json b/openoa/schema/base_tie_schema.json
@@ -16,16 +16,16 @@
       "units": "m/s"
     },
     "frequency": [
-      "T",
-      "S",
       "D",
-      "ms",
-      "U",
-      "us",
-      "N",
+      "L",
       "min",
+      "ms",
       "H",
-      "L"
+      "N",
+      "us",
+      "T",
+      "U",
+      "S"
     ]
   },
   "scada": {
@@ -45,16 +45,16 @@
       "units": null
     },
     "frequency": [
-      "T",
-      "S",
       "D",
-      "ms",
-      "U",
-      "us",
-      "N",
+      "L",
       "min",
+      "ms",
       "H",
-      "L"
+      "N",
+      "us",
+      "T",
+      "U",
+      "S"
     ]
   }
 }