PV Simulation Module (#21)

* Simple PV Simulation based on Elia Load Factors

* add isort pre-commit hook for consistent import sorting.

* PVLIB

* Enhance PVLib simulator by adding PVLibSimulationInput class and updating initialization parameters

* Enhance PVSimulator and subclasses by adding result_resolution parameter and updating initialization; refactor from_pydantic methods for improved input handling.

---------

Co-authored-by: Jan Pecinovsky <=>

Author: JrtPec

.pre-commit-config.yaml

@@ -43,3 +43,9 @@ repos:
           - --output-file=requirements-dev.txt
           - --dev
       - id: uv-lock
+
+  - repo: https://github.com/pre-commit/mirrors-isort
+    rev: v5.10.1
+    hooks:
+      - id: isort
+        args: ["--profile", "black"] # Optional: Use Black-compatible sorting

demo_pvsimulation.ipynb

@@ -1,6 +1,6 @@
 """Open Energy ID Python SDK."""
 
-__version__ = "0.1.28"
+__version__ = "0.1.30"
 
 from .enums import Granularity
 from .models import TimeDataFrame, TimeSeries

openenergyid/__init__.py

@@ -1,8 +1,8 @@
 """Baseload analysis package for power consumption data."""
 
-from .models import PowerReadingSchema, PowerSeriesSchema, BaseloadResultSchema
 from .analysis import BaseloadAnalyzer
 from .exceptions import InsufficientDataError, InvalidDataError
+from .models import BaseloadResultSchema, PowerReadingSchema, PowerSeriesSchema
 
 __version__ = "0.1.0"
 __all__ = [

openenergyid/baseload/__init__.py

@@ -1,6 +1,6 @@
 """Power Offtake peak analysis module."""
 
-from .models import CapacityInput, CapacityOutput, PeakDetail
 from .main import CapacityAnalysis
+from .models import CapacityInput, CapacityOutput, PeakDetail
 
 __all__ = ["CapacityInput", "CapacityAnalysis", "CapacityOutput", "PeakDetail"]

openenergyid/capacity/__init__.py

@@ -2,6 +2,7 @@
 
 import datetime as dt
 import typing
+
 import pandas as pd
 import pandera.typing as pdt
 

openenergyid/capacity/main.py

@@ -1,7 +1,9 @@
 """Model for Capacity Analysis."""
 
 import datetime as dt
+
 from pydantic import BaseModel, ConfigDict, Field
+
 from openenergyid.models import TimeSeries
 
 

openenergyid/capacity/models.py

@@ -1,6 +1,7 @@
 """Main module of the DynTar package."""
 
 from typing import cast
+
 import pandas as pd
 
 from openenergyid.const import (
@@ -13,22 +14,22 @@
 )
 
 from .const import (
-    ELECTRICITY_DELIVERED_SMR3,
-    ELECTRICITY_EXPORTED_SMR3,
-    ELECTRICITY_DELIVERED_SMR2,
-    ELECTRICITY_EXPORTED_SMR2,
     COST_ELECTRICITY_DELIVERED_SMR2,
-    COST_ELECTRICITY_EXPORTED_SMR2,
     COST_ELECTRICITY_DELIVERED_SMR3,
+    COST_ELECTRICITY_EXPORTED_SMR2,
     COST_ELECTRICITY_EXPORTED_SMR3,
-    RLP_WEIGHTED_PRICE_DELIVERED,
-    SPP_WEIGHTED_PRICE_EXPORTED,
+    ELECTRICITY_DELIVERED_SMR2,
+    ELECTRICITY_DELIVERED_SMR3,
+    ELECTRICITY_EXPORTED_SMR2,
+    ELECTRICITY_EXPORTED_SMR3,
     HEATMAP_DELIVERED,
-    HEATMAP_EXPORTED,
-    HEATMAP_TOTAL,
     HEATMAP_DELIVERED_DESCRIPTION,
+    HEATMAP_EXPORTED,
     HEATMAP_EXPORTED_DESCRIPTION,
+    HEATMAP_TOTAL,
     HEATMAP_TOTAL_DESCRIPTION,
+    RLP_WEIGHTED_PRICE_DELIVERED,
+    SPP_WEIGHTED_PRICE_EXPORTED,
     Register,
 )
 

openenergyid/dyntar/main.py

@@ -1,11 +1,12 @@
 """Models for dynamic tariff analysis."""
 
 from typing import Literal
-from pydantic import Field, conlist, confloat, BaseModel
+
+from pydantic import BaseModel, Field, confloat, conlist
 
 from openenergyid.models import TimeDataFrame
-from .const import Register
 
+from .const import Register
 
 RequiredColumns = Literal[
     "electricity_delivered",

openenergyid/dyntar/models.py

@@ -0,0 +1,4 @@
+from .api import get_dataset, parse_response
+from .const import Region
+
+__all__ = ["get_dataset", "parse_response", "Region"]