--------------
```
__ _ __ __ _ __
/ /_ _____(_)___ / /_ / /__ __(_)___ ___ / /
/ __ \/ ___/ / __ \/ __ \/ __/ | /| / / / __ \/ __ /
/ /_/ / / / / /_/ / / / / /_ | |/ |/ / / / / / /_/ /
/_.___/_/ /_/\__, /_/ /_/\__/ |__/|__/_/_/ /_/\__,_/
/____/
```
**A Python library primarily for wind resource assessments.**
--------------
<br>
Brightwind is a Python library specifically built for wind analysis. It can load in wind speed, wind direction and
other metrological timeseries data. There are various plots you can use to understand this data and to find any
potential issues. You can perform many common functions to the data such as shear and long-term adjustments. The
resulting adjusted data is then outputted as a frequency distribution tab file which can be used in wind analysis
software such as WAsP.
This library can also be used for solar resource analysis.
<br>
---
### Installation
You can use pip from the command line to install the library.
```
C:\Users\Stephen> pip install brightwind
```
It is advisable to use a separate environment to avoid any dependency clashes with other libraries such as Pandas, Numpy
or Matplotlib you may already have installed.
<br>
For those that do not have Python installed and are just getting started, we recommend installing Anaconda. Anaconda is
a Python distribution for scientific computing and so provides everything you need, Python, pip and Jupyter Notebook
along with libraries such as Pandas, Numpy and Matplotlib. Datacamp provide a good tutorial for [installing
Anaconda on Windows](https://www.datacamp.com/tutorial/installing-anaconda-windows) to get started.
Once Anaconda is installed, you can use the **Anaconda Prompt** to run the above command line `pip install brightwind`.
Or first use **Anaconda Navigator** to create an environment.
---
### Documentation
Documentation on how to get setup and use the library can be found at https://brightwind-dev.github.io/brightwind-docs/
<br>
Example usage of the brightwind library is shown below using Jupyter Notebook. Jupyter Notebook is a powerful way to
immediately see the results of code you have written.
<br>
<p>
![demo_image_1](read_me_1.png)
![demo_image_2](read_me_2.png)
</p>
<br>
##### Features
The library provides wind analysts with easy to use tools for working with
meteorological data. It supports loading of meteorological data, averaging,
filtering, plotting, correlations, shear analysis, long term adjustments, etc.
The library can then export a resulting long term adjusted tab file to be used in
other wind analysis software.
<br>
##### Benefits
The key benefits to an open-source library is that it provides complete transparency
and traceability. Anyone in the industry can review any part of the code and suggest changes,
thus creating a standardised, validated toolkit for the industry.
By default, during an assessment every manipulation or adjustment made to the wind data is
contained in a single file. This can easily be reviewed and checked by internal reviewers or,
as the underlying code is open-sourced, there is no reason why this file cannot be sent to
3rd parties for review thus increasing the effectiveness of a banks due diligence.
<br>
##### License
The library is licensed under the MIT license.
<br>
---
### Test datasets
A test dataset is included in this repository and is used to demonstrate function and test functions in the code.
Other files and datasets are also included to complement this demo dataset. These are outlined below:
<br>
| Dataset | Source | Notes |
|:--------------------- |:-------------|:-----|
| demo_data.csv | BrightWind | A modified 2 year met mast dataset in csv and Campbell Scientific format. |
| MERRA-2_XX_2000-01-01_2017-06-30.csv | NASA [GES DISC](https://disc.gsfc.nasa.gov/) | 4 x MERRA-2 18-yr datasets to complement the demo data for long term analyses. |
| demo_cleaning_file.csv | BrightWind | A file containing information on what periods to clean out from the demo data. |
| windographer_flagging_log.txt | BrightWind | The same cleaning info as found in 'demo_cleaning_file.csv' formatted as a Windographer flagging file. |
| demo_data_iea43_wra_data_model.json | BrightWind | A JSON file formatted according to the IEA Wind Task 43 [WRA Data Model](https://github.com/IEA-Task-43/digital_wra_data_standard) standard which describes the mast configuration for the demo data. |
<br>
---
### Contributing
If you wish to be involved or find out more please contact stephen@brightwindanalysis.com.
More information can be found in the [contributing.md](https://github.com/brightwind-dev/brightwind/blob/master/contributing.md) section of the website.
<br>
Raw data
{
"_id": null,
"home_page": "https://github.com/brightwind-dev/brightwind.git",
"name": "brightwind",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "BRIGHT, WIND, RESOURCE, DATA, ANALYSTS, PROCESSING, WASP, ROSE, WINDFARMER, OPENWIND, WIND PRO, WINDOGRAPHER",
"author": "Stephen Holleran of BrightWind Ltd",
"author_email": "stephen@brightwindanalysis.com",
"download_url": "https://files.pythonhosted.org/packages/12/30/fd0a49593d28f29d6e654b8fd9f148dbe8b29ca3691bb7393547cd09d0b7/brightwind-2.2.1.tar.gz",
"platform": null,
"description": "--------------\n```\n __ _ __ __ _ __\n / /_ _____(_)___ / /_ / /__ __(_)___ ___ / /\n / __ \\/ ___/ / __ \\/ __ \\/ __/ | /| / / / __ \\/ __ /\n / /_/ / / / / /_/ / / / / /_ | |/ |/ / / / / / /_/ /\n /_.___/_/ /_/\\__, /_/ /_/\\__/ |__/|__/_/_/ /_/\\__,_/\n /____/\n ```\n **A Python library primarily for wind resource assessments.**\n\n--------------\n\n<br>\n\nBrightwind is a Python library specifically built for wind analysis. It can load in wind speed, wind direction and \nother metrological timeseries data. There are various plots you can use to understand this data and to find any \npotential issues. You can perform many common functions to the data such as shear and long-term adjustments. The \nresulting adjusted data is then outputted as a frequency distribution tab file which can be used in wind analysis \nsoftware such as WAsP.\n\nThis library can also be used for solar resource analysis.\n\n<br>\n\n---\n### Installation\n\nYou can use pip from the command line to install the library.\n\n```\nC:\\Users\\Stephen> pip install brightwind\n```\nIt is advisable to use a separate environment to avoid any dependency clashes with other libraries such as Pandas, Numpy \nor Matplotlib you may already have installed.\n\n<br>\n\nFor those that do not have Python installed and are just getting started, we recommend installing Anaconda. Anaconda is \na Python distribution for scientific computing and so provides everything you need, Python, pip and Jupyter Notebook \nalong with libraries such as Pandas, Numpy and Matplotlib. Datacamp provide a good tutorial for [installing \nAnaconda on Windows](https://www.datacamp.com/tutorial/installing-anaconda-windows) to get started.\n\nOnce Anaconda is installed, you can use the **Anaconda Prompt** to run the above command line `pip install brightwind`. \nOr first use **Anaconda Navigator** to create an environment.\n\n---\n### Documentation\n\nDocumentation on how to get setup and use the library can be found at https://brightwind-dev.github.io/brightwind-docs/\n\n<br>\n\nExample usage of the brightwind library is shown below using Jupyter Notebook. Jupyter Notebook is a powerful way to \nimmediately see the results of code you have written.\n<br>\n\n<p>\n\n![demo_image_1](read_me_1.png)\n![demo_image_2](read_me_2.png)\n</p>\n\n\n\n\n<br>\n\n##### Features\nThe library provides wind analysts with easy to use tools for working with\nmeteorological data. It supports loading of meteorological data, averaging,\nfiltering, plotting, correlations, shear analysis, long term adjustments, etc.\nThe library can then export a resulting long term adjusted tab file to be used in\nother wind analysis software.\n\n<br>\n\n##### Benefits\nThe key benefits to an open-source library is that it provides complete transparency\nand traceability. Anyone in the industry can review any part of the code and suggest changes,\nthus creating a standardised, validated toolkit for the industry.\n\nBy default, during an assessment every manipulation or adjustment made to the wind data is\ncontained in a single file. This can easily be reviewed and checked by internal reviewers or,\nas the underlying code is open-sourced, there is no reason why this file cannot be sent to\n3rd parties for review thus increasing the effectiveness of a banks due diligence.\n\n<br>\n\n##### License\nThe library is licensed under the MIT license.\n\n<br>\n\n---\n### Test datasets\nA test dataset is included in this repository and is used to demonstrate function and test functions in the code. \nOther files and datasets are also included to complement this demo dataset. These are outlined below:\n\n<br>\n\n| Dataset | Source | Notes |\n|:--------------------- |:-------------|:-----|\n| demo_data.csv | BrightWind | A modified 2 year met mast dataset in csv and Campbell Scientific format. |\n| MERRA-2_XX_2000-01-01_2017-06-30.csv | NASA [GES DISC](https://disc.gsfc.nasa.gov/) | 4 x MERRA-2 18-yr datasets to complement the demo data for long term analyses. |\n| demo_cleaning_file.csv | BrightWind | A file containing information on what periods to clean out from the demo data. |\n| windographer_flagging_log.txt | BrightWind | The same cleaning info as found in 'demo_cleaning_file.csv' formatted as a Windographer flagging file. |\n| demo_data_iea43_wra_data_model.json | BrightWind | A JSON file formatted according to the IEA Wind Task 43 [WRA Data Model](https://github.com/IEA-Task-43/digital_wra_data_standard) standard which describes the mast configuration for the demo data. |\n\n<br>\n\n---\n### Contributing\nIf you wish to be involved or find out more please contact stephen@brightwindanalysis.com.\n\nMore information can be found in the [contributing.md](https://github.com/brightwind-dev/brightwind/blob/master/contributing.md) section of the website.\n\n<br>\n\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Scripts for wind resource data processing.",
"version": "2.2.1",
"project_urls": {
"Download": "https://github.com/brightwind-dev/brightwind/archive/v2.2.1.tar.gz",
"Homepage": "https://github.com/brightwind-dev/brightwind.git"
},
"split_keywords": [
"bright",
" wind",
" resource",
" data",
" analysts",
" processing",
" wasp",
" rose",
" windfarmer",
" openwind",
" wind pro",
" windographer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "91287df5fcbb28ac93f2b08f6820f095496347e5f1fb4befee222a339142dbc3",
"md5": "be317d76d47a8e965b2b9d508cfe2531",
"sha256": "42d92662513595cdb8eac180e5f5ad3b817e71b44396c22bd6bd201a5558e1c3"
},
"downloads": -1,
"filename": "brightwind-2.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "be317d76d47a8e965b2b9d508cfe2531",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 32774307,
"upload_time": "2024-05-29T14:33:05",
"upload_time_iso_8601": "2024-05-29T14:33:05.486499Z",
"url": "https://files.pythonhosted.org/packages/91/28/7df5fcbb28ac93f2b08f6820f095496347e5f1fb4befee222a339142dbc3/brightwind-2.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1230fd0a49593d28f29d6e654b8fd9f148dbe8b29ca3691bb7393547cd09d0b7",
"md5": "989355891544aec31111d3ef168c6a70",
"sha256": "10257ba0d7872cb3a679b224f67ca155c9ecb816ca711ae92eef9f738e9ce8b5"
},
"downloads": -1,
"filename": "brightwind-2.2.1.tar.gz",
"has_sig": false,
"md5_digest": "989355891544aec31111d3ef168c6a70",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 32430509,
"upload_time": "2024-05-29T14:33:20",
"upload_time_iso_8601": "2024-05-29T14:33:20.568368Z",
"url": "https://files.pythonhosted.org/packages/12/30/fd0a49593d28f29d6e654b8fd9f148dbe8b29ca3691bb7393547cd09d0b7/brightwind-2.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-29 14:33:20",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "brightwind-dev",
"github_project": "brightwind",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "brightwind"
}