Metadata-Version: 2.1
Name: pyforwind
Version: 0.1.2
Summary: Synthetic IEC-conform wind fields with extended turbulence characteristics
Home-page: https://github.com/fiddir/pyforwind
Maintainer: Jan Friedrich
License: LGPL-3.0
Keywords: synthetic wind fields,inflow turbulence,wind energy
Platform: any
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: scipy
Requires-Dist: numpy
Requires-Dist: matplotlib
Requires-Dist: pandas

pyforwind
=========

An open-source package to generate synthetic IEC-conform wind fields with extended turbulence characteristics. 

Installation
------------

The ``pyforwind`` package is available on pypi and can be installed using pip

.. code-block:: shell

    pip install pyforwind

How to use this package
-----------------------

Generate superstatistical Kaimal wind field
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

To use ``pyforwind`` to generate a Kaimal wind field ``u_kaimal`` and its superstatistical (i.e., non-Gaussian)
extension ``u_super_kaimal``, import the ``SFW`` with the model parameters: integral length scale ``L``, intermittency coefficient ``mu``,
horizontal wind speed at rotor hub ``V_hub``, hub height ``h_hub``, time length and diameter ``(T, diam)``, resolution ``(N_T, N_rotor)``,
and the wind field type ``kind``.

.. code-block:: python

    from pyforwind import SFW

    swf_kaimal = SWF(L, mu, V_hub, h_hub, (T, diam), (N_T, N_rotor), kind='gauss')
    swf_super_kaimal = SWF(L, mu, V_hub, h_hub, (T, diam), (N_T, N_rotor), kind='spatiotemporal')
    u_kaimal = swf_kaimal.field(seed)
    u_super_kaimal = swf_super_kaimal.field(seed)

References
----------
Friedrich, J., Moreno, D., Sinhuber, M., Wächter, M., & Peinke, J. (2022). Superstatistical wind fields from pointwise atmospheric turbulence measurements. PRX Energy, 1(2), 023006.

Acknowledgments
---------------
This project is funded by the European Union Horizon Europe Framework program (HORIZON-CL5-2021-D3-03-04) under grant agreement no. 101084205, and by the German Federal Ministry for Economic Affairs and Energy in the scope of the projects EMUwind (03EE2031A/C) and PASTA (03EE2024A/B).
