Merge branch 'dev' into df/#1409-spotless-java-format

# Conflicts:
#	CHANGELOG.md

Author: danielfeismann

.github/workflows/ci.yml

@@ -84,7 +84,7 @@ jobs:
 
       #Deployment
       - name: Deploy
-        if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev'
+        if: github.ref == 'refs/heads/main'
         env:
           ORG_GRADLE_PROJECT_signingKey: ${{ secrets.MAVENCENTRAL_SIGNINGKEY }}
           ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.MAVENCENTRAL_SIGNINGPASS }}
@@ -108,7 +108,7 @@ jobs:
 
       #MavenCentral Staging
       - name: MavenCentral Staging
-        if: github.ref == 'refs/heads/main' || github.ref == 'refs/heads/dev'
+        if: github.ref == 'refs/heads/main'
         env:
           ORG_GRADLE_PROJECT_signingKey: ${{ secrets.MAVENCENTRAL_SIGNINGKEY }}
           ORG_GRADLE_PROJECT_signingPassword: ${{ secrets.MAVENCENTRAL_SIGNINGPASS }}

CHANGELOG.md

@@ -6,11 +6,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased/Snapshot]
 
-### Added 
+### Added
+-Added weathersource documentation [#1390](https://github.com/ie3-institute/PowerSystemDataModel/issues/1390)
 
 ### Fixed
+- Fixed small issues in tests [#1400](https://github.com/ie3-institute/PowerSystemDataModel/issues/1400)
 
 ### Changed
+- Updated CI-Pipeline to run task `Deploy` and `Staging` only for `Main` [#1403](https://github.com/ie3-institute/PowerSystemDataModel/issues/1403)
 - Change spotless to use googleJavaFormat('1.28.0') [#1408](https://github.com/ie3-institute/PowerSystemDataModel/issues/1408)
 
 ## [8.1.0] - 2025-07-25

build.gradle

@@ -5,7 +5,7 @@ plugins {
   id 'signing'
   id 'pmd' // code check, working on source code
   id 'com.diffplug.spotless' version '7.2.1' //code format
-  id 'com.github.spotbugs' version '6.2.2' // code check, working on byte code
+  id 'com.github.spotbugs' version '6.2.3' // code check, working on byte code
   id 'de.undercouch.download' version '5.6.0'
   id 'kr.motd.sphinx' version '2.10.1' // documentation generation
   id 'jacoco' // java code coverage plugin
@@ -104,7 +104,7 @@ dependencies {
 
   implementation 'commons-io:commons-io:2.20.0' // I/O functionalities
   implementation 'commons-codec:commons-codec:1.19.0' // needed by commons-compress
-  implementation 'org.apache.commons:commons-compress:1.27.1' // I/O functionalities
+  implementation 'org.apache.commons:commons-compress:1.28.0' // I/O functionalities
 }
 
 tasks.withType(JavaCompile) {

docs/readthedocs/models/input/additionaldata/weathersource.md

@@ -0,0 +1,66 @@
+# WeatherSource
+
+The **`WeatherSource`** is an abstract class that provides a standardized interface for accessing time-series weather data. It serves as a foundation for concrete implementations that fetch data from various providers (e.g., CSV files or SQL databases).
+
+A `WeatherSource` relies on two key components:
+* **[`IdCoordinateSource`](idcoordinatesource.md)**: Used to resolve a numeric **coordinate ID** from the source data into a geographic `Point` object.
+* **`TimeBasedWeatherValueFactory`**: Used to construct `WeatherValue` objects from the raw data fields.
+
+***
+
+## Information
+
+The source data for any `WeatherSource` implementation is expected to contain the following information.
+
+```{list-table}
+   :widths: auto
+   :class: wrapping
+   :header-rows: 1
+
+   * - Attribute
+     - Remarks
+
+   * - **`coordinateid`**
+     - An **integer ID** for a specific geographic coordinate. This ID is used to look up the actual `Point` via the `IdCoordinateSource`.
+
+   * - **Time**
+     - The specific timestamp of the weather data, typically as a `ZonedDateTime`.
+
+   * - **Weather Data**
+     - The meteorological values, such as solar irradiance (`direct` and `diffuse`), temperature, and wind data (`speed` and `direction`).
+```
+
+## WeatherData
+
+Weather data is comprised of five key components:
+
+```{list-table}
+   :widths: auto
+   :class: wrapping
+   :header-rows: 1
+
+   * - Component
+     - Description
+     - Unit
+
+   * - **`directIrradiance`**
+     - Solar radiation that reaches the surface directly from the sun.
+     - W/m²
+
+   * - **`diffuseIrradiance`**
+     - Solar radiation scattered by the atmosphere before reaching the surface.
+     - W/m²
+
+   * - **`temperature`**
+     - Ambient air temperature.
+     - K (Kelvin)
+
+   * - **`windVelocity`**
+     - Wind speed.
+     - m/s (meters per second)
+
+   * - **`windDirection`**
+     - Wind direction, where 0° is North, 90° is East, etc.
+     - ° (degrees)
+```
+Weather data in COSMO and ICON formats is supported. Additional optional weather data can also be provided.

docs/readthedocs/models/models.md

@@ -168,6 +168,7 @@ maxdepth: 1
 ---
 input/additionaldata/timeseries
 input/additionaldata/idcoordinatesource
+input/additionaldata/weathersource
 ```
 
 ## Result

src/test/groovy/edu/ie3/datamodel/io/factory/FactoryTest.groovy

@@ -6,7 +6,6 @@
 package edu.ie3.datamodel.io.factory
 
 import edu.ie3.datamodel.exceptions.FactoryException
-import edu.ie3.datamodel.models.input.EmInput
 import edu.ie3.datamodel.utils.Try
 import spock.lang.Shared
 import spock.lang.Specification

src/test/groovy/edu/ie3/datamodel/io/source/sql/SqlTimeSeriesSourceIT.groovy

@@ -126,7 +126,7 @@ class SqlTimeSeriesSourceIT extends Specification implements TestContainerHelper
     value.get() == P_VALUE_00MIN
   }
 
-  def "The cSqlTimeSeriesSource returns the last value, if there is no current value"() {
+  def "The SqlTimeSeriesSource returns the last value, if there is no current value"() {
     given:
     def time = TimeUtil.withDefaults.toZonedDateTime("2020-01-01T00:13:00Z")