PowerModelsACDC.jl

A a Julia/JuMP/PowerModels package with models for DC lines, meshed DC networks, and AC DC converters.
https://github.com/Electa-Git/PowerModelsACDC.jl

Category: Energy Systems
Sub Category: Grid Management and Microgrid

Keywords from Contributors

optimal-power-flow power-network surrogate jacobians simulations matrix-exponential hybrid-differential-equations controls ida composibility

Last synced: about 6 hours ago
JSON representation

Repository metadata

A hybrid AC/DC OPF package based on PowerModels.jl

README.md

PowerModelsACDC.jl

Status:
CI

PowerModelsACDC.jl is a Julia/JuMP/PowerModels package with models for DC lines, meshed DC networks, and AC DC converters.
Building upon the PowerModels architecture, the code is engineered to decouple problem specifications (e.g. Power Flow, Optimal Power Flow, ...) from the power network formulations (e.g. AC, DC-approximation, SOC-relaxation, ...).

Installation
The latest stable release of PowerModelsACDC can be installed using the Julia package manager with

Pkg.add("PowerModelsACDC")

Core Problem Specifications

  • Optimal Power Flow with both point-to-point and meshed and dc grid support
  • Power Flow with both point-to-point and meshed ac and dc grid support
  • TNEP problem for point-to-point and meashed ac and dc grids

Core Formulations
All AC formulations of PowerModels are re-used.
Therefore, the core formulations in this package are twofold: those for the DC network and those for the AC/DC converters.

DC network connecting dc nodes:

  • DC nonlinear nonconvex formulation (NLP)
  • Convexified (SOC) bus injection model and branch flow model for the DC grid (which can be used with both the SDP and SOC convex relaxation formulations for the AC side)
  • Linearized (LP) active power only formulation, extending the linearized 'DC' approximation of AC grids to DC grids

AC/DC converter stations, connecting ac nodes and dc nodes, are composed of a transformer, filter, phase reactor and LCC/VSC converter. The passive components can be removed/disabled. Convex relaxation and linearized models for the passive components have been described, therefore, the converter station formulation is categorized by converter model complexity. The converter model includes constant losses and losses proportional to the current magnitude as well as current magnitude squared.

  • Nonlinear nonconvex formulation (NLP)
  • Convexified formulation (SOC)
  • Linearized formulation (LP)

Network Data Formats

  • MatACDC-style ".m" files (matpower ".m"-derived).
  • Matpower-style ".m" files, including matpower's dcline extenstions.
  • PTI ".raw" files, using PowerModels.jl parser

Note that the matpower-style dcline is transformed internally to two converters + a dcline connecting them. Such a transformation is exact for the 'dc'-style linearized models, but not for the AC models.

For further information, consult the PowerModels documentation.

Acknowledgments

The developers thank Carleton Coffrin (LANL) for his support.

Contributors

  • Hakan Ergun (KU Leuven / EnergyVille): Main developer
  • Frederik Geth (KU Leuven / EnergyVille): Formulations & relaxations of the OPF problem
  • Jay Dave (KU Leuven / EnergyVille): Transmission expansion plannning
  • Ghulam Mohy Ud Din (CSIRO): ACR formulation of the OPF problem, Sequential AC/DC Grid Power Flow using NLsolve
  • Özgür Can Sakinci (KU Leuven / EnergyVille): AC Voltage - Reactive Power droop for DC converters

Citing PowerModelsACDC

If you find PowerModelsACDC useful in your work, we kindly request that you cite the following publications:
AC/DC OPF Core:

@ARTICLE{8636236,
author={H. {Ergun} and J. {Dave} and D. {Van Hertem} and F. {Geth}},
journal={IEEE Transactions on Power Systems},
title={Optimal Power Flow for AC�DC Grids: Formulation, Convex Relaxation, Linear Approximation, and Implementation},
year={2019},
volume={34},
number={4},
pages={2980-2990},
keywords={AC-DC power convertors;approximation theory;HVDC power convertors;HVDC power transmission;power grids;power transmission control;reactive power control;AC-DC grids;linear approximation;active power control capabilities;reactive power control capabilities;HVDC converter stations;power systems;ancillary services;optimal power flow model;convex relaxation formulation;parameterized ac-dc converter model;common ac optimal power flow formulations;dc nodes;converter station technologies;ac nodes;ancillary security;open-source tool;Mathematical model;HVDC transmission;AC-DC power converters;Numerical models;Inductors;Impedance;Linear approximation;HVDC transmission;flexible ac transmission systems;power system analysis computing},
doi={10.1109/TPWRS.2019.2897835},
ISSN={0885-8950},
month={July},}

TNEP Extension 1:

@ARTICLE{
   iet:/content/journals/10.1049/iet-gtd.2019.0383,
   author = {Jay Dave},
   author = {Hakan Ergun},
   author = {Ting An},
   author = {Jingjing Lu},
   author = {Dirk Van Hertem},
   keywords = {power systems;meshed HVDC grids;increased utilisation;presented formulations;convex formulations;second-order cone convex relaxation;multiple HVDC links;linear approximation;dc grids;transmission network expansion planning problem;high-voltage direct current;traditional ac grid;TNEP problem;nonlinear formulation;},
   ISSN = {1751-8687},
   title = {TNEP of meshed HVDC grids: ‘AC’, ‘DC’ and convex formulations},
   journal = {IET Generation, Transmission & Distribution},
   issue = {24},
   volume = {13},
   year = {2019},
   month = {December},
   pages = {5523-5532(9)},
   publisher ={Institution of Engineering and Technology},
   copyright = {© The Institution of Engineering and Technology},
   url = {https://digital-library.theiet.org/content/journals/10.1049/iet-gtd.2019.0383}
}

TNEP Extension 2:

@ARTICLE{dave2021relaxations,
  title={Relaxations and approximations of HVdc grid TNEP problem},
  author={Dave, Jay and Ergun, Hakan and Van Hertem, Dirk},
  journal={Electric Power Systems Research},
  volume={192},
  pages={106683},
  year={2021},
  publisher={Elsevier}
}
}

License

This code is provided under a BSD license.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 1 day ago

Total Commits: 388
Total Committers: 20
Avg Commits per committer: 19.4
Development Distribution Score (DDS): 0.237

Commits in past year: 9
Committers in past year: 1
Avg Commits per committer in past year: 9.0
Development Distribution Score (DDS) in past year: 0.0

Name Email Commits
Hakan Ergun h****n@i****g 296
frederikgeth f****h@t****l 19
Jay D****e 11
GHULAM MOHY UD DIN g****t@g****m 10
frederikgeth f****h@g****m 9
github-actions[bot] 4****] 9
Carleton Coffrin c****n@c****m 6
frederikgeth f****h@e****e 6
Matteo Rossini m****i@k****e 5
ozgurcansakinci o****i@g****m 3
Hakan Ergun h****n@e****e 3
Benoît Legat b****t@g****m 2
Geth, Frederik (Energy, Newcastle) F****h@c****u 2
jay-dave j****e@k****e 1
CompatHelper Julia c****y@j****g 1
Jay Dave d****a@e****e 1
Kristoffer Carlsson k****l@s****e 1
frederikgeth f****h@e****e 1
frederikgeth f****h@t****e 1
Julia TagBot 5****t 1

Committer domains:


Issue and Pull Request metadata

Last synced: 1 day ago

Total issues: 46
Total pull requests: 43
Average time to close issues: 4 months
Average time to close pull requests: about 2 months
Total issue authors: 8
Total pull request authors: 11
Average comments per issue: 1.26
Average comments per pull request: 0.42
Merged pull request: 23
Bot issues: 0
Bot pull requests: 24

Past year issues: 1
Past year pull requests: 0
Past year average time to close issues: N/A
Past year average time to close pull requests: N/A
Past year issue authors: 1
Past year pull request authors: 0
Past year average comments per issue: 0.0
Past year average comments per pull request: 0
Past year merged pull request: 0
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/Electa-Git/PowerModelsACDC.jl

Top Issue Authors

  • frederikgeth (20)
  • hakanergun (17)
  • jay-dave (2)
  • sdwhardy (2)
  • matteorossini (2)
  • SabineAuer (1)
  • frascuscus (1)
  • JuliaTagBot (1)

Top Pull Request Authors

  • github-actions[bot] (24)
  • hakanergun (6)
  • Electa-Git (3)
  • ghulam41 (2)
  • blegat (2)
  • ccoffrin (1)
  • ozgurcansakinci (1)
  • KristofferC (1)
  • matteorossini (1)
  • hexaeder (1)
  • JuliaTagBot (1)

Top Issue Labels

  • enhancement (7)

Top Pull Request Labels


Package metadata

juliahub.com: PowerModelsACDC

A hybrid AC/DC OPF package based on PowerModels.jl

  • Homepage:
  • Documentation: https://docs.juliahub.com/General/PowerModelsACDC/stable/
  • Licenses: BSD-3-Clause
  • Latest release: 0.8.0 (published 10 months ago)
  • Last Synced: 2025-04-29T15:36:08.154Z (1 day ago)
  • Versions: 20
  • Dependent Packages: 3
  • Dependent Repositories: 0
  • Downloads: 19 Total
  • Rankings:
    • Forks count: 9.83%
    • Dependent repos count: 9.94%
    • Average: 13.23%
    • Stargazers count: 16.559%
    • Dependent packages count: 16.592%

Dependencies

.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/ci.yml actions
  • actions/cache v2 composite
  • actions/checkout v2 composite
  • codecov/codecov-action v1 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/julia-processcoverage v1 composite
  • julia-actions/julia-runtest latest composite
  • julia-actions/setup-julia v1 composite
.github/workflows/documentation.yml actions
  • actions/checkout v2 composite
  • julia-actions/setup-julia latest composite
.github/workflows/CompatHelper.yml actions
test/REQUIRE julia

Score: 10.43058014876599