Science Score: 44.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Academic email domains
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (12.4%) to scientific vocabulary
Last synced: 6 months ago · JSON representation ·

Repository

Basic Info
  • Host: GitHub
  • Owner: Distribution-System-Restoration
  • Language: Python
  • Default Branch: main
  • Size: 627 KB
Statistics
  • Stars: 0
  • Watchers: 1
  • Forks: 0
  • Open Issues: 0
  • Releases: 0
Created over 1 year ago · Last pushed 10 months ago
Metadata Files
Readme Citation

README.md

Conditional Generative Multi-Agent Soft Actor-Critic for Power Distribution System Restoration

This repository provides the simulation environments for our research on multi-agent power distribution system restoration using reinforcement learning. It supports reproducible experiments on IEEE test feeders with switch-level actions and DER constraints.

⚠️ Note: This repo contains only the environments used in the paper. The proposed CGenMARL algorithm will be made available after paper acceptance.


🔍 Project Overview

We model post-outage restoration as a multi-agent sequential decision-making problem. The power distribution system is divided into microgrids, each managed by a decentralized agent observing and operating local switches. The goal is to maximize critical load restoration using limited DERs while satisfying grid constraints such as voltage stability and capacity limits.


🧠 Methodology Summary

  • Algorithm: Soft Actor-Critic (SAC) with Decentralized Actor - Centralized Critic (DACC)
  • Control Space: Switch-level discrete actions
  • Feedback: Shared global reward + constraint-aware termination
  • Simulation: Power flow and constraint checking via OpenDSS

🔑 Key Features

This repository provides custom simulation environments for reinforcement learning-based restoration studies. Key environment capabilities include:

  • Multi-Agent Architecture Support: Agents control local microgrids independently with system-wide evaluation.
  • IEEE Test Feeders: Includes IEEE 123-bus and IEEE 8500-node systems with pre-defined DER locations and load profiles.
  • Discrete Switch Actions: Agents select from "turn on," "turn off," or "no-action" per switch at each step.
  • Constraint-Aware Evaluation: Power flow is evaluated using OpenDSS after every joint action to enforce:
    • Power balance
    • Voltage limits
    • Line capacity
  • Feasibility-Based Termination: Episodes terminate upon constraint violations to emulate real-world grid safety.
  • Critical Load Prioritization: Buses have assigned importance weights to reflect realistic load restoration objectives.
  • Shared Reward Signal: Encourages cooperation across agents by linking reward to global restoration success and constraint satisfaction.
  • Pythonic Interface: Easy-to-use API with reset, step, and sample_action methods compatible with RL pipelines.
  • Fully Extensible: Modular design allows modification of constraints, feeders, DERs, or reward structure for custom use cases.

📦 Prerequisites

To run the environment:

Owner

  • Login: Distribution-System-Restoration
  • Kind: user

Citation (CITATION.CFF)

cff-version: 1.2.0
message: "If you use this environment in your research, please cite it as below."
authors:
  - family-names: Farajzadeh Bavil
    given-names: Ali
  - family-names: Khodayar
    given-names: Mahdi
title: "Conditional Generative Multi-Agent Soft Actor-Critic for Power Distribution System Restoration"
version: "1.0"
date-released: 2025-04-23
url: "https://github.com/Distribution-System-Restoration/cgenmarl-pds-restoration"
repository-code: "https://github.com/Distribution-System-Restoration/cgenmarl-pds-restoration"
license: MIT
keywords:
  - Distribution system restoration
  - Multi-agent reinforcement learning
  - Generative action generation
  - Attnetion Activation Regularization
  

GitHub Events

Total
Last Year