Macro

Allows you to optimize the design and operations of large multi-sector energy systems.
ps://github.com/macroenergy/macroenergy.jl

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Last synced: about 17 hours ago
JSON representation

Repository metadata

Macro allows you to optimize the design and operations of large multi-sector energy systems.

README.md

Macro

Macro is a bottom-up, multi-sectoral infrastructure optimization model for macro-energy systems. It co-optimizes the design and operation of user-defined models of multi-sector energy systems and networks. Macro allows users to explore the impact of changing energy policies, technologies, demand patterns, and other factors on an energy system as a whole and as separate sectors.

Features

The Macro development team have built on their experience developing the GenX and Dolphyn models to develop a new architecture which is easier and faster to expand to new energy technologies, policies, and sectors.

Macro's key features are:

  • Graph-based representation of the energy system, facilitating clear representation and analysis of energy and mass flows between sectors.
  • "Plug and play" flexibility for integrating new technologies and sectors, including electricity, hydrogen, heat, and transport.
  • High spatial and temporal resolution to accurately capture sector dynamics.
  • Designed for distributed computing to enable large-scale optimizations.
  • Tailored Benders decomposition framework for optimization.
  • Open-source built using Julia and JuMP.

Citing Macro

If you use Macro, please cite the current version of the software and the software paper.

The version citation is available in the "About" section of the GitHub repository.

We have submitted a peer-reviewed paper describing Macro, but please cite the preprint in the meantime:

@article{macdonald2025macroenergy,
  title={MacroEnergy. jl: A large-scale multi-sector energy system framework},
  author={Macdonald, Ruaridh and Pecci, Filippo and Bonaldo, Luca and Law, Jun Wen and Weng, Yu and Mallapragada, Dharik and Jenkins, Jesse},
  journal={arXiv preprint arXiv:2510.21943},
  year={2025}
}

Installation

You can install Macro (aka.MacroEnergy.jl) using the Julia package manager:

using Pkg
Pkg.add("MacroEnergy")

If you wish to make additons to Macro, please follow the installation instructions in the documentation, on the Getting Started / Installation page.

Learning to use Macro

Documentation

The Macro documentation can be found here.. The documentation contains five main resources:

  • A getting started section, which shows you how to install and run Macro.
  • Guides, which walk you through how to achieve specfic tasks using Macro.
  • A manual, which describes all the components and features of Macro in detail.
  • Tutorials, which are extended guides with worked examples
  • A function reference, which etails the API and functions available with Macro.

Bug reports

Please report any bugs or new feature requrests on the Issues page of this repository.

Citation (CITATION.cff)

cff-version: 1.2.0
message: "If you use Macro, please cite the release version and software paper below"
authors:
- family-names: "Macdonald"
  given-names: "Ruaridh"
  orcid: "https://orcid.org/0000-0001-9034-6635"
- family-names: "Pecci"
  given-names: "Filippo"
  orcid: "https://orcid.org/0000-0003-3200-0892"
- family-names: "Bonaldo"
  given-names: "Luca"
  orcid: "https://orcid.org/0009-0000-0650-0266"
- family-names: "Law"
  given-names: "Jun Wen"
  orcid: "https://orcid.org/0009-0001-8766-3100"
- family-names: "Weng"
  given-names: "Yu"
  orcid: "https://orcid.org/0000-0003-3958-1546"
- family-names: "De Bella"
  given-names: "Alice"
  orcid: "https://orcid.org/0000-0003-3814-7537"
- family-names: "Li"
  given-names: "Anna X."
  orcid: "https://orcid.org/0000-0002-3435-3651"
- family-names: "Vuppanapalli"
  given-names: "Chaitanya"
  orcid: "https://orcid.org/0009-0003-6893-6366"
- family-names: "Cole"
  given-names: "David"
- family-names: "Dimanchev"
  given-names: "Emil"
  orcid: "https://orcid.org/0000-0001-8240-5922"
- family-names: "Luo"
  given-names: "Hongxi"
  orcid: "https://orcid.org/0000-0003-4824-9385"
- family-names: "Langlieb"
  given-names: "Jonah"
  orcid: "https://orcid.org/0000-0002-9949-1123"
