windpowerlib
Update release
Die Windpowerlib ist eine Bibliothek, die eine Reihe von Funktionen und Klassen zur Berechnung der Leistung von Windkraftanlagen bietet. Es war ursprünglich Teil des Feedinlibs (Windkraft und Photovoltaik), wurde jedoch herausgenommen, um eine Gemeinschaft aufzubauen, die sich auf Windkraftmodelle konzentrierte.
Für einen kurzen Start sehen Sie sich die Beispiele und den grundlegenden Abschnitt "Nutzung" an.
Die vollständige Dokumentation finden Sie in RededheDocs.
Verwenden Sie die Projektseite von RedeTHEDOCs, um die Version der Dokumentation auszuwählen. Gehen Sie zur Download -Seite, um verschiedene Versionen und Formate (PDF, HTML, EPUB) der Dokumentation herunterzuladen.
Wenn Sie eine funktionierende Python 3 -Umgebung haben, verwenden Sie PYPI, um die neueste Windpowerlib -Version zu installieren:
PIP Installation Windpowerlib
Die Windpowerlib ist für Python 3 ausgelegt und auf Python> = 3.10 getestet. Wir empfehlen dringend, virtuelle Umgebungen zu nutzen. In der Installationsseite der OEMOF -Dokumentation finden Sie vollständige Anweisungen zur Installation von Python und einer virtuellen Umgebung in Ihrem Betriebssystem.
Um die Diagramme des Beispiels des Windpowerlibs in den Beispielen und den Grundnutzungsabschnitt zu sehen, sollten Sie das Matplotlib -Paket installieren. Matplotlib kann mit PIP installiert werden:
PIP Installieren Sie Matplotlib
Der einfachste Weg, die Beispiel -Notizbücher auszuführen, ohne Windpowerlib zu installieren, besteht darin, hier zu klicken und sie mit Binder zu öffnen.
Die grundlegende Verwendung des Windpowerlibs wird im ModelChain -Beispiel angezeigt, das als Jupyter -Notebook und Python -Skript verfügbar ist:
Um das Beispiel auszuführen, benötigen Sie ein Beispielwetter, das automatisch heruntergeladen wird und auch hier heruntergeladen werden kann:
Um die Beispiele vor Ort auszuführen, müssen Sie die Windpowerlib installieren. Um das Notebook auszuführen, müssen Sie auch Notebook mit PIP3 installieren. So starten Sie das Jupyter -Notizbuch jupyter notebook im Terminal. Dadurch wird ein Browserfenster geöffnet. Navigieren Sie zum Verzeichnis, das das Notizbuch enthält, um es zu öffnen. Weitere Informationen zum Installieren und zum Ausführen von Jupyter -Notizbüchern finden Sie im Jupyter Notebook Quick Start Guide. Um die Figuren in einem Notebook zu reproduzieren, müssen Sie Matplotlib installieren.
Weitere Funktionen wie die Modellierung von Windparks und Windkraftanlagen sind im Turbineclustermodelchain -Beispiel gezeigt. Als ModelChain -Beispiel ist es als Jupyter -Notizbuch und als Python -Skript verfügbar. Das in diesem Beispiel verwendete Wetter ist das gleiche wie im ModelChain -Beispiel.
Sie können sich auch die Beispiele im Abschnitt Beispiele ansehen.
Die Windpowerlib liefert Daten vieler Windturbinen, aber es ist auch möglich, Ihre eigenen Turbinendaten zu verwenden.
Die Windpowerlib liefert Windturbinendaten (Leistungskurven, Hubhöhen usw.) für einen großen Satz von Windkraftanlagen. Siehe Initialisieren Sie die Windkraftanlage In Beispiele, um diese Daten in Ihren Simulationen zu verwenden.
Der Datensatz wird in der OpenEnergy -Datenbank (OEDB) gehostet und verwaltet. Um Ihre lokalen Dateien mit der neuesten Version der OEDB -Turbinenbibliothek zu aktualisieren, können Sie Folgendes in Ihrer Python -Konsole ausführen:
from windpowerlib . data import store_turbine_data_from_oedb
store_turbine_data_from_oedb ()Wenn Sie Ihre Turbine in der Datenbank finden, ist es sehr einfach, sie in der Windpowerlib zu verwenden
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 )Wir möchten jeden ermutigen, in die Turbinenbibliothek beizutragen, indem wir Turbinendaten oder Meldungsfehler in den Daten hinzufügen. Weitere Informationen zum Beitrag finden Sie im OEP.
Es ist möglich, Ihre eigene Leistungskurve zu verwenden. Die nachhaltigste Möglichkeit besteht jedoch darin, uns die Daten zu senden, die in die Windpowerlib aufgenommen werden und für alle Benutzer verfügbar sind. Dies ist möglicherweise nicht in allen Fällen möglich.
Unter der Annahme, dass die Datendateien so aussehen:
Wind, Kraft 0,0,0,0 3.0,39000.0 5.0.270000.0 10.0.2250000.0 15.0.4500000.0 25.0.4500000.0
Sie können Pandas verwenden, um die Datei zu lesen und an das Turbinenwörterbuch weiterzugeben. Wenn Sie grundlegende Kenntnisse über Pandas haben. Es ist einfach, jede Art von Datendatei zu verwenden.
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 )Weitere Informationen finden Sie im ModelChain_example.
Wir begrüßen alle alle, die zum Windpowerlib beitragen wollen. Wenn Sie an Windmodellen interessiert sind und bei der Verbesserung des vorhandenen Modells helfen möchten, kontaktieren Sie uns nicht über GitHub oder E-Mail ([email protected]).
Klon: https://github.com/wind-python/windpowerlib und installieren Sie das geklonte Repository mit PIP:
pip install -e /path/to/the/repositoryAls die Windpowerlib mit Mitwirkenden der OEMOF -Entwicklergruppe begann, verwenden wir dieselben Entwicklerregeln.
So erstellen Sie eine Pull -Anfrage:
Im Allgemeinen sind die folgenden Schritte beim Ändern, Hinzufügen oder Entfernen von Code erforderlich:
pytestWir verwenden das Zenodo -Projekt, um für jede Version einen DOI zu erhalten. Suchen Sie Zenodo nach dem richtigen Zitat Ihrer Windpowerlib -Version.
Copyright (C) 2019 OEMOF Developer Group
Die Erlaubnis wird hiermit einer Person, die eine Kopie dieser Software und zugehörigen Dokumentationsdateien (der "Software") erhält, kostenlos erteilt, um die Software ohne Einschränkung zu behandeln, einschließlich ohne Einschränkung der Rechte, zu verwenden, zu kopieren, zu modifizieren, zusammenzufassen, zu veröffentlichen, zu veröffentlichen, zu verteilen, zu verteilt, und/oder Kopien der Software zu ermöglichen, um Personen zu beanstanden, an denen die Software zugänglich ist, um die folgenden Bedingungen zu beantragen.
Die oben genannte Copyright -Mitteilung und diese Erlaubnisbekanntmachung müssen in alle Kopien oder wesentlichen Teile der Software enthalten sein.
Die Software wird "wie es ist" ohne Garantie jeglicher Art, ausdrücklich oder stillschweigend bereitgestellt, einschließlich, aber nicht beschränkt auf die Gewährleistung der Handelsfähigkeit, die Eignung für einen bestimmten Zweck und die Nichtverletzung. In keinem Fall sind die Autoren oder Urheberrechtsinhaber für Ansprüche, Schäden oder andere Haftungen haftbar, sei es in einer Vertragsklage, unerbittlich oder auf andere Weise, die sich aus oder im Zusammenhang mit der Software oder anderen Geschäften in der Software ergeben.
