[DEV 3822] add example for forecast feeder load analysis study

changelog.md

@@ -36,7 +36,7 @@
 * Update `zepben.evolve` to latest version, renamed too `zepben.ewb` 1.0.0b7. Previous versions will be incompatible.
 
 ### New Features
-* None.
+* Added new example for forecast feeder load analysis study.
 
 ### Enhancements
 * None.

pyproject.toml

@@ -23,7 +23,7 @@ authors = [
     {name = "Zeppelin Bend", email = "oss@zepben.com"}
 ]
 dependencies = [
-    "zepben.eas==0.23.0",
+    "zepben.eas==0.26.0b1",
     "zepben.ewb==1.0.3",
     "numba==0.60.0",
     "geojson==2.5.0",

src/zepben/examples/request_forecast_feeder_load_analysis_study.py

@@ -0,0 +1,51 @@
+#  Copyright 2025 Zeppelin Bend Pty Ltd
+#
+#  This Source Code Form is subject to the terms of the Mozilla Public
+#  License, v. 2.0. If a copy of the MPL was not distributed with this
+#  file, You can obtain one at https://mozilla.org/MPL/2.0/.
+import asyncio
+import sys
+
+from zepben.eas.client.feeder_load_analysis_input import FeederLoadAnalysisInput
+from zepben.eas.client.fla_forecast_config import FlaForecastConfig
+
+from zepben.examples.utils import get_config_dir, get_client
+
+
+async def main(argv):
+    # See connecting_to_grpc_service.py for examples of each connect function
+    config_dir = get_config_dir(argv)
+    print("Connecting to EAS..")
+    eas_client = get_client(config_dir)
+    print("Connection established..")
+    # Fire off a feeder load analysis study
+    feeder_load_analysis_token = await eas_client.async_run_feeder_load_analysis_report(
+        FeederLoadAnalysisInput(
+            feeders=["feeder1", "feeder2"],
+            start_date="2022-04-01",
+            end_date="2022-12-31",
+            fetch_lv_network=True,
+            process_feeder_loads=True,
+            process_coincident_loads=True,
+            aggregate_at_feeder_level=False,
+            output="Test",
+            fla_forecast_config=FlaForecastConfig(
+                scenario_id='1',
+                year=2029,
+                pv_upgrade_threshold=6500,  ##Premise with existing PV will gain additional PV until the threshold wattage is reached.
+                bess_upgrade_threshold=6500,  ##Premise with existing battery will gain additional battery until the threshold wattage is reached.
+                seed=12345  ##Seed can be set to keep modification of forecast network consistent between studies.
+            )
+        )
+    )
+
+    print(f"Feeder Load Analysis study: {feeder_load_analysis_token['data']['runFeederLoadAnalysis']}")
+
+    # Feeder Load Analysis Study results can be retrieved from back end storage set up with EAS.
+
+    await eas_client.aclose()
+
+
+if __name__ == "__main__":
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(main(sys.argv))