gdm-flow 0.1.0__py3-none-any.whl

gdm_flow/__init__.py

@@ -0,0 +1,102 @@
+"""GDM Flow utilities."""
+
+from .dc_opf import (
+    DCGenerator,
+    DCOPFResult,
+    build_dc_generators_from_components,
+    build_dc_load_profile_from_components,
+    solve_dc_opf,
+    solve_dc_opf_from_components,
+)
+from .lindistflow import (
+    LinDistFlowResult,
+    build_lindistflow_net_injections_from_components,
+    solve_lindistflow,
+)
+from .sqlite_export import (
+    export_ac_opf_result_to_sqlite,
+    export_all_results_to_sqlite,
+    export_dc_opf_result_to_sqlite,
+    export_lindistflow_result_to_sqlite,
+)
+from .ac_opf import (
+    PowerFlowOptimizationResult,
+    build_regulator_voltage_limits_from_components,
+    build_nodal_power_specs_from_components,
+    build_regulator_voltage_targets_from_components,
+    optimize_ac_power_flow,
+    optimize_ac_power_flow_from_components,
+)
+from .ybus import YBusResult, calculate_ybus
+from .ac_pf import (
+    ACPowerFlowResult,
+    solve_ac_power_flow,
+    solve_ac_power_flow_from_components,
+)
+from .time_series import (
+    BatterySOCTracker,
+    QSTSSummary,
+    TimeSeriesInfo,
+    build_dc_load_profile_at_timestep,
+    build_lindistflow_injections_at_timestep,
+    build_nodal_power_specs_at_timestep,
+    get_time_series_length,
+    get_time_series_resolution,
+    get_time_series_timestamps,
+    has_time_series_data,
+    list_component_time_series,
+    run_qsts,
+)
+from .multiperiod import (
+    BatterySpec,
+    MultiPeriodResult,
+    build_battery_specs_from_components,
+    solve_multiperiod_dc_opf,
+    solve_multiperiod_lindistflow,
+)
+from .dashboard import generate_ts_dashboard
+
+__all__ = [
+    "YBusResult",
+    "calculate_ybus",
+    "DCGenerator",
+    "DCOPFResult",
+    "build_dc_load_profile_from_components",
+    "build_dc_generators_from_components",
+    "solve_dc_opf",
+    "solve_dc_opf_from_components",
+    "LinDistFlowResult",
+    "build_lindistflow_net_injections_from_components",
+    "solve_lindistflow",
+    "export_ac_opf_result_to_sqlite",
+    "export_dc_opf_result_to_sqlite",
+    "export_lindistflow_result_to_sqlite",
+    "export_all_results_to_sqlite",
+    "PowerFlowOptimizationResult",
+    "build_nodal_power_specs_from_components",
+    "build_regulator_voltage_limits_from_components",
+    "build_regulator_voltage_targets_from_components",
+    "optimize_ac_power_flow",
+    "optimize_ac_power_flow_from_components",
+    "ACPowerFlowResult",
+    "solve_ac_power_flow",
+    "solve_ac_power_flow_from_components",
+    "TimeSeriesInfo",
+    "BatterySOCTracker",
+    "QSTSSummary",
+    "list_component_time_series",
+    "has_time_series_data",
+    "get_time_series_length",
+    "get_time_series_resolution",
+    "get_time_series_timestamps",
+    "build_nodal_power_specs_at_timestep",
+    "build_dc_load_profile_at_timestep",
+    "build_lindistflow_injections_at_timestep",
+    "run_qsts",
+    "BatterySpec",
+    "MultiPeriodResult",
+    "build_battery_specs_from_components",
+    "solve_multiperiod_dc_opf",
+    "solve_multiperiod_lindistflow",
+    "generate_ts_dashboard",
+]

gdm_flow/_utils.py

@@ -0,0 +1,20 @@
+"""Internal shared helper utilities for solver modules."""
+
+from __future__ import annotations
+
+import math
+
+from gdm.distribution.enums import Phase, VoltageTypes
+
+
+def _phase_name(phase: Phase | str) -> str:
+    """Normalize phase enum/string values to string labels."""
+    return phase.value if isinstance(phase, Phase) else str(phase)
+
+
+def _phase_voltage(voltage, voltage_type: VoltageTypes) -> float:
+    """Return phase voltage magnitude in volts."""
+    v_ll_or_lg = float(voltage.to("volt").magnitude)
+    if voltage_type == VoltageTypes.LINE_TO_LINE:
+        return v_ll_or_lg / math.sqrt(3)
+    return v_ll_or_lg