# Welcome to foxes
## Overview
The software `foxes` is a modular wind farm simulation and wake modelling toolbox which is based on engineering wake models. It has many applications, for example
- Wind farm optimization, e.g. layout optimization or wake steering,
- Wind farm post-construction analysis,
- Wake model studies, comparison and validation,
- Wind farm simulations invoking complex model chains.
The calculation is fully vectorized and its fast performance is owed to [dask](https://www.dask.org/). Also the parallelization on local or remote clusters is enabled via `dask`. The wind farm
optimization capabilities invoke the [iwopy](https://github.com/FraunhoferIWES/iwopy) package which
as well supports vectorization.
`foxes` is build upon many years of experience with wake model code development at IWES, starting with the C++ based in-house code _flapFOAM_ (2011-2019) and the Python based direct predecessor _flappy_ (2019-2022).
Documentation: [https://fraunhoferiwes.github.io/foxes.docs/index.html](https://fraunhoferiwes.github.io/foxes.docs/index.html)
Source code: [https://github.com/FraunhoferIWES/foxes](https://github.com/FraunhoferIWES/foxes)
PyPi reference: [https://pypi.org/project/foxes/](https://pypi.org/project/foxes/)
Anaconda reference: [https://anaconda.org/conda-forge/foxes](https://anaconda.org/conda-forge/foxes)
## Citation
Please cite the JOSS paper `"FOXES: Farm Optimization and eXtended yield
Evaluation Software"`
[](https://doi.org/10.21105/joss.05464)
Bibtex:
```
@article{
Schmidt2023,
author = {Jonas Schmidt and Lukas Vollmer and Martin Dörenkämper and Bernhard Stoevesandt},
title = {FOXES: Farm Optimization and eXtended yield Evaluation Software},
doi = {10.21105/joss.05464},
url = {https://doi.org/10.21105/joss.05464},
year = {2023},
publisher = {The Open Journal},
volume = {8},
number = {86},
pages = {5464},
journal = {Journal of Open Source Software}
}
```
## Installation via pip
The supported Python versions are:
- `Python 3.8`
- `Python 3.9`
- `Python 3.10`
- `Python 3.11`
- `Python 3.12`
### Virtual Python environment
First create a new `venv` environment, for example called `foxes` and located at `~/venv/foxes` (choose any other convenient name and location in your file system if you prefer), by
```console
python3 -m venv ~/venv/foxes
```
Then activate the environment every time you work with `foxes`, by
```console
source ~/venv/foxes/bin/activate
```
You can leave the environment by
```console
deactivate
```
The `pip` installation commands below should be executed within the active `foxes` environment.
### Standard users
As a standard user, you can install the latest release via [pip](https://pypi.org/project/foxes/) by
```console
pip install foxes
```
This commands installs the version that correspond to the `main` branch at [github](https://github.com/FraunhoferIWES/foxes). Alternatively, you can decide to install the latest pre-release developments (non-stable) by
```console
pip install git+https://github.com/FraunhoferIWES/foxes@dev#egg=foxes
```
### Developers
For developers using `pip`, simply invoke the `-e` flag in the installation command in your local clone:
```console
git clone https://github.com/FraunhoferIWES/foxes.git
cd foxes
pip install -e .
```
The last line makes sure that all your code changes are included whenever importing `foxes`. Concerning the `git clone` line, we actually recommend that you fork `foxes` on GitHub and then replace that command by cloning your fork instead.
## Installation via conda
The supported Python versions are:
- `Python 3.8`
- `Python 3.9`
- `Python 3.10`
- `Python 3.11`
- `Python 3.12`
### Preparation
It is strongly recommend to use the `libmamba` dependency solver instead of the default solver. Install it once by
```console
conda install conda-libmamba-solver -n base -c conda-forge
```
We recommend that you set this to be your default solver, by
```console
conda config --set solver libmamba
```
### Virtual Python environment
First create a new `conda` environment, for example called `foxes`, by
```console
conda create -n foxes -c conda-forge
```
Then activate the environment every time you work with `foxes`, by
```console
conda activate foxes
```
You can leave the environment by
```console
conda deactivate
```
The `conda` installation commands below should be executed within the active `foxes` environment.
### Standard users
The `foxes` package is available on the channel [conda-forge](https://anaconda.org/conda-forge/foxes). You can install the latest version by
```console
conda install foxes -c conda-forge --solver=libmamba
```
The `--solver=libmamba` is optional. Note that it is not necessary if you have set the `libmamba` solver as your default, see above.
### Developers
For developers using `conda`, we recommend first installing foxes as described above, then removing only the `foxes` package while keeping the dependencies, and then adding `foxes` again from a git using `conda develop`:
```console
conda install foxes conda-build -c conda-forge --solver=libmamba
conda remove foxes --force
git clone https://github.com/FraunhoferIWES/foxes.git
cd foxes
conda develop .
```
The last line makes sure that all your code changes are included whenever importing `foxes`. The `--solver=libmamba` is optional. Note that it is not necessary if you have set the `libmamba` solver as your default, see above.
Concerning the `git clone` line, we actually recommend that you fork `foxes` on GitHub and then replace that command by cloning your fork instead.
## Usage
For detailed examples of how to run _foxes_, check the `examples` and `notebooks` folders in this repository. A minimal running example is the following, based on provided static `csv` data files:
```python
import foxes
states = foxes.input.states.Timeseries("timeseries_3000.csv.gz", ["WS", "WD","TI","RHO"])
farm = foxes.WindFarm()
foxes.input.farm_layout.add_from_file(farm, "test_farm_67.csv", turbine_models=["NREL5MW"])
algo = foxes.algorithms.Downwind(farm, states, ["Jensen_linear_k007"])
farm_results = algo.calc_farm()
print(farm_results)
```
## Testing
For testing, please clone the repository and install the required dependencies:
```console
git clone https://github.com/FraunhoferIWES/foxes.git
cd foxes
pip install -e .[test]
```
The tests are then run by
```console
pytest tests
```
## Contributing
1. Fork _foxes_ on _github_.
2. Create a branch (`git checkout -b new_branch`)
3. Commit your changes (`git commit -am "your awesome message"`)
4. Push to the branch (`git push origin new_branch`)
5. Create a pull request [here](https://github.com/FraunhoferIWES/foxes/pulls)
## Acknowledgements
The development of _foxes_ and its predecessors _flapFOAM_ and _flappy_ (internal - non public) has been supported through multiple publicly funded research projects. We acknowledge in particular the funding by the Federal Ministry of Economic Affairs and Climate Action (BMWK) through the projects _Smart Wind Farms_ (grant no. 0325851B), _GW-Wakes_ (0325397B) and _X-Wakes_ (03EE3008A), as well as the funding by the Federal Ministry of Education and Research (BMBF) in the framework of the project _H2Digital_ (03SF0635). We furthermore acknowledge funding by the Horizon Europe project FLOW (Atmospheric Flow, Loads and pOwer
for Wind energy - grant id 101084205).
Raw data
{
"_id": null,
"home_page": null,
"name": "foxes",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "Wind farm, Wake modelling, Wind farm optimization",
"author": "Fraunhofer IWES",
"author_email": "jonas.schmidt@iwes.fraunhofer.de",
"download_url": "https://files.pythonhosted.org/packages/e1/80/b88b1d7016c9406b36b569e332bf02b66f26b25d90a5ecb2d506731df82d/foxes-0.7.0.6.tar.gz",
"platform": null,
"description": "# Welcome to foxes\n\n\n\n## Overview\n\nThe software `foxes` is a modular wind farm simulation and wake modelling toolbox which is based on engineering wake models. It has many applications, for example\n\n- Wind farm optimization, e.g. layout optimization or wake steering,\n- Wind farm post-construction analysis,\n- Wake model studies, comparison and validation,\n- Wind farm simulations invoking complex model chains.\n\nThe calculation is fully vectorized and its fast performance is owed to [dask](https://www.dask.org/). Also the parallelization on local or remote clusters is enabled via `dask`. The wind farm\noptimization capabilities invoke the [iwopy](https://github.com/FraunhoferIWES/iwopy) package which\nas well supports vectorization.\n\n`foxes` is build upon many years of experience with wake model code development at IWES, starting with the C++ based in-house code _flapFOAM_ (2011-2019) and the Python based direct predecessor _flappy_ (2019-2022).\n\nDocumentation: [https://fraunhoferiwes.github.io/foxes.docs/index.html](https://fraunhoferiwes.github.io/foxes.docs/index.html)\n\nSource code: [https://github.com/FraunhoferIWES/foxes](https://github.com/FraunhoferIWES/foxes)\n\nPyPi reference: [https://pypi.org/project/foxes/](https://pypi.org/project/foxes/)\n\nAnaconda reference: [https://anaconda.org/conda-forge/foxes](https://anaconda.org/conda-forge/foxes)\n\n## Citation\n\nPlease cite the JOSS paper `\"FOXES: Farm Optimization and eXtended yield\nEvaluation Software\"` \n\n [](https://doi.org/10.21105/joss.05464)\n\n Bibtex:\n ```\n@article{\n Schmidt2023, \n author = {Jonas Schmidt and Lukas Vollmer and Martin D\u00f6renk\u00e4mper and Bernhard Stoevesandt}, \n title = {FOXES: Farm Optimization and eXtended yield Evaluation Software}, \n doi = {10.21105/joss.05464}, \n url = {https://doi.org/10.21105/joss.05464}, \n year = {2023}, \n publisher = {The Open Journal}, \n volume = {8}, \n number = {86}, \n pages = {5464}, \n journal = {Journal of Open Source Software} \n}\n ```\n\n## Installation via pip\n\nThe supported Python versions are: \n\n- `Python 3.8`\n- `Python 3.9`\n- `Python 3.10`\n- `Python 3.11`\n- `Python 3.12`\n\n### Virtual Python environment\n\nFirst create a new `venv` environment, for example called `foxes` and located at `~/venv/foxes` (choose any other convenient name and location in your file system if you prefer), by\n\n```console\npython3 -m venv ~/venv/foxes\n```\n\nThen activate the environment every time you work with `foxes`, by\n\n```console\nsource ~/venv/foxes/bin/activate\n```\n\nYou can leave the environment by\n\n```console\ndeactivate\n```\n\nThe `pip` installation commands below should be executed within the active `foxes` environment.\n\n### Standard users\n\nAs a standard user, you can install the latest release via [pip](https://pypi.org/project/foxes/) by\n\n```console\npip install foxes\n```\n\nThis commands installs the version that correspond to the `main` branch at [github](https://github.com/FraunhoferIWES/foxes). Alternatively, you can decide to install the latest pre-release developments (non-stable) by\n\n```console\npip install git+https://github.com/FraunhoferIWES/foxes@dev#egg=foxes\n```\n\n### Developers\n\nFor developers using `pip`, simply invoke the `-e` flag in the installation command in your local clone:\n\n```console\ngit clone https://github.com/FraunhoferIWES/foxes.git\ncd foxes\npip install -e .\n```\nThe last line makes sure that all your code changes are included whenever importing `foxes`. Concerning the `git clone` line, we actually recommend that you fork `foxes` on GitHub and then replace that command by cloning your fork instead.\n\n## Installation via conda\n\nThe supported Python versions are: \n\n- `Python 3.8`\n- `Python 3.9`\n- `Python 3.10`\n- `Python 3.11`\n- `Python 3.12`\n\n### Preparation\n\nIt is strongly recommend to use the `libmamba` dependency solver instead of the default solver. Install it once by\n\n```console\nconda install conda-libmamba-solver -n base -c conda-forge\n```\n\nWe recommend that you set this to be your default solver, by\n\n```console\nconda config --set solver libmamba\n```\n\n### Virtual Python environment\n\nFirst create a new `conda` environment, for example called `foxes`, by\n\n```console\nconda create -n foxes -c conda-forge\n```\n\nThen activate the environment every time you work with `foxes`, by\n\n```console\nconda activate foxes\n```\n\nYou can leave the environment by\n\n```console\nconda deactivate\n```\n\nThe `conda` installation commands below should be executed within the active `foxes` environment.\n\n### Standard users\n\nThe `foxes` package is available on the channel [conda-forge](https://anaconda.org/conda-forge/foxes). You can install the latest version by\n\n```console\nconda install foxes -c conda-forge --solver=libmamba\n```\n\nThe `--solver=libmamba` is optional. Note that it is not necessary if you have set the `libmamba` solver as your default, see above.\n\n### Developers\n\nFor developers using `conda`, we recommend first installing foxes as described above, then removing only the `foxes` package while keeping the dependencies, and then adding `foxes` again from a git using `conda develop`:\n\n```console\nconda install foxes conda-build -c conda-forge --solver=libmamba\nconda remove foxes --force\ngit clone https://github.com/FraunhoferIWES/foxes.git\ncd foxes\nconda develop .\n```\n\nThe last line makes sure that all your code changes are included whenever importing `foxes`. The `--solver=libmamba` is optional. Note that it is not necessary if you have set the `libmamba` solver as your default, see above.\n\nConcerning the `git clone` line, we actually recommend that you fork `foxes` on GitHub and then replace that command by cloning your fork instead.\n\n## Usage\n\nFor detailed examples of how to run _foxes_, check the `examples` and `notebooks` folders in this repository. A minimal running example is the following, based on provided static `csv` data files:\n\n```python\nimport foxes\n\nstates = foxes.input.states.Timeseries(\"timeseries_3000.csv.gz\", [\"WS\", \"WD\",\"TI\",\"RHO\"])\n\nfarm = foxes.WindFarm()\nfoxes.input.farm_layout.add_from_file(farm, \"test_farm_67.csv\", turbine_models=[\"NREL5MW\"])\n\nalgo = foxes.algorithms.Downwind(farm, states, [\"Jensen_linear_k007\"])\nfarm_results = algo.calc_farm()\n\nprint(farm_results)\n```\n\n## Testing\n\nFor testing, please clone the repository and install the required dependencies:\n```console\ngit clone https://github.com/FraunhoferIWES/foxes.git\ncd foxes\npip install -e .[test]\n```\n\nThe tests are then run by\n```console\npytest tests\n```\n\n## Contributing\n\n1. Fork _foxes_ on _github_.\n2. Create a branch (`git checkout -b new_branch`)\n3. Commit your changes (`git commit -am \"your awesome message\"`)\n4. Push to the branch (`git push origin new_branch`)\n5. Create a pull request [here](https://github.com/FraunhoferIWES/foxes/pulls)\n\n## Acknowledgements\n\nThe development of _foxes_ and its predecessors _flapFOAM_ and _flappy_ (internal - non public) has been supported through multiple publicly funded research projects. We acknowledge in particular the funding by the Federal Ministry of Economic Affairs and Climate Action (BMWK) through the projects _Smart Wind Farms_ (grant no. 0325851B), _GW-Wakes_ (0325397B) and _X-Wakes_ (03EE3008A), as well as the funding by the Federal Ministry of Education and Research (BMBF) in the framework of the project _H2Digital_ (03SF0635). We furthermore acknowledge funding by the Horizon Europe project FLOW (Atmospheric Flow, Loads and pOwer \nfor Wind energy - grant id 101084205).\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Farm Optimization and eXtended yield Evaluation Software",
"version": "0.7.0.6",
"project_urls": {
"Bug Tracker": "https://github.com/FraunhoferIWES/foxes/issues",
"Documentation": "https://fraunhoferiwes.github.io/foxes.docs/index.html",
"Source Code": "https://github.com/FraunhoferIWES/foxes"
},
"split_keywords": [
"wind farm",
" wake modelling",
" wind farm optimization"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2aa1d2a8aa1ff86f483f6d95cb3d1c84d408cfd9c4abf34ac02b7b4431eab386",
"md5": "595235e2e762c8afef9aece159727813",
"sha256": "480cc517deaa6593f473bc4ba317dd6963cf361e787857f165a9f0c93c73fc24"
},
"downloads": -1,
"filename": "foxes-0.7.0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "595235e2e762c8afef9aece159727813",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 998895,
"upload_time": "2024-05-08T17:22:05",
"upload_time_iso_8601": "2024-05-08T17:22:05.431176Z",
"url": "https://files.pythonhosted.org/packages/2a/a1/d2a8aa1ff86f483f6d95cb3d1c84d408cfd9c4abf34ac02b7b4431eab386/foxes-0.7.0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "e180b88b1d7016c9406b36b569e332bf02b66f26b25d90a5ecb2d506731df82d",
"md5": "f47d28218856398f83e3d9e11965d92d",
"sha256": "dd5d0f71117cc844f80a4018569dcb28884e208fd058ec7b3f2311015239aa35"
},
"downloads": -1,
"filename": "foxes-0.7.0.6.tar.gz",
"has_sig": false,
"md5_digest": "f47d28218856398f83e3d9e11965d92d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 869346,
"upload_time": "2024-05-08T17:22:08",
"upload_time_iso_8601": "2024-05-08T17:22:08.151468Z",
"url": "https://files.pythonhosted.org/packages/e1/80/b88b1d7016c9406b36b569e332bf02b66f26b25d90a5ecb2d506731df82d/foxes-0.7.0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-08 17:22:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "FraunhoferIWES",
"github_project": "foxes",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "foxes"
}
JSON