- family-names: "Atouife"
  given-names: "Mohamed"
  orcid: "https://orcid.org/0009-0003-3457-6761"
- family-names: "Lyu"
  given-names: "Ruike"
  orcid: "https://orcid.org/0000-0003-3749-1117"
- family-names: "Chakrabarti"
  given-names: "Sambuddha"
  orcid: "https://orcid.org/0000-0002-8916-5076"
- family-names: "Mallapragada"
  given-names: "Dharik"
  orcid: "https://orcid.org/0000-0002-0330-0063"
- family-names: "Jenkins"
  given-names: "Jesse"
  orcid: "https://orcid.org/0000-0002-9670-7793"
title: "MacroEnergy.jl"
version: 0.1.0
date-released: 2026-04-14
url: "https://github.com/macroenergy/MacroEnergy.jl"

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 1,544
Total Committers: 17
Avg Commits per committer: 90.824
Development Distribution Score (DDS): 0.671

Commits in past year: 696
Committers in past year: 16
Avg Commits per committer in past year: 43.5
Development Distribution Score (DDS) in past year: 0.655

Name Email Commits
lbonaldo b****2@g****m 508
Ruaridh Macdonald r****d@m****u 502
Filippo Pecci p****o@g****m 320
Mohamed Atouife 1****0 55
Anna Li l****9@g****m 47
Junwenlaw 9****w 28
Emil Dimanchev e****d@m****u 28
Ruike Lyu (吕睿可) 4****9 17
lbonaldo 3****. 15
Jesse Jenkins j****s@g****m 7
HongxiLuo h****2@p****u 5
Chakrabarti, Sambuddha (Sam) s****i@g****m 4
CompatHelper Julia c****y@j****g 2
Alice Di Bella 9****e 2
JZL 1****L 2
Emil Dimanchev e****i@M****e 1
David Cole d****c@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 4 days ago

Total issues: 25
Total pull requests: 147
Average time to close issues: 28 days
Average time to close pull requests: 12 days
Total issue authors: 7
Total pull request authors: 12
Average comments per issue: 2.12
Average comments per pull request: 0.65
Merged pull request: 101
Bot issues: 0
Bot pull requests: 0

Past year issues: 11
Past year pull requests: 91
Past year average time to close issues: about 1 month
Past year average time to close pull requests: 5 days
Past year issue authors: 4
Past year pull request authors: 10
Past year average comments per issue: 1.73
Past year average comments per pull request: 0.55
Past year merged pull request: 62
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=ps://github.com/macroenergy/macroenergy.jl

Top Issue Authors

  • acpascale (7)
  • Junwenlaw (7)
  • filippopecci (4)
  • lbonaldo (3)
  • RuaridhMacd (2)
  • JuliaTagBot (1)
  • HongxiLuo (1)

Top Pull Request Authors

  • RuaridhMacd (59)
  • lbonaldo (47)
  • filippopecci (18)
  • anna-x-li (6)
  • EmilDimanchev (4)
  • Junwenlaw (4)
  • sambuddhac (2)
  • JesseJenkins (2)
  • Rick10119 (2)
  • Mohamedat0 (1)
  • JZL (1)
  • Wendy-YuWENG (1)

Top Issue Labels

  • enhancement (9)
  • bug (2)
  • discussion (1)

Top Pull Request Labels

  • documentation (43)
  • enhancement (34)
  • bug (14)
  • breaking-change (1)
  • refactor (1)

Dependencies

.github/workflows/CompatHelper.yml actions
.github/workflows/TagBot.yml actions
  • JuliaRegistries/TagBot v1 composite
.github/workflows/ci.yml actions
  • actions/checkout v4 composite
  • julia-actions/cache v2 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/julia-processcoverage v1 composite
  • julia-actions/julia-runtest latest composite
  • julia-actions/setup-julia latest composite
.github/workflows/documentation.yml actions
  • actions/checkout v4 composite
  • julia-actions/cache v2 composite
  • julia-actions/julia-buildpkg latest composite
  • julia-actions/julia-docdeploy latest composite
  • julia-actions/setup-julia v2 composite
.devcontainer/Dockerfile docker
  • julia 1.11-bookworm build

Score: 7.123672785204607