Generated Python Root Surface

April 26, 2026 ยท View on GitHub

Generated by scripts/render_public_surface.py from src/surge-py/python/surge/__init__.pyi.

Root Functions

  • load(path: str | PathLike[str], format: str | None = None) -> Network
  • load_network(path: str | PathLike[str], format: str | None = None) -> Network
  • save(network: Network, path: str | PathLike[str]) -> None
  • list_builtin_cases() -> list[str]
  • load_builtin_case(name: str) -> Network
  • builtin_case_rated_flags() -> list[tuple[str, bool]]
  • solve_dc_pf(network: Network, options: DcPfOptions | None = None, /) -> DcPfResult
  • solve_ac_pf(network: Network, options: AcPfOptions | None = None, /) -> AcPfResult
  • solve_dc_opf(network: Network, options: DcOpfOptions | None = None, runtime: DcOpfRuntime | None = None) -> DcOpfResult
  • solve_ac_opf(network: Network, options: AcOpfOptions | None = None, runtime: AcOpfRuntime | None = None) -> AcOpfResult
  • solve_scopf(network: Network, options: ScopfOptions | None = None, runtime: ScopfRuntime | None = None) -> ScopfResult
  • solve_dispatch(network: Network, request: Mapping[str, Any] | str | None = None, *, lp_solver: str | None = None) -> DispatchResult

Public Namespaces

  • audit
  • batch
  • compose
  • construction
  • contingency
  • contingency_io
  • dc
  • dispatch
  • io
  • losses
  • market
  • opf
  • powerflow
  • subsystem
  • transfer
  • units

Root Re-Exports

  • AcAngleWarmStartMode
  • AcOpfBendersSubproblemResult
  • AcOpfOptions
  • AcOpfResult
  • AcOpfRuntime
  • AcPfOptions
  • AcPfResult
  • AmbiguousTopologyError
  • AreaSchedule
  • Bay
  • BindingContingency
  • Branch
  • BreakerRating
  • Bus
  • BusbarSection
  • CollapsedBranch
  • CombinedCycleConfig
  • CombinedCyclePlant
  • CombinedCycleTransition
  • ConnectivityNode
  • ConstraintScreening
  • Contingency
  • ContingencyAnalysis
  • ContingencyOptions
  • ContingencyViolation
  • ConvergenceError
  • DcBranch
  • DcBus
  • DcConverter
  • DcCostModel
  • DcLossModel
  • DcOpfOptions
  • DcOpfResult
  • DcOpfRuntime
  • DcPfOptions
  • DcPfResult
  • DiscreteMode
  • DispatchRequest
  • DispatchResult
  • DispatchableLoad
  • FactsDevice
  • FailedContingencyEvaluation
  • FixedShunt
  • Generator
  • GeneratorLimitMode
  • Hvdc
  • HvdcDcBusSolution
  • HvdcLccDetail
  • HvdcMode
  • HvdcOpfLink
  • HvdcResult
  • HvdcStationSolution
  • InfeasibleError
  • LccHvdcLink
  • Load
  • LogReceiver
  • MissingTopologyError
  • Network
  • NetworkError
  • NodeBreakerTopology
  • OpfResult
  • OutageEntry
  • ParSetpoint
  • PumpedHydroUnit
  • ReserveZone
  • ScopfFormulation
  • ScopfMode
  • ScopfOptions
  • ScopfResult
  • ScopfRuntime
  • ScopfScreeningPolicy
  • ScopfScreeningStats
  • StaleTopologyError
  • StorageParams
  • Substation
  • SurgeError
  • SurgeIOError
  • TerminalConnection
  • ThermalRating
  • TopologyBusMerge
  • TopologyBusSplit
  • TopologyError
  • TopologyIntegrityError
  • TopologyMapping
  • TopologyRebuildResult
  • TopologyReport
  • TopologySwitch
  • UnsupportedFeatureError
  • VirtualBid
  • VoltageLevel
  • VscHvdcLink
  • analyze_contingencies
  • analyze_n1_branch
  • analyze_n1_generator
  • analyze_n2_branch
  • attach_log_listener
  • case118
  • case14
  • case30
  • case300
  • case57
  • case9
  • detach_log_listener
  • get_max_threads
  • init_logging
  • market30
  • set_max_threads
  • solve_ac_opf_subproblem
  • solve_dispatch
  • solve_hvdc
  • version