Update V1.5

README.md

@@ -3,64 +3,65 @@
 
 # solXpect
 
-solXpect forecasts the output of your solar power plant
-
-This app takes direct and diffuse radiation data from Open-Meteo.com, calculates the position
-of the sun and projects the radiation on your solar panel.
-It shows the estimated energy production for the next hours and up to 16 days.
-The hourly values are calculated for the preceding hour. So if there are 150 Wh shown at 11:00 this means you can expect 150 Wh between 10:00 and 11:00.
-
-If you have several modules pointing in different directions you can define them as separate locations and switch on 'show sum' in preferences. Then
-all locations with same latitude/longitude are summarized. In this case you should define your location names as 'myPV | part1', 'myPV | part2', etc.
-In 'show sum' mode the location is then shown as 'myPV' and '|' is taken as delimiter in this case.
+solXpect is an app that forecasts the output of your solar power plant by using direct and diffuse radiation data from Open-Meteo.com, calculating the position of the sun, and projecting the radiation on your solar panel. 
+It shows the estimated energy production for the next 16 days, with hourly values calculated for the preceding hour. As an example, if there are 150 Wh shown at 11:00 this means you can expect 150 Wh between 10:00 and 11:00.
+To use solXpect, you simply enter your latitude and longitude coordinates, as well as the azimuth and tilt of your solar panel. 
+You also enter information about the peak power, efficiency, temperature coefficient, and area of your solar panel, as well as the maximum power and efficiency of your inverter.
+Additionally, solXpect allows you to define shading on your solar panels by specifying the minimum elevation of the sun necessary for the sun to hit the solar panels, as well as the percentage of shading for elevations below this value.
+If you have multiple solar panels with the same latitude and longitude but pointing in different directions, you can define them as separate locations and use the 'show sum' feature to summarize their output.
+Overall, solXpect is a powerful tool for optimizing the use of your own energy and reduce your energy costs. 
 
 <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/01.png" width="150"/> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/02.png" width="150"/> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/03.png" width="150"/> <img src="fastlane/metadata/android/en-US/images/phoneScreenshots/04.png" width="150"/> 
 
 [<img src="https://fdroid.gitlab.io/artwork/badge/get-it-on.png" height="75">](https://f-droid.org/de/packages/org.woheller69.solxpect/)
 
 ## Parameters
 
+#### Name
+Define a name for the location.
+If you have several modules pointing in different directions at the same location you can activate "showSum" mode in settings.
+In this case you should define your location names as 'myPV | part1', 'myPV | part2', etc. In 'show sum' mode the location is then shown as 'myPV' and '|' is taken as delimiter.
+
 #### Latitude [°] 
-Latitude specifies the north–south position of your solar power plant. It ranges from –90° at the south pole to 90° at the north pole.
+Enter the north-south position of your solar power plant, ranging from -90° at the south pole to 90° at the north pole.
 
 #### Longitude [°]
-Longitude specifies the east–west position of your solar power plant. The prime meridian defines 0° longitude. Positive longitudes are east of the prime meridian, negative ones are west.
+Enter the east-west position of your solar power plant, with 0° defined as the prime meridian. Positive longitudes are east of the prime meridian, negative ones are west.
 
 #### Azimuth [°]
-Azimuth is the horizontal direction of your solar power plant. 0° equals North, 90° equals East, 180° equals South, 270° equals West.
+Specify the horizontal direction of your solar power plant, with 0° corresponding to North, 90° to East, 180° to South, and 270° to West.
 
 #### Tilt [°]
-Tilt is the vertical direction of your solar power plant. 0° means it points up towards the the sky, 90° means it has a vertical orientation and points towards the horizon.
+Specify the vertical direction of your solar power plant, with 0° pointing upwards towards the sky and 90° being a vertical orientation pointing towards the horizon.
 
 #### Cells peak power [W]
-Peak power your solar cells can deliver.
+Enter the maximum power your solar cells can deliver. At the moment this value is only used if a value of 0 is specified for cells efficiency or cell area.
+In this case it is assumed that the cells peak power is given at an irradiance of 1000W/sqm.
 
 #### Cells efficiency  [%]
-Portion of energy in the form of sunlight that can be converted into electricity by the solar cell.
+Specify the portion of energy in the form of sunlight that can be converted into electricity by the solar cell.
 
 #### Temperature coefficient  [%/K]
-Dependence of the cell power on temperature (usually in the range of -0.4%/K).
-Cell temperature is estimated from ambient temperature and total irradiance.
+Enter the dependence of the cell power on temperature, usually in the range of -0.4%/K. Cell temperature is estimated from ambient temperature and total irradiance.
 
 #### Cell area [m<sup>2</sup>]
-Size of your solar panel.
+Enter the size of your solar panel.
 
 #### Diffuse radiation efficiency  [%]
-Efficiency of your solar power plant for diffuse radiation. When pointing up it should be around 100%, when pointing to the horizon it may be around 50%. 
-Also depends on reflections etc.
+Specify the efficiency of your solar power plant for diffuse radiation. When pointing up, it should be around 100%, but when pointing towards the horizon, it may be around 50%, depending on reflections and other factors.
+You probably need to optimize this parameter.
 
 #### Inverter power  [W]
-Maximum power of your inverter. If it is lower than the maximum power of your panels the output power of your system will be limited by this parameter.
+Specify the maximum power of your inverter. If it is lower than the maximum power of your panels, the output power of your system will be limited by this parameter.
 
 #### Inverter efficiency  [%] 
-Efficiency of your inverter.
+Enter the efficiency of your inverter.
 
 #### Shading
 In this section you can define the shading on your solar panels.
 For each azimuth angle range, you can specify the minimum elevation of the sun that is necessary for the sun to hit the solar panels.
 For elevations below this value you can set the percentage of shading. For example, a building will reduce radiation by 100%, a tree maybe only by 60%.
-You can use the button with sun icon (main window) to get information about the current azimuth and elevation of the sun to find out at what elevation the sun gets above 
-buildings or trees.
+You can use the sun icon button in the main window to get information about the current azimuth and elevation of the sun to determine at what elevation the sun gets above buildings or trees.
 
 ## License
 

app/build.gradle

@@ -12,8 +12,8 @@ android {
         applicationId "org.woheller69.solxpect"
         minSdkVersion 26
         targetSdkVersion 31
-        versionCode 14
-        versionName "1.4"
+        versionCode 15
+        versionName "1.5"
 
         buildConfigField "String", "BASE_URL", "\"https://api.open-meteo.com/v1/\""
         buildConfigField "String", "GITHUB_URL","\"https://github.com/woheller69/solxpect/\""

app/src/main/assets/help/help-de.html

@@ -2,58 +2,59 @@
 <body>
 <h2>Übersicht</h2>
 
-Diese App nimmt direkte und diffuse Strahlungsdaten von Open-Meteo.com, berechnet die Position
-der Sonne und projiziert die Strahlung auf Ihr Solarpanel.
-Es zeigt die geschätzte Energieproduktion für die nächsten Stunden und bis zu 16 Tage an.
-Die Stundenwerte werden für die vorangegangene Stunde berechnet.
-Wenn also um 11:00 Uhr 150 Wh angezeigt werden, bedeutet dies, dass Sie zwischen 10:00 und 11:00 Uhr mit 150 Wh rechnen können.
-
-<h3>Mehrere Module am gleichen Ort</h3>
-Wenn Sie mehrere Module haben, die in verschiedene Richtungen zeigen, können Sie sie als separate Standorte definieren und in den Einstellungen 'Summe anzeigen' einschalten.
-Dann werden alle Orte mit gleichem Breiten-/Längengrad zusammengefasst. In diesem Fall sollten Sie Ihre Standortnamen als 'myPV | Teil1', 'meinPV | Teil2' usw. definieren.
-Im Modus 'Summe anzeigen' wird der Standort dann als 'myPV' angezeigt und '|' wird in diesem Fall als Trennzeichen verwendet.
+Diese App prognostiziert die Leistung Ihrer Solaranlage unter Verwendung von Direkt- und Diffusstrahlungsdaten von Open-Meteo.com, berechnet die Position der Sonne und projiziert die Strahlung auf Ihr Solarpanel.
+Es zeigt die geschätzte Energieproduktion für die nächsten 16 Tage an, wobei stündliche Werte für die vorherige Stunde berechnet werden. Wenn zum Beispiel um 11:00 Uhr 150 Wh angezeigt werden, bedeutet dies, dass Sie zwischen 10:00 und 11:00 Uhr 150 Wh erwarten können.
+Um solXpect zu verwenden, geben Sie einfach Ihre Breiten- und Längenkoordinaten sowie den Azimut und die Neigung Ihres Solarpanels ein.
+Sie geben auch Informationen über die Spitzenleistung, Effizienz, Temperaturkoeffizienten und Fläche Ihres Solarpanels sowie die maximale Leistung und Effizienz Ihres Wechselrichters an.
+solXpect ermöglicht es Ihnen auch, Verschattungen auf Ihren Solarzellen zu definieren, indem Sie die minimale Sonnenhöhe angeben, die erforderlich ist, damit die Sonne auf die Solarzellen trifft, sowie den prozentualen Schatten für Höhen unter diesem Wert.
 
 <h2>Parameter</h2>
 
+<h3>Name</h3>
+Definieren Sie einen Namen für den Standort.
+Wenn Sie mehrere Solarpaneele mit denselben Breiten- und Längenkoordinaten, aber in unterschiedliche Richtungen ausgerichtet haben, können Sie sie als separate Standorte definieren und die Funktion "Summe anzeigen" verwenden, um ihre Leistung zusammenzufassen.
+In diesem Fall sollten Sie Ihre Standortnamen als "myPV | part1", "myPV | part2" usw. definieren. Im "Summe anzeigen"-Modus wird der Standort dann als "myPV" angezeigt und "|" wird in diesem Fall als Trennzeichen verwendet.
+
 <h3>Breitengrad [°]</h3>
-Der Breitengrad gibt die Nord-Süd-Position Ihres Solarkraftwerks an. Er reicht von –90° am Südpol bis 90° am Nordpol.
+Geben Sie die Nord-Süd-Position Ihrer Solaranlage an, die von -90° am Südpol bis 90° am Nordpol reicht.
 
 <h3>Längengrad [°]</h3>
-Der Längengrad gibt die Ost-West-Position Ihres Solarkraftwerks an. Der Nullmeridian definiert 0° Länge. Positive Längen liegen östlich des Nullmeridians, negative westlich.
+Geben Sie die Ost-West-Position Ihrer Solaranlage an, wobei 0° als Nullmeridian definiert ist. Positive Längengrade liegen östlich des Nullmeridians, negative westlich.
 
 <h3>Azimut [°]</h3>
-Azimut ist die horizontale Richtung Ihres Solarkraftwerks. 0° entspricht Norden, 90° entspricht Osten, 180° entspricht Süden, 270° entspricht Westen.
+Legen Sie die horizontale Ausrichtung Ihrer Solaranlage fest, wobei 0° Norden entspricht, 90° Osten, 180° Süden und 270° Westen.
 
 <h3>Neigung [°]</h3>
-Neigung ist die vertikale Richtung Ihres Solarkraftwerks. 0° bedeutet, dass es zum Himmel zeigt, 90° bedeutet, dass es vertikal ausgerichtet ist und zum Horizont zeigt.
+Legen Sie die vertikale Ausrichtung Ihrer Solaranlage fest, wobei 0° nach oben zum Himmel und 90° zum Horizont zeigt.
 
 <h3>Peakleistung der Zellen [W]</h3>
-Maximale Leistung, die Ihre Solarzellen liefern können.
+Geben Sie die maximale Leistung an, die Ihre Solarzellen liefern können. Derzeit wird dieser Wert nur verwendet, wenn für die Zelleneffizienz oder die Zellfläche ein Wert von 0 angegeben ist.
+In diesem Fall wird angenommen, dass die Nennleistung der Zellen bei einer Bestrahlungsstärke von 1000 W/m² vorliegt.
 
 <h3>Wirkungsgrad der Zellen [%]</h3>
-Energieanteil in Form von Sonnenlicht, der von der Solarzelle in Strom umgewandelt werden kann.
+Geben Sie den Anteil der Energie in Form von Sonnenlicht an, der von der Solarzelle in Strom umgewandelt werden kann.
 
 <h3>Temperaturkoeffizient  [%/K]</h3>
-Abhängigkeit der Leistung der Solarmodule von der Temperatur (normalerweise im Bereich von -0.4%/K).
+Geben Sie die Abhängigkeit der Zellleistung von der Temperatur an, normalerweise im Bereich von -0,4%/K. Die Zelltemperatur wird aus der Umgebungstemperatur und der Gesamtstrahlung geschätzt.
 
 <h3>Fläche der Zellen [m<sup>2</sup>]</h3>
-Fläche Ihres Solarpanels.
+Geben Sie die Größe Ihres Solarmoduls an.
 
 <h3>Effizienz diffuse Strahlung [%]</h3>
-Wirkungsgrad Ihres Solarkraftwerks bei diffuser Strahlung. Bei der Ausrichtung nach oben sollte er etwa 100 % betragen, bei der Ausrichtung zum Horizont etwa 50 %.
-Dies ist auch abhängig von Reflexionen etc.
+Geben Sie die Effizienz Ihrer Solaranlage für diffuse Strahlung an. Wenn sie nach oben gerichtet ist, sollte sie etwa 100% betragen, aber wenn sie in Richtung Horizont gerichtet ist, kann sie je nach Reflexionen und anderen Faktoren etwa 50% betragen.
+Sie müssen diesen Parameter wahrscheinlich optimieren.
 
 <h3>Wechselrichterleistung [W]</h3>
-Maximale Leistung Ihres Wechselrichters. Wenn sie niedriger als die maximale Leistung Ihrer Panels ist, wird die Ausgangsleistung Ihres Systems durch diesen Parameter begrenzt.
+Geben Sie die maximale Leistung Ihres Wechselrichters an. Wenn diese geringer ist als die maximale Leistung Ihrer Module, wird die Ausgangsleistung Ihres Systems durch diesen Parameter begrenzt.
 
 <h3>Wechselrichtereffizienz [%]</h3>
-Wirkungsgrad Ihres Wechselrichters.
+Geben Sie den Wirkungsgrad Ihres Wechselrichters ein.
 
 <h3>Abschattung</h3>
-In diesem Abschnitt können Sie die Abschattung Ihrer Solarmodule definieren.
-Für jeden Azimutwinkelbereich können Sie die minimale Elevation der Sonne angeben, die erforderlich ist, damit die Sonne auf die Solarmodule trifft.
-Für Elevationen unter diesem Wert können Sie den Prozentsatz der Abschattung festlegen. Beispielsweise reduziert ein Gebäude die Strahlung um 100 %, ein Baum vielleicht nur um 60 %.
-Über die Schaltfläche mit dem Sonnensymbol (Hauptfenster) erhalten Sie Informationen über den aktuellen Azimut und die aktuelle Elevation der Sonne. Damit können Sie herauszufinden, ab welcher Elevation die Sonne oberhalb der Gebäude oder Bäume steht.
+In diesem Abschnitt können Sie die Beschattung Ihrer Solarmodule definieren.
+Für jeden Azimutwinkelbereich können Sie die minimale Sonnenhöhe angeben, die erforderlich ist, damit die Sonne auf die Solarmodule trifft.
+Für Höhen unter diesem Wert können Sie den Prozentsatz der Beschattung festlegen. Zum Beispiel reduziert ein Gebäude die Strahlung um 100 %, ein Baum vielleicht nur um 60 %.
+Sie können die Schaltfläche mit dem Sonnen-Symbol im Hauptfenster verwenden, um Informationen über den aktuellen Azimut und die Höhe der Sonne zu erhalten und zu bestimmen, auf welcher Höhe die Sonne über Gebäuden oder Bäumen steht.
 
 </body>
 </html>