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.
- Host: GitHub
- URL: ps://github.com/macroenergy/macroenergy.jl
- Owner: macroenergy
- License: mit
- Created: 2023-10-25T13:41:42.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2026-05-01T05:48:27.000Z (13 days ago)
- Last Synced: 2026-05-04T02:11:51.427Z (10 days ago)
- Language: Julia
- Homepage: https://macroenergy.github.io/MacroEnergy.jl/
- Size: 49 MB
- Stars: 44
- Watchers: 8
- Forks: 35
- Open Issues: 29
- Releases: 3
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Citation: CITATION.cff
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
- Name: MacroEnergy
- Login: macroenergy
- Email:
- Kind: organization
- Description:
- Website:
- Location:
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/114940386?v=4
- Repositories: 2
- Last ynced at: 2023-05-09T14:33:37.891Z
- Profile URL: https://github.com/macroenergy
GitHub Events
Total
- Create event: 32
- Commit comment event: 5
- Release event: 1
- Delete event: 43
- Pull request event: 115
- Fork event: 19
- Issues event: 9
- Watch event: 24
- Issue comment event: 58
- Push event: 282
- Pull request review comment event: 44
- Pull request review event: 84
Last Year
- Create event: 19
- Commit comment event: 5
- Release event: 1
- Delete event: 23
- Pull request event: 85
- Fork event: 17
- Issues event: 8
- Watch event: 16
- Issue comment event: 45
- Push event: 190
- Pull request review comment event: 41
- Pull request review event: 72
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 | 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:
- mit.edu: 2
- mac.fios-router.home: 1
- julialang.org: 1
- princeton.edu: 1
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
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
- JuliaRegistries/TagBot v1 composite
- 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
- 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
- julia 1.11-bookworm build
Score: 7.123672785204607