interconnection-gym¶
A policy simulator for the batch interconnection of large loads (data centers and similar loads). Applicants request grid capacity, the operator splits what the network can host among them with an allocation rule, and every applicant pays for what it requested.
- Operators and analysts can compare allocation rules and fees on their own network before adopting them: Comparing rules.
- Researchers get games whose equilibria are known in closed form, for studying allocation rules as mechanisms: any model of applicant behavior can be scored against ground truth: Environments and benchmarks.
The default game: fixed locations¶
In the default game (BatchGame), every applicant's location
is fixed. Applicant i sits at a given bus, which is column i of the
batch region, and chooses only how many megawatts to
request. The operator's rule then decides how much of each request is
served. Letting applicants also choose where to connect is a separate game,
the location game (LocationGame, and
LocationParallelEnv for learning). The other extensions add a second
decision at the same fixed bus: a generator or battery (GenerationGame), or
a non-firm request (NonFirmGame).
Install¶
# not yet on PyPI: install from GitHub
pip install "interconnection-gym @ git+https://github.com/MhaoMou/interconnection-gym" # core: numpy and scipy
pip install "interconnection-gym[envs] @ git+https://github.com/MhaoMou/interconnection-gym" # adds Gymnasium and PettingZoo
pip install "interconnection-gym[ac] @ git+https://github.com/MhaoMou/interconnection-gym" # adds CasADi and Ipopt, for AC power flow
Python 3.10 or newer.
Thirty seconds¶
from icgym import BatchGame, PerMWCommitment, Region, UniformRule, predicted_equilibrium
region = Region(A=[[1.0, 1.0, 0.0], [0.0, 1.0, 1.0]], b=[2.0, 3.0]) # two shared limits
game = BatchGame(region, UniformRule(beta=0.5), PerMWCommitment(kappa=0.4), value=1.0)
w = predicted_equilibrium(game)["requests"] # the unique equilibrium: [1, 1, 2]
game.allocate(w), game.payoffs(w)
game.exploitability([1.5, 1.0, 2.0]) # applicant 0 gains 0.2 by returning to w
Contents¶
| Page | What it covers |
|---|---|
| Model and theory | What is modeled, and the results the oracles return |
| Comparing rules | icgym-compare and compare_rules |
| Regions from a network | Exporting a batch region from a DC power-flow study; the implicit DCOPFRegion |
| Technical details | How regions, rules, equilibria, prices, devices, and the AC region are computed |
| Environments and benchmarks | PettingZoo and Gymnasium environments, the vectorized environment, benchmark tasks and baselines |
| Data and licenses | The bundled IEEE 14-bus and ACTIVSg2000 catalogs, where they come from, and their terms |
| Development | Tests, lint, and the release checklist |