windpowerlib
Update release
Le WindpowerLib est une bibliothèque qui fournit un ensemble de fonctions et de classes pour calculer la puissance des éoliennes. Il faisait à l'origine partie de la Feedinlib (éolienne et photovoltaïque) mais a été retiré pour construire une communauté se concentrant sur les modèles d'énergie éolienne.
Pour un démarrage rapide, consultez les exemples et la section d'utilisation de base.
La documentation complète peut être trouvée sur ReadTheDocs.
Utilisez le site du projet de ReadTheDocs pour choisir la version de la documentation. Accédez à la page de téléchargement pour télécharger différentes versions et formats (PDF, HTML, EPUB) de la documentation.
Si vous avez un environnement Python 3 fonctionnel, utilisez PYPI pour installer la dernière version de WindpowerLib:
pip install windpowerlib
Le WindpowerLib est conçu pour Python 3 et testé sur Python> = 3,10. Nous vous recommandons fortement d'utiliser des environnements virtuels. Veuillez consulter la page d'installation de la documentation OEMOF pour des instructions complètes sur la façon d'installer Python et un environnement virtuel sur votre système d'exploitation.
Pour voir les parcelles de l'exemple WindpowerLib dans la section Exemples et utilisation de base, vous devez installer le package Matplotlib. Matplotlib peut être installé à l'aide de PIP:
PIP installe Matplotlib
La façon la plus simple d'exécuter l'exemple de cahiers sans installer WindpowerLib est de cliquer ici et de les ouvrir avec Binder.
L'utilisation de base du WindpowerLib est affichée dans l'exemple ModelChain qui est disponible en tant que cahier Jupyter et script Python:
Pour exécuter l'exemple, vous avez besoin d'exemple de temps téléchargé automatiquement et peut également être téléchargé ici:
Pour exécuter les exemples localement, vous devez installer le WindpowerLib. Pour exécuter le cahier, vous devez également installer un cahier à l'aide de PIP3. Pour lancer Jupyter Notebook Type jupyter notebook dans le terminal. Cela ouvrira une fenêtre de navigateur. Accédez au répertoire contenant le cahier pour l'ouvrir. Consultez le guide de démarrage rapide du cahier Jupyter pour plus d'informations sur la façon d'installer et comment exécuter des cahiers Jupyter. Afin de reproduire les chiffres d'un ordinateur portable, vous devez installer Matplotlib.
D'autres fonctionnalités, comme la modélisation des parcs éoliens et des groupes d'éoliennes, sont indiqués dans l'exemple TurbineClusterModelchain. Comme l'exemple ModelChain, il est disponible sous forme de cahier Jupyter et de script Python. Le temps utilisé dans cet exemple est le même que dans l'exemple ModelChain.
Vous pouvez également consulter les exemples dans la section Exemples.
Le WindpowerLib fournit des données de nombreuses éoliennes, mais il est également possible d'utiliser vos propres données de turbine.
Le WindpowerLib fournit des données d'éoliennes (courbes de puissance, hauteurs du moyeu, etc.) pour un grand ensemble d'éoliennes. Voir Initialiser Wind Turbine dans les exemples Section sur la façon d'utiliser ces données dans vos simulations.
L'ensemble de données est hébergé et maintenu sur la base de données OpenEnergy (OEDB). Pour mettre à jour vos fichiers locaux avec la dernière version de la bibliothèque OEDB Turbine, vous pouvez exécuter ce qui suit dans votre console Python:
from windpowerlib . data import store_turbine_data_from_oedb
store_turbine_data_from_oedb ()Si vous trouvez votre turbine dans la base de données, il est très facile de l'utiliser dans le WindpowerLib
from windpowerlib import WindTurbine
enercon_e126 = {
"turbine_type" : "E-126/4200" , # turbine type as in register
"hub_height" : 135 , # in m
}
e126 = WindTurbine ( ** enercon_e126 )Nous tenons à encourager quiconque à contribuer à la bibliothèque de turbine en ajoutant des données de turbine ou en rapportant des erreurs dans les données. Voir l'OEP pour plus d'informations sur la façon de contribuer.
Il est possible d'utiliser votre propre courbe de puissance. Cependant, le moyen le plus durable consiste à nous envoyer les données à inclure dans le WindpowerLib et à être disponibles pour tous les utilisateurs. Cela peut ne pas être possible dans tous les cas.
En supposant que les fichiers de données ressemblent à ceci:
vent, puissance 0.0,0.0 3,0 39000.0 5.0,270000.0 10.0 2250000.0 15.0 4500000.0 25.0 4500000.0
Vous pouvez utiliser des pandas pour lire le fichier et le transmettre au dictionnaire Turbine. I Vous avez des connaissances de base des pandas, il est facile d'utiliser tout type de fichier de données.
import pandas as pd
from windpowerlib import WindTurbine , create_power_curve
my_data = pd . read_csv ( "path/to/my/data/file.csv" )
my_turbine_data = {
"nominal_power" : 6e6 , # in W
"hub_height" : 115 , # in m
"power_curve" : create_power_curve (
wind_speed = my_data [ "wind" ], power = my_data [ "power" ]
),
}
my_turbine = WindTurbine ( ** my_turbine_data )Voir le ModelChain_Example pour plus d'informations.
Nous accueillons chaleureusement tous ceux qui veulent contribuer au WindpowerLib. Si vous êtes intéressé par les modèles de vent et que vous souhaitez aider à améliorer le modèle existant, n'hésitez pas à nous contacter via Github ou par e-mail ([email protected]).
Clone: https://github.com/wind-python/windpowerLib et installez le référentiel cloné à l'aide de PIP:
pip install -e /path/to/the/repositoryComme le WindpowerLib a commencé avec des contributeurs du groupe de développeurs OEMOF, nous utilisons les mêmes règles de développeur.
Comment créer une demande de traction:
Généralement, les étapes suivantes sont requises lors du changement, de l'ajout ou de la suppression du code:
pytestNous utilisons le projet Zenodo pour obtenir un DOI pour chaque version. Recherchez Zenodo pour la bonne citation de votre version WindpowerLib.
Copyright (C) Group OEMOF Developer 2019
L'autorisation est accordée gratuitement à toute personne qui obtient une copie de ce logiciel et des fichiers de documentation associés (le "logiciel"), pour traiter le logiciel sans restriction, y compris sans limiter les droits d'utilisation, de copie, de modification, de fusion, de publication, de distribution, de sublince et / ou de vendre des copies des conditions suivantes.
L'avis de droit d'auteur ci-dessus et le présent avis d'autorisation sont inclus dans toutes les copies ou des parties substantielles du logiciel.
Le logiciel est fourni "tel quel", sans garantie d'aucune sorte, express ou implicite, y compris, mais sans s'y limiter, les garanties de qualité marchande, d'adéquation à un usage particulier et de non-contrefaçon. En aucun cas, les auteurs ou les détenteurs de droits d'auteur ne seront pas responsables de toute réclamation, dommage ou autre responsabilité, que ce soit dans une action de contrat, de délit ou autre, découlant de, hors du logiciel ou de l'utilisation ou d'autres relations dans le logiciel.
