| Name | OpenOA JSON |
| Version |
3.1.1
JSON |
| download |
| home_page | None |
| Summary | A package for collecting and assigning wind turbine metrics |
| upload_time | 2024-04-06 00:12:17 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <3.12,>=3.8 |
| license | BSD 3-Clause License Copyright (c) 2022, Alliance for Sustainable Energy LLC, All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
| keywords |
python3
wind-energy
operations
operational-analysis
operational-assessement
turbine-performance
wind-plant-performance
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<img src="https://github.com/NREL/OpenOA/blob/develop/Open%20OA%20Final%20Logos/Color/Open%20OA%20Color%20Transparent%20Background.png?raw=true" alt="OpenOA" width="300"/>
-----
[](https://joss.theoj.org/papers/d635ef3c3784d49f6e81e07a0b35ff6b)
[](https://badge.fury.io/py/openoa)
[](https://opensource.org/licenses/BSD-3-Clause)
[](https://gitter.im/NREL_OpenOA/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
[](https://mybinder.org/v2/gh/NREL/OpenOA/main?filepath=examples)
[](https://openoa.readthedocs.io)
[](https://codecov.io/gh/NREL/OpenOA)
[](https://pypi.org/project/WOMBAT/)
[](https://github.com/pre-commit/pre-commit)
[](https://github.com/psf/black)
[](https://pycqa.github.io/isort/)
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
[](#contributors-)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
-----
## Software Overview
- Jump to [installation instructions](#installation-and-usage).
- Demo the code by running the [example notebooks on Binder](https://mybinder.org/v2/gh/NREL/OpenOA/main?filepath=examples).
- Read the [documentation](https://openoa.readthedocs.io/en/latest/).
- Learn how to [contribute](contributing.md).
OpenOA [^1] is a software framework written in Python for assessing wind plant performance using
operational assessment (OA) methodologies that consume time series data from wind plants. The goal
of the project is to provide an open source implementation of common data structures, analysis
methods, and utility functions relevant to wind plant OA, while providing a platform to collaborate
on new functionality.
Development of OpenOA was motivated by the Wind Plant Performance Prediction (WP3) Benchmark project
[^2], led by the National Renewable Energy Laboratory (NREL), which focuses on quantifying and
understanding differences between the expected and actual energy production of wind plants. To
support the WP3 Benchmark project, OpenOA was initially developed to provide a baseline
implementation of a long-term operational annual energy production (AEP) estimation method. It has
since grown to incorporate several more OA analysis methods, lower-level utility functions, and a
schema for time-series data from wind power plants.
> **Warning**
Warning OpenOA is a research software library and is released under a BSD-3 license. Please refer
to the accompanying [license file](LICENSE.txt) for the full terms. We encourage caution, use of
best practices, and engagement with subject matter experts when performing any data analysis.
### Included Analysis Methods
| Name | Description | Citations |
| --- | --- | --- |
| `MonteCarloAEP` | This routine estimates the long-term annual energy production (AEP) of a wind power plant (typically over 10-20 years) based on operational data from a shorter period of record (e.g., 1-3 years), along with the uncertainty. | [^3], [^4] |
| `TurbineLongTermGrossEnergy`| This routine estimates the long-term turbine ideal energy (TIE) of a wind plant, defined as the long-term AEP that would be generated by the wind plant if all turbines operated normally (i.e., no downtime, derating, or severe underperformance, but still subject to wake losses and moderate performance losses), along with the uncertainty. | [^5] |
| `ElectricalLosses`| The ElectricalLosses routine estimates the average electrical losses at a wind plant, along with the uncertainty, by comparing the energy produced at the wind turbines to the energy delivered to the grid. | [^5] |
| `EYAGapAnalysis`| This class is used to perform a gap analysis between the estimated AEP from a pre-construction energy yield estimate (EYA) and the actual AEP. The gap analysis compares different wind plant performance categories to help understand the sources of differences between EYA AEP estimates and actual AEP, specifically availability losses, electrical losses, and TIE. | [^5] |
| `WakeLosses`| This routine estimates long-term internal wake losses experienced by a wind plant and for each individual turbine, along with the uncertainty. | [^6]. Based in part on approaches in [^7], [^8], [^9] |
| `StaticYawMisalignment`| The StaticYawMisalignment routine estimates the static yaw misalignment for individual wind turbines as a function of wind speed by comparing the estimated wind vane angle at which power is maximized to the mean wind vane angle at which the turbines operate. The routine includes uncertainty quantification. **Warning: This method has not been validated using data from wind turbines with known static yaw misalignments and the results should be treated with caution.** | Based in part on approaches in [^10], [^11], [^12], [^13], [^14] |
### PlantData Schema
OpenOA contains a `PlantData` class, which is based on Pandas data frames and provides a
standardized base schema to combine raw data from wind turbines, meteorological (met) towers,
revenue meters, and reanalysis products, such as MERRA-2 or ERA5. Additionally, the `PlantData`
class can perform some basic validation for the data required to perform the operational analyses.
### Utility Functions
Lower-level utility modules are provided in the utils subpackage.
They can also be used individually to support general wind plant data analysis activities.
Some examples of utils modules include:
- **Quality Assurance**: This module provides quality assurance methods for identifying potential
quality issues with SCADA data prior to importing it into a `PlantData` object.
- **Filters**: This module provides functions for flagging operational data based on a range of
criteria (e.g., outlier detection).
- **Power Curve**: The power curve module contains methods for fitting power curve models to SCADA data.
- **Imputing**: This module provides methods for filling in missing data with imputed values.
- **Met Data Processing**: This module contains methods for processing meteorological data, such as
computing air density and wind shear coefficients.
- **Plotting**: This module contains convenient functions for creating plots, such as power curve
plots and maps showing the wind plant layout.
For further information about the features and citations, please see the
[OpenOA documentation website](https://openoa.readthedocs.io/en/latest/).
## How to cite OpenOA
**To cite analysis methods or individual features:** Please cite the original authors of these
methods, as noted in the [documentation](#included-analysis-methods) and inline comments.
**To cite the open-source software framework as a whole, or the OpenOA open source development
effort more broadly,** please use citation [^1], which is provided below in BibTeX:
```bibtex
@article{Perr-Sauer2021,
doi = {10.21105/joss.02171},
url = {https://doi.org/10.21105/joss.02171},
year = {2021},
publisher = {The Open Journal},
volume = {6},
number = {58},
pages = {2171},
author = {Jordan Perr-Sauer and Mike Optis and Jason M. Fields and Nicola Bodini and Joseph C.Y. Lee and Austin Todd and Eric Simley and Robert Hammond and Caleb Phillips and Monte Lunacek and Travis Kemper and Lindy Williams and Anna Craig and Nathan Agarwal and Shawn Sheng and John Meissner},
title = {OpenOA: An Open-Source Codebase For Operational Analysis of Wind Farms},
journal = {Journal of Open Source Software}
}
```
## Installation and Usage
### Requirements
- Python 3.8-3.11 with pip.
We strongly recommend using the Anaconda Python distribution and creating a new conda environment
for OpenOA. You can download Anaconda through
[their website.](https://www.anaconda.com/products/individual)
After installing Anaconda, create and activate a new conda environment with the name "openoa-env":
```bash
conda create --name openoa-env python=3.10
conda activate openoa-env
```
### Installation
Clone the repository and install the library and its dependencies using pip:
```bash
git clone https://github.com/NREL/OpenOA.git
cd OpenOA
pip install .
```
You should now be able to import OpenOA from the Python interpreter:
```bash
python
>>> import openoa
>>> openoa.__version__
```
#### Installation Options
There are a number of installation options that can be used, depending on the use case, which can be
installed with the following pattern `pip install "openoa[opt1,opt2]"` (`pip install .[opt1,opt2]`
is also allowed).
- `develop`: for linting, automated formatting, and testing
- `docs`: for building the documentation
- `examples`: for the full Jupyter Lab suite (also contains `reanalysis` and `nrel-wind`)
- `renalysis`: for accessing and processing MERRA2 and ERA5 data
- `nrel-wind`: for accessing the NREL WIND Toolkit
- `all`: for the complete dependency stack
> **Important**
> If using Python 3.11, install `openoa` only, then reinstall adding the modifiers to reduce
> the amount of time it takes for pip to resolve the dependency stack.
#### Common Installation Issues
- In Windows, you may get an error regarding geos_c.dll. To fix this, install Shapely using:
```bash
conda install Shapely
```
- In Windows, an `ImportError` regarding win32api can also occur. This can be resolved by fixing
- the version of pywin32 as follows:
```bash
pip install --upgrade pywin32==255
```
#### Example Notebooks and Data
Be sure to install OpenOA using the `examples` modifier from [above](#installation-options). Such
as: `pip install ".[examples]"`
The example data will be automatically extracted as needed by the tests. To manually extract the
example data for use with the example notebooks, use the following command:
```bash
unzip examples/data/la_haute_borne.zip -d examples/data/la_haute_borne/
```
The example notebooks are located in the `examples` directory. We suggest installing the Jupyter
notebook server to run the notebooks interactively. The notebooks can also be viewed statically on
[Read The Docs](http://openoa.readthedocs.io/en/latest/examples).
```bash
jupyter lab # "jupyter notebook" is also ok if that's your preference
```
Open the URL printed to your command prompt in your favorite browser. Once Jupyter is open, navigate
to the "examples" directory in the file explorer and open an example notebook.
### Development
Please see the developer section of the contributing guide [here](contributing.md), or on the
[documentation site](https://openoa.readthedocs.io/en/latest/getting_started/contributing.html) for
complete details.
Development dependencies are provided through the "develop" extra flag in setup.py. Here, we install
OpenOA, with development dependencies, in editable mode, and activate the pre-commit workflow (note:
this second step must be done before committing any changes):
```bash
cd OpenOA
pip install -e ".[develop, docs, examples]"
pre-commit install
```
Occasionally, you will need to update the dependencies in the pre-commit workflow, which will
provide an error when this needs to happen. When it does, this can normally be resolved with the
below code, after which you can continue with your normal git workflow:
```bash
pre-commit autoupdate
git add .pre-commit-config.yaml
```
#### Testing
Tests are written in the Python unittest or pytest framework and are run using pytest. There
are two types of tests, unit tests (located in `test/unit`) run quickly and are automatically for
every pull request to the OpenOA repository. Regression tests (located at `test/regression`) provide
a comprehensive suite of scientific tests that may take a long time to run (up to 20 minutes on our
machines). These tests should be run locally before submitting a pull request, and are run weekly on
the develop and main branches.
To run all unit and regression tests:
```bash
pytest
```
To run unit tests only:
```bash
pytest --unit
```
To run all tests and generate a code coverage report
```bash
pytest --cov=openoa
```
#### Documentation
Documentation is automatically built by, and visible through
[Read The Docs](http://openoa.readthedocs.io/).
You can build the documentation with [sphinx](http://www.sphinx-doc.org/en/stable/), but will need
to ensure [Pandoc is installed](https://pandoc.org/installing.html) on your computer first.
```bash
cd OpenOA
pip install -e ".[docs]"
cd sphinx
make html
```
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tbody>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://www.linkedin.com/in/rob-hammond-33583756/"><img src="https://avatars.githubusercontent.com/u/13874373?v=4?s=100" width="100px;" alt="Rob Hammond"/><br /><sub><b>Rob Hammond</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=RHammond2" title="Code">💻</a> <a href="https://github.com/NREL/OpenOA/commits?author=RHammond2" title="Documentation">📖</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3ARHammond2" title="Reviewed Pull Requests">👀</a> <a href="#tutorial-RHammond2" title="Tutorials">✅</a> <a href="#maintenance-RHammond2" title="Maintenance">🚧</a> <a href="#ideas-RHammond2" title="Ideas, Planning, & Feedback">🤔</a> <a href="#fundingFinding-RHammond2" title="Funding Finding">🔍</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/jordanperr"><img src="https://avatars.githubusercontent.com/u/355615?v=4?s=100" width="100px;" alt="Jordan Perr-Sauer"/><br /><sub><b>Jordan Perr-Sauer</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=jordanperr" title="Documentation">📖</a> <a href="https://github.com/NREL/OpenOA/commits?author=jordanperr" title="Code">💻</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Ajordanperr" title="Reviewed Pull Requests">👀</a> <a href="#tutorial-jordanperr" title="Tutorials">✅</a> <a href="#maintenance-jordanperr" title="Maintenance">🚧</a> <a href="#ideas-jordanperr" title="Ideas, Planning, & Feedback">🤔</a> <a href="#fundingFinding-jordanperr" title="Funding Finding">🔍</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/ejsimley"><img src="https://avatars.githubusercontent.com/u/40040961?v=4?s=100" width="100px;" alt="ejsimley"/><br /><sub><b>ejsimley</b></sub></a><br /><a href="#projectManagement-ejsimley" title="Project Management">📆</a> <a href="https://github.com/NREL/OpenOA/commits?author=ejsimley" title="Code">💻</a> <a href="#data-ejsimley" title="Data">🔣</a> <a href="https://github.com/NREL/OpenOA/commits?author=ejsimley" title="Documentation">📖</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Aejsimley" title="Reviewed Pull Requests">👀</a> <a href="#tutorial-ejsimley" title="Tutorials">✅</a> <a href="#ideas-ejsimley" title="Ideas, Planning, & Feedback">🤔</a> <a href="#fundingFinding-ejsimley" title="Funding Finding">🔍</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Dynorat"><img src="https://avatars.githubusercontent.com/u/4141650?v=4?s=100" width="100px;" alt="Jason Fields"/><br /><sub><b>Jason Fields</b></sub></a><br /><a href="#projectManagement-Dynorat" title="Project Management">📆</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3ADynorat" title="Reviewed Pull Requests">👀</a> <a href="#business-Dynorat" title="Business development">💼</a> <a href="#design-Dynorat" title="Design">🎨</a> <a href="#fundingFinding-Dynorat" title="Funding Finding">🔍</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/nbodini"><img src="https://avatars.githubusercontent.com/u/55894604?v=4?s=100" width="100px;" alt="Nicola Bodini"/><br /><sub><b>Nicola Bodini</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=nbodini" title="Code">💻</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Anbodini" title="Reviewed Pull Requests">👀</a> <a href="#tutorial-nbodini" title="Tutorials">✅</a> <a href="#ideas-nbodini" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/moptis"><img src="https://avatars.githubusercontent.com/u/32751681?v=4?s=100" width="100px;" alt="moptis"/><br /><sub><b>moptis</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=moptis" title="Code">💻</a> <a href="#data-moptis" title="Data">🔣</a> <a href="https://github.com/NREL/OpenOA/commits?author=moptis" title="Documentation">📖</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Amoptis" title="Reviewed Pull Requests">👀</a> <a href="#tutorial-moptis" title="Tutorials">✅</a> <a href="#ideas-moptis" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/joejoeyjoseph"><img src="https://avatars.githubusercontent.com/u/22756182?v=4?s=100" width="100px;" alt="Joseph Lee"/><br /><sub><b>Joseph Lee</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=joejoeyjoseph" title="Code">💻</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://charlie9578.github.io/"><img src="https://avatars.githubusercontent.com/u/14888896?v=4?s=100" width="100px;" alt="Charlie"/><br /><sub><b>Charlie</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=charlie9578" title="Code">💻</a> <a href="#data-charlie9578" title="Data">🔣</a> <a href="https://github.com/NREL/OpenOA/commits?author=charlie9578" title="Documentation">📖</a> <a href="#tutorial-charlie9578" title="Tutorials">✅</a> <a href="#ideas-charlie9578" title="Ideas, Planning, & Feedback">🤔</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/zheitkamp1"><img src="https://avatars.githubusercontent.com/u/53791791?v=4?s=100" width="100px;" alt="zheitkamp1"/><br /><sub><b>zheitkamp1</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=zheitkamp1" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/abbey2017"><img src="https://avatars.githubusercontent.com/u/26353690?v=4?s=100" width="100px;" alt="Abiodun Timothy Olaoye"/><br /><sub><b>Abiodun Timothy Olaoye</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=abbey2017" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://kristenthyng.com/"><img src="https://avatars.githubusercontent.com/u/3487237?v=4?s=100" width="100px;" alt="Kristen Thyng"/><br /><sub><b>Kristen Thyng</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=kthyng" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="http://www.rafmudaf.com/"><img src="https://avatars.githubusercontent.com/u/13797903?v=4?s=100" width="100px;" alt="Rafael M Mudafort"/><br /><sub><b>Rafael M Mudafort</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=rafmudaf" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/sebastianpfaffel"><img src="https://avatars.githubusercontent.com/u/22168894?v=4?s=100" width="100px;" alt="sebastianpfaffel"/><br /><sub><b>sebastianpfaffel</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=sebastianpfaffel" title="Code">💻</a></td>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/nateagarwal"><img src="https://avatars.githubusercontent.com/u/51377789?v=4?s=100" width="100px;" alt="nateagarwal"/><br /><sub><b>nateagarwal</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=nateagarwal" title="Code">💻</a> <a href="https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Anateagarwal" title="Reviewed Pull Requests">👀</a></td>
</tr>
<tr>
<td align="center" valign="top" width="14.28%"><a href="https://github.com/Var-Char"><img src="https://avatars.githubusercontent.com/u/16821332?v=4?s=100" width="100px;" alt="Var-Char"/><br /><sub><b>Var-Char</b></sub></a><br /><a href="https://github.com/NREL/OpenOA/commits?author=Var-Char" title="Code">💻</a></td>
</tr>
</tbody>
<tfoot>
<tr>
<td align="center" size="13px" colspan="7">
<img src="https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg">
<a href="https://all-contributors.js.org/docs/en/bot/usage">Add your contributions</a>
</img>
</td>
</tr>
</tfoot>
</table>
<!-- markdownlint-restore -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## References
[^1]: Perr-Sauer, J., and Optis, M., Fields, J.M., Bodini, N., Lee, J.C.Y., Todd, A., Simley, E., Hammond, R., Phillips, C., Lunacek, M., Kemper, T., Williams, L., Craig, A., Agarwal, N., Sheng, S., and Meissner, J. OpenOA: An Open-Source Codebase For Operational Analysis of Wind Farms. *Journal of Open Source Software*, 6(58):2171 (2022). https://doi.org/10.21105/joss.02171.
[^2]: Fields, M. J., Optis, M., Perr-Sauer, J., Todd, A., Lee, J. C. Y., Meissner, J., Simley, E., Bodini, N., Williams, L., Sheng, S., and Hammond, R.. Wind plant performance prediction benchmark phase 1 technical report, NREL/TP-5000-78715. Technical Report, National Renewable Energy Laboratory, Golden, CO (2021). https://doi.org/10.2172/1826665.
[^3]: Bodini, N. & Optis, M. Operational-based annual energy production uncertainty: are its components actually uncorrelated? *Wind Energy Science* 5(4):1435–1448 (2020). https://doi.org/10.5194/wes-5-1435-2020.
[^4]: Bodini, N., Optis, M., Perr-Sauer, J., Simley, E., and Fields, M. J. Lowering post-construction yield assessment uncertainty through better wind plant power curves. *Wind Energy*, 25(1):5–22 (2022). https://doi.org/10.1002/we.2645.
[^5]: Todd, A. C., Optis, M., Bodini, N., Fields, M. J., Lee, J. C. Y., Simley, E., and Hammond, R. An independent analysis of bias sources and variability in wind plant pre‐construction energy yield estimation methods. *Wind Energy*, 25(10):1775-1790 (2022). https://doi.org/10.1002/we.2768.
[^6]: Simley, E., Fields, M. J., Perr-Sauer, J., Hammond, R., and Bodini, N. A Comparison of Preconstruction and Operational Wake Loss Estimates for Land-Based Wind Plants. Presented at the NAWEA/WindTech 2022 Conference, Newark, DE, September 20-22 (2022). https://www.nrel.gov/docs/fy23osti/83874.pdf.
[^7]: Barthelmie, R. J. and Jensen, L. E. Evaluation of wind farm efficiency and wind turbine wakes at the Nysted offshore wind farm, *Wind Energy* 13(6):573–586 (2010). https://doi.org/10.1002/we.408.
[^8]: Nygaard, N. G. Systematic quantification of wake model uncertainty. Proc. EWEA Offshore, Copenhagen, Denmark, March 10-12 (2015).
[^9]: Walker, K., Adams, N., Gribben, B., Gellatly, B., Nygaard, N. G., Henderson, A., Marchante Jimémez, M., Schmidt, S. R., Rodriguez Ruiz, J., Paredes, D., Harrington, G., Connell, N., Peronne, O., Cordoba, M., Housley, P., Cussons, R., Håkansson, M., Knauer, A., and Maguire, E.: An evaluation of the predictive accuracy of wake effects models for offshore wind farms. *Wind Energy* 19(5):979–996 (2016). https://doi.org/10.1002/we.1871.
[^10]: Bao, Y., Yang, Q., Fu, L., Chen, Q., Cheng, C., and Sun, Y. Identification of Yaw Error Inherent Misalignment for Wind Turbine Based on SCADA Data: A Data Mining Approach. Proc. 12th Asian Control Conference (ASCC), Kitakyushu, Japan, June 9-12 (2019). 1095-1100.
[^11]: Xue, J. and Wang, L. Online data-driven approach of yaw error estimation and correction of horizontal axis wind turbine. *IET J. Eng.* 2019(18):4937–4940 (2019). https://doi.org/10.1049/joe.2018.9293.
[^12]: Astolfi, D., Castellani, F., and Terzi, L. An Operation Data-Based Method for the Diagnosis of Zero-Point Shift of Wind Turbines Yaw Angle. *J. Solar Energy Engineering* 142(2):024501 (2020). https://doi.org/10.1115/1.4045081.
[^13]: Jing, B., Qian, Z., Pei, Y., Zhang, L., and Yang, T. Improving wind turbine efficiency through detection and calibration of yaw misalignment. *Renewable Energy* 160:1217-1227 (2020). https://doi.org/10.1016/j.renene.2020.07.063.
[^14]: Gao, L. and Hong, J. Data-driven yaw misalignment correction for utility-scale wind turbines. *J. Renewable Sustainable Energy* 13(6):063302 (2021). https://doi.org/10.1063/5.0056671.
Raw data
{
"_id": null,
"home_page": null,
"name": "OpenOA",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.12,>=3.8",
"maintainer_email": null,
"keywords": "python3, wind-energy, operations, operational-analysis, operational-assessement, turbine-performance, wind-plant-performance",
"author": null,
"author_email": "NREL PRUF OA Team <openoa@nrel.gov>",
"download_url": "https://files.pythonhosted.org/packages/91/21/b2682e06657570fefe868b94cee40f269669c3021b5090cd8f6f0a0331d5/OpenOA-3.1.1.tar.gz",
"platform": null,
"description": "<img src=\"https://github.com/NREL/OpenOA/blob/develop/Open%20OA%20Final%20Logos/Color/Open%20OA%20Color%20Transparent%20Background.png?raw=true\" alt=\"OpenOA\" width=\"300\"/>\n\n-----\n\n[](https://joss.theoj.org/papers/d635ef3c3784d49f6e81e07a0b35ff6b)\n[](https://badge.fury.io/py/openoa)\n[](https://opensource.org/licenses/BSD-3-Clause)\n[](https://gitter.im/NREL_OpenOA/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)\n[](https://mybinder.org/v2/gh/NREL/OpenOA/main?filepath=examples)\n\n[](https://openoa.readthedocs.io)\n[](https://codecov.io/gh/NREL/OpenOA)\n[](https://pypi.org/project/WOMBAT/)\n\n[](https://github.com/pre-commit/pre-commit)\n[](https://github.com/psf/black)\n[](https://pycqa.github.io/isort/)\n<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->\n[](#contributors-)\n<!-- ALL-CONTRIBUTORS-BADGE:END -->\n\n-----\n\n## Software Overview\n\n- Jump to [installation instructions](#installation-and-usage).\n- Demo the code by running the [example notebooks on Binder](https://mybinder.org/v2/gh/NREL/OpenOA/main?filepath=examples).\n- Read the [documentation](https://openoa.readthedocs.io/en/latest/).\n- Learn how to [contribute](contributing.md).\n\nOpenOA [^1] is a software framework written in Python for assessing wind plant performance using\noperational assessment (OA) methodologies that consume time series data from wind plants. The goal\nof the project is to provide an open source implementation of common data structures, analysis\nmethods, and utility functions relevant to wind plant OA, while providing a platform to collaborate\non new functionality.\n\nDevelopment of OpenOA was motivated by the Wind Plant Performance Prediction (WP3) Benchmark project\n[^2], led by the National Renewable Energy Laboratory (NREL), which focuses on quantifying and\nunderstanding differences between the expected and actual energy production of wind plants. To\nsupport the WP3 Benchmark project, OpenOA was initially developed to provide a baseline\nimplementation of a long-term operational annual energy production (AEP) estimation method. It has\nsince grown to incorporate several more OA analysis methods, lower-level utility functions, and a\nschema for time-series data from wind power plants.\n\n> **Warning**\nWarning OpenOA is a research software library and is released under a BSD-3 license. Please refer\nto the accompanying [license file](LICENSE.txt) for the full terms. We encourage caution, use of\nbest practices, and engagement with subject matter experts when performing any data analysis.\n\n### Included Analysis Methods\n\n| Name | Description | Citations |\n| --- | --- | --- |\n| `MonteCarloAEP` | This routine estimates the long-term annual energy production (AEP) of a wind power plant (typically over 10-20 years) based on operational data from a shorter period of record (e.g., 1-3 years), along with the uncertainty. | [^3], [^4] |\n| `TurbineLongTermGrossEnergy`| This routine estimates the long-term turbine ideal energy (TIE) of a wind plant, defined as the long-term AEP that would be generated by the wind plant if all turbines operated normally (i.e., no downtime, derating, or severe underperformance, but still subject to wake losses and moderate performance losses), along with the uncertainty. | [^5] |\n| `ElectricalLosses`| The ElectricalLosses routine estimates the average electrical losses at a wind plant, along with the uncertainty, by comparing the energy produced at the wind turbines to the energy delivered to the grid. | [^5] |\n| `EYAGapAnalysis`| This class is used to perform a gap analysis between the estimated AEP from a pre-construction energy yield estimate (EYA) and the actual AEP. The gap analysis compares different wind plant performance categories to help understand the sources of differences between EYA AEP estimates and actual AEP, specifically availability losses, electrical losses, and TIE. | [^5] |\n| `WakeLosses`| This routine estimates long-term internal wake losses experienced by a wind plant and for each individual turbine, along with the uncertainty. | [^6]. Based in part on approaches in [^7], [^8], [^9] |\n| `StaticYawMisalignment`| The StaticYawMisalignment routine estimates the static yaw misalignment for individual wind turbines as a function of wind speed by comparing the estimated wind vane angle at which power is maximized to the mean wind vane angle at which the turbines operate. The routine includes uncertainty quantification. **Warning: This method has not been validated using data from wind turbines with known static yaw misalignments and the results should be treated with caution.** | Based in part on approaches in [^10], [^11], [^12], [^13], [^14] |\n\n### PlantData Schema\n\nOpenOA contains a `PlantData` class, which is based on Pandas data frames and provides a\nstandardized base schema to combine raw data from wind turbines, meteorological (met) towers,\nrevenue meters, and reanalysis products, such as MERRA-2 or ERA5. Additionally, the `PlantData`\nclass can perform some basic validation for the data required to perform the operational analyses.\n\n### Utility Functions\n\nLower-level utility modules are provided in the utils subpackage.\nThey can also be used individually to support general wind plant data analysis activities.\nSome examples of utils modules include:\n\n- **Quality Assurance**: This module provides quality assurance methods for identifying potential\n quality issues with SCADA data prior to importing it into a `PlantData` object.\n- **Filters**: This module provides functions for flagging operational data based on a range of\n criteria (e.g., outlier detection).\n- **Power Curve**: The power curve module contains methods for fitting power curve models to SCADA data.\n- **Imputing**: This module provides methods for filling in missing data with imputed values.\n- **Met Data Processing**: This module contains methods for processing meteorological data, such as\n computing air density and wind shear coefficients.\n- **Plotting**: This module contains convenient functions for creating plots, such as power curve\n plots and maps showing the wind plant layout.\n\nFor further information about the features and citations, please see the\n[OpenOA documentation website](https://openoa.readthedocs.io/en/latest/).\n\n## How to cite OpenOA\n\n**To cite analysis methods or individual features:** Please cite the original authors of these\nmethods, as noted in the [documentation](#included-analysis-methods) and inline comments.\n\n**To cite the open-source software framework as a whole, or the OpenOA open source development\neffort more broadly,** please use citation [^1], which is provided below in BibTeX:\n\n```bibtex\n @article{Perr-Sauer2021,\n doi = {10.21105/joss.02171},\n url = {https://doi.org/10.21105/joss.02171},\n year = {2021},\n publisher = {The Open Journal},\n volume = {6},\n number = {58},\n pages = {2171},\n author = {Jordan Perr-Sauer and Mike Optis and Jason M. Fields and Nicola Bodini and Joseph C.Y. Lee and Austin Todd and Eric Simley and Robert Hammond and Caleb Phillips and Monte Lunacek and Travis Kemper and Lindy Williams and Anna Craig and Nathan Agarwal and Shawn Sheng and John Meissner},\n title = {OpenOA: An Open-Source Codebase For Operational Analysis of Wind Farms},\n journal = {Journal of Open Source Software}\n }\n```\n\n## Installation and Usage\n\n### Requirements\n\n- Python 3.8-3.11 with pip.\n\nWe strongly recommend using the Anaconda Python distribution and creating a new conda environment\nfor OpenOA. You can download Anaconda through\n[their website.](https://www.anaconda.com/products/individual)\n\nAfter installing Anaconda, create and activate a new conda environment with the name \"openoa-env\":\n\n```bash\nconda create --name openoa-env python=3.10\nconda activate openoa-env\n```\n\n### Installation\n\nClone the repository and install the library and its dependencies using pip:\n\n```bash\ngit clone https://github.com/NREL/OpenOA.git\ncd OpenOA\npip install .\n```\n\nYou should now be able to import OpenOA from the Python interpreter:\n\n```bash\npython\n>>> import openoa\n>>> openoa.__version__\n```\n\n#### Installation Options\n\nThere are a number of installation options that can be used, depending on the use case, which can be\ninstalled with the following pattern `pip install \"openoa[opt1,opt2]\"` (`pip install .[opt1,opt2]`\nis also allowed).\n\n- `develop`: for linting, automated formatting, and testing\n- `docs`: for building the documentation\n- `examples`: for the full Jupyter Lab suite (also contains `reanalysis` and `nrel-wind`)\n- `renalysis`: for accessing and processing MERRA2 and ERA5 data\n- `nrel-wind`: for accessing the NREL WIND Toolkit\n- `all`: for the complete dependency stack\n\n> **Important**\n> If using Python 3.11, install `openoa` only, then reinstall adding the modifiers to reduce\n> the amount of time it takes for pip to resolve the dependency stack.\n\n#### Common Installation Issues\n\n- In Windows, you may get an error regarding geos_c.dll. To fix this, install Shapely using:\n\n```bash\nconda install Shapely\n```\n\n- In Windows, an `ImportError` regarding win32api can also occur. This can be resolved by fixing\n- the version of pywin32 as follows:\n\n```bash\npip install --upgrade pywin32==255\n```\n\n#### Example Notebooks and Data\n\nBe sure to install OpenOA using the `examples` modifier from [above](#installation-options). Such\nas: `pip install \".[examples]\"`\n\nThe example data will be automatically extracted as needed by the tests. To manually extract the\nexample data for use with the example notebooks, use the following command:\n\n```bash\nunzip examples/data/la_haute_borne.zip -d examples/data/la_haute_borne/\n```\n\nThe example notebooks are located in the `examples` directory. We suggest installing the Jupyter\nnotebook server to run the notebooks interactively. The notebooks can also be viewed statically on\n[Read The Docs](http://openoa.readthedocs.io/en/latest/examples).\n\n```bash\njupyter lab # \"jupyter notebook\" is also ok if that's your preference\n```\n\nOpen the URL printed to your command prompt in your favorite browser. Once Jupyter is open, navigate\nto the \"examples\" directory in the file explorer and open an example notebook.\n\n### Development\n\nPlease see the developer section of the contributing guide [here](contributing.md), or on the\n[documentation site](https://openoa.readthedocs.io/en/latest/getting_started/contributing.html) for\ncomplete details.\n\nDevelopment dependencies are provided through the \"develop\" extra flag in setup.py. Here, we install\nOpenOA, with development dependencies, in editable mode, and activate the pre-commit workflow (note:\nthis second step must be done before committing any changes):\n\n```bash\ncd OpenOA\npip install -e \".[develop, docs, examples]\"\npre-commit install\n```\n\nOccasionally, you will need to update the dependencies in the pre-commit workflow, which will\nprovide an error when this needs to happen. When it does, this can normally be resolved with the\nbelow code, after which you can continue with your normal git workflow:\n\n```bash\npre-commit autoupdate\ngit add .pre-commit-config.yaml\n```\n\n#### Testing\nTests are written in the Python unittest or pytest framework and are run using pytest. There\nare two types of tests, unit tests (located in `test/unit`) run quickly and are automatically for\nevery pull request to the OpenOA repository. Regression tests (located at `test/regression`) provide\na comprehensive suite of scientific tests that may take a long time to run (up to 20 minutes on our\nmachines). These tests should be run locally before submitting a pull request, and are run weekly on\nthe develop and main branches.\n\nTo run all unit and regression tests:\n\n```bash\npytest\n```\n\nTo run unit tests only:\n\n```bash\npytest --unit\n```\n\nTo run all tests and generate a code coverage report\n\n```bash\npytest --cov=openoa\n```\n\n#### Documentation\n\nDocumentation is automatically built by, and visible through\n[Read The Docs](http://openoa.readthedocs.io/).\n\nYou can build the documentation with [sphinx](http://www.sphinx-doc.org/en/stable/), but will need\nto ensure [Pandoc is installed](https://pandoc.org/installing.html) on your computer first.\n\n```bash\ncd OpenOA\npip install -e \".[docs]\"\ncd sphinx\nmake html\n```\n\n## Contributors \u2728\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->\n<!-- prettier-ignore-start -->\n<!-- markdownlint-disable -->\n<table>\n <tbody>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://www.linkedin.com/in/rob-hammond-33583756/\"><img src=\"https://avatars.githubusercontent.com/u/13874373?v=4?s=100\" width=\"100px;\" alt=\"Rob Hammond\"/><br /><sub><b>Rob Hammond</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=RHammond2\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/NREL/OpenOA/commits?author=RHammond2\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3ARHammond2\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a> <a href=\"#tutorial-RHammond2\" title=\"Tutorials\">\u2705</a> <a href=\"#maintenance-RHammond2\" title=\"Maintenance\">\ud83d\udea7</a> <a href=\"#ideas-RHammond2\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#fundingFinding-RHammond2\" title=\"Funding Finding\">\ud83d\udd0d</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/jordanperr\"><img src=\"https://avatars.githubusercontent.com/u/355615?v=4?s=100\" width=\"100px;\" alt=\"Jordan Perr-Sauer\"/><br /><sub><b>Jordan Perr-Sauer</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=jordanperr\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"https://github.com/NREL/OpenOA/commits?author=jordanperr\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Ajordanperr\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a> <a href=\"#tutorial-jordanperr\" title=\"Tutorials\">\u2705</a> <a href=\"#maintenance-jordanperr\" title=\"Maintenance\">\ud83d\udea7</a> <a href=\"#ideas-jordanperr\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#fundingFinding-jordanperr\" title=\"Funding Finding\">\ud83d\udd0d</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/ejsimley\"><img src=\"https://avatars.githubusercontent.com/u/40040961?v=4?s=100\" width=\"100px;\" alt=\"ejsimley\"/><br /><sub><b>ejsimley</b></sub></a><br /><a href=\"#projectManagement-ejsimley\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"https://github.com/NREL/OpenOA/commits?author=ejsimley\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#data-ejsimley\" title=\"Data\">\ud83d\udd23</a> <a href=\"https://github.com/NREL/OpenOA/commits?author=ejsimley\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Aejsimley\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a> <a href=\"#tutorial-ejsimley\" title=\"Tutorials\">\u2705</a> <a href=\"#ideas-ejsimley\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a> <a href=\"#fundingFinding-ejsimley\" title=\"Funding Finding\">\ud83d\udd0d</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/Dynorat\"><img src=\"https://avatars.githubusercontent.com/u/4141650?v=4?s=100\" width=\"100px;\" alt=\"Jason Fields\"/><br /><sub><b>Jason Fields</b></sub></a><br /><a href=\"#projectManagement-Dynorat\" title=\"Project Management\">\ud83d\udcc6</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3ADynorat\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a> <a href=\"#business-Dynorat\" title=\"Business development\">\ud83d\udcbc</a> <a href=\"#design-Dynorat\" title=\"Design\">\ud83c\udfa8</a> <a href=\"#fundingFinding-Dynorat\" title=\"Funding Finding\">\ud83d\udd0d</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/nbodini\"><img src=\"https://avatars.githubusercontent.com/u/55894604?v=4?s=100\" width=\"100px;\" alt=\"Nicola Bodini\"/><br /><sub><b>Nicola Bodini</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=nbodini\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Anbodini\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a> <a href=\"#tutorial-nbodini\" title=\"Tutorials\">\u2705</a> <a href=\"#ideas-nbodini\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/moptis\"><img src=\"https://avatars.githubusercontent.com/u/32751681?v=4?s=100\" width=\"100px;\" alt=\"moptis\"/><br /><sub><b>moptis</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=moptis\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#data-moptis\" title=\"Data\">\ud83d\udd23</a> <a href=\"https://github.com/NREL/OpenOA/commits?author=moptis\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Amoptis\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a> <a href=\"#tutorial-moptis\" title=\"Tutorials\">\u2705</a> <a href=\"#ideas-moptis\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/joejoeyjoseph\"><img src=\"https://avatars.githubusercontent.com/u/22756182?v=4?s=100\" width=\"100px;\" alt=\"Joseph Lee\"/><br /><sub><b>Joseph Lee</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=joejoeyjoseph\" title=\"Code\">\ud83d\udcbb</a></td>\n </tr>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://charlie9578.github.io/\"><img src=\"https://avatars.githubusercontent.com/u/14888896?v=4?s=100\" width=\"100px;\" alt=\"Charlie\"/><br /><sub><b>Charlie</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=charlie9578\" title=\"Code\">\ud83d\udcbb</a> <a href=\"#data-charlie9578\" title=\"Data\">\ud83d\udd23</a> <a href=\"https://github.com/NREL/OpenOA/commits?author=charlie9578\" title=\"Documentation\">\ud83d\udcd6</a> <a href=\"#tutorial-charlie9578\" title=\"Tutorials\">\u2705</a> <a href=\"#ideas-charlie9578\" title=\"Ideas, Planning, & Feedback\">\ud83e\udd14</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/zheitkamp1\"><img src=\"https://avatars.githubusercontent.com/u/53791791?v=4?s=100\" width=\"100px;\" alt=\"zheitkamp1\"/><br /><sub><b>zheitkamp1</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=zheitkamp1\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/abbey2017\"><img src=\"https://avatars.githubusercontent.com/u/26353690?v=4?s=100\" width=\"100px;\" alt=\"Abiodun Timothy Olaoye\"/><br /><sub><b>Abiodun Timothy Olaoye</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=abbey2017\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"http://kristenthyng.com/\"><img src=\"https://avatars.githubusercontent.com/u/3487237?v=4?s=100\" width=\"100px;\" alt=\"Kristen Thyng\"/><br /><sub><b>Kristen Thyng</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=kthyng\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"http://www.rafmudaf.com/\"><img src=\"https://avatars.githubusercontent.com/u/13797903?v=4?s=100\" width=\"100px;\" alt=\"Rafael M Mudafort\"/><br /><sub><b>Rafael M Mudafort</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=rafmudaf\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/sebastianpfaffel\"><img src=\"https://avatars.githubusercontent.com/u/22168894?v=4?s=100\" width=\"100px;\" alt=\"sebastianpfaffel\"/><br /><sub><b>sebastianpfaffel</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=sebastianpfaffel\" title=\"Code\">\ud83d\udcbb</a></td>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/nateagarwal\"><img src=\"https://avatars.githubusercontent.com/u/51377789?v=4?s=100\" width=\"100px;\" alt=\"nateagarwal\"/><br /><sub><b>nateagarwal</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=nateagarwal\" title=\"Code\">\ud83d\udcbb</a> <a href=\"https://github.com/NREL/OpenOA/pulls?q=is%3Apr+reviewed-by%3Anateagarwal\" title=\"Reviewed Pull Requests\">\ud83d\udc40</a></td>\n </tr>\n <tr>\n <td align=\"center\" valign=\"top\" width=\"14.28%\"><a href=\"https://github.com/Var-Char\"><img src=\"https://avatars.githubusercontent.com/u/16821332?v=4?s=100\" width=\"100px;\" alt=\"Var-Char\"/><br /><sub><b>Var-Char</b></sub></a><br /><a href=\"https://github.com/NREL/OpenOA/commits?author=Var-Char\" title=\"Code\">\ud83d\udcbb</a></td>\n </tr>\n </tbody>\n <tfoot>\n <tr>\n <td align=\"center\" size=\"13px\" colspan=\"7\">\n <img src=\"https://raw.githubusercontent.com/all-contributors/all-contributors-cli/1b8533af435da9854653492b1327a23a4dbd0a10/assets/logo-small.svg\">\n <a href=\"https://all-contributors.js.org/docs/en/bot/usage\">Add your contributions</a>\n </img>\n </td>\n </tr>\n </tfoot>\n</table>\n\n<!-- markdownlint-restore -->\n<!-- prettier-ignore-end -->\n<!-- ALL-CONTRIBUTORS-LIST:END -->\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n\n## References\n\n[^1]: Perr-Sauer, J., and Optis, M., Fields, J.M., Bodini, N., Lee, J.C.Y., Todd, A., Simley, E., Hammond, R., Phillips, C., Lunacek, M., Kemper, T., Williams, L., Craig, A., Agarwal, N., Sheng, S., and Meissner, J. OpenOA: An Open-Source Codebase For Operational Analysis of Wind Farms. *Journal of Open Source Software*, 6(58):2171 (2022). https://doi.org/10.21105/joss.02171.\n\n[^2]: Fields, M. J., Optis, M., Perr-Sauer, J., Todd, A., Lee, J. C. Y., Meissner, J., Simley, E., Bodini, N., Williams, L., Sheng, S., and Hammond, R.. Wind plant performance prediction benchmark phase 1 technical report, NREL/TP-5000-78715. Technical Report, National Renewable Energy Laboratory, Golden, CO (2021). https://doi.org/10.2172/1826665.\n\n[^3]: Bodini, N. & Optis, M. Operational-based annual energy production uncertainty: are its components actually uncorrelated? *Wind Energy Science* 5(4):1435\u20131448 (2020). https://doi.org/10.5194/wes-5-1435-2020.\n\n[^4]: Bodini, N., Optis, M., Perr-Sauer, J., Simley, E., and Fields, M. J. Lowering post-construction yield assessment uncertainty through better wind plant power curves. *Wind Energy*, 25(1):5\u201322 (2022). https://doi.org/10.1002/we.2645.\n\n[^5]: Todd, A. C., Optis, M., Bodini, N., Fields, M. J., Lee, J. C. Y., Simley, E., and Hammond, R. An independent analysis of bias sources and variability in wind plant pre\u2010construction energy yield estimation methods. *Wind Energy*, 25(10):1775-1790 (2022). https://doi.org/10.1002/we.2768.\n\n[^6]: Simley, E., Fields, M. J., Perr-Sauer, J., Hammond, R., and Bodini, N. A Comparison of Preconstruction and Operational Wake Loss Estimates for Land-Based Wind Plants. Presented at the NAWEA/WindTech 2022 Conference, Newark, DE, September 20-22 (2022). https://www.nrel.gov/docs/fy23osti/83874.pdf.\n\n[^7]: Barthelmie, R. J. and Jensen, L. E. Evaluation of wind farm efficiency and wind turbine wakes at the Nysted offshore wind farm, *Wind Energy* 13(6):573\u2013586 (2010). https://doi.org/10.1002/we.408.\n\n[^8]: Nygaard, N. G. Systematic quantification of wake model uncertainty. Proc. EWEA Offshore, Copenhagen, Denmark, March 10-12 (2015).\n\n[^9]: Walker, K., Adams, N., Gribben, B., Gellatly, B., Nygaard, N. G., Henderson, A., Marchante Jim\u00e9mez, M., Schmidt, S. R., Rodriguez Ruiz, J., Paredes, D., Harrington, G., Connell, N., Peronne, O., Cordoba, M., Housley, P., Cussons, R., H\u00e5kansson, M., Knauer, A., and Maguire, E.: An evaluation of the predictive accuracy of wake effects models for offshore wind farms. *Wind Energy* 19(5):979\u2013996 (2016). https://doi.org/10.1002/we.1871.\n\n[^10]: Bao, Y., Yang, Q., Fu, L., Chen, Q., Cheng, C., and Sun, Y. Identification of Yaw Error Inherent Misalignment for Wind Turbine Based on SCADA Data: A Data Mining Approach. Proc. 12th Asian Control Conference (ASCC), Kitakyushu, Japan, June 9-12 (2019). 1095-1100.\n\n[^11]: Xue, J. and Wang, L. Online data-driven approach of yaw error estimation and correction of horizontal axis wind turbine. *IET J. Eng.* 2019(18):4937\u20134940 (2019). https://doi.org/10.1049/joe.2018.9293.\n\n[^12]: Astolfi, D., Castellani, F., and Terzi, L. An Operation Data-Based Method for the Diagnosis of Zero-Point Shift of Wind Turbines Yaw Angle. *J. Solar Energy Engineering* 142(2):024501 (2020). https://doi.org/10.1115/1.4045081.\n\n[^13]: Jing, B., Qian, Z., Pei, Y., Zhang, L., and Yang, T. Improving wind turbine efficiency through detection and calibration of yaw misalignment. *Renewable Energy* 160:1217-1227 (2020). https://doi.org/10.1016/j.renene.2020.07.063.\n\n[^14]: Gao, L. and Hong, J. Data-driven yaw misalignment correction for utility-scale wind turbines. *J. Renewable Sustainable Energy* 13(6):063302 (2021). https://doi.org/10.1063/5.0056671.\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License Copyright (c) 2022, Alliance for Sustainable Energy LLC, All rights reserved. Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. ",
"summary": "A package for collecting and assigning wind turbine metrics",
"version": "3.1.1",
"project_urls": {
"changelog": "https://github.com/NREL/OpenOA/blob/main/CHANGELOG.md",
"documentation": "https://openoa.readthedocs.io/",
"issues": "https://github.com/NREL/OpenOA/issues",
"source": "https://github.com/NREL/OpenOA"
},
"split_keywords": [
"python3",
" wind-energy",
" operations",
" operational-analysis",
" operational-assessement",
" turbine-performance",
" wind-plant-performance"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7608b841a20502d58fe727376c35ec0d362ed861ddfd102c97d2632a0869a17e",
"md5": "0d80365327bfb5e34f423d8876382f48",
"sha256": "a0ea5c6f6cb7aeb852162647e47993772a910aeb9d1c2ca1d4baa5a360474887"
},
"downloads": -1,
"filename": "OpenOA-3.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0d80365327bfb5e34f423d8876382f48",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.12,>=3.8",
"size": 54569432,
"upload_time": "2024-04-06T00:12:12",
"upload_time_iso_8601": "2024-04-06T00:12:12.189811Z",
"url": "https://files.pythonhosted.org/packages/76/08/b841a20502d58fe727376c35ec0d362ed861ddfd102c97d2632a0869a17e/OpenOA-3.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9121b2682e06657570fefe868b94cee40f269669c3021b5090cd8f6f0a0331d5",
"md5": "95e2e67caa585c165a9c857dab6b787d",
"sha256": "cde340a23030d4fcb886198af73040879e1b2154dc5f2f8bc5c6bff474c59520"
},
"downloads": -1,
"filename": "OpenOA-3.1.1.tar.gz",
"has_sig": false,
"md5_digest": "95e2e67caa585c165a9c857dab6b787d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.12,>=3.8",
"size": 76388879,
"upload_time": "2024-04-06T00:12:17",
"upload_time_iso_8601": "2024-04-06T00:12:17.439122Z",
"url": "https://files.pythonhosted.org/packages/91/21/b2682e06657570fefe868b94cee40f269669c3021b5090cd8f6f0a0331d5/OpenOA-3.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-06 00:12:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "NREL",
"github_project": "OpenOA",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "openoa"
}
