Merge branch 'dev' into df/#1352-air-condition-input

# Conflicts:
#	CHANGELOG.md

Author: danielfeismann

CHANGELOG.md

@@ -6,10 +6,12 @@ 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)
 - Create data model for air condition [#1396](https://github.com/ie3-institute/PowerSystemDataModel/issues/1396)
 
 ### Fixed
+- Fixed small issues in tests [#1400](https://github.com/ie3-institute/PowerSystemDataModel/issues/1400)
 
 ### Changed
 

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

@@ -169,6 +169,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")