STRE³AM

The Strategic Technology Roadmapping and Energy, Environmental, and Economic Analysis Model is an optimization-based modeling tool and analysis framework to assist with strategic planning and technology investments of the industrial sector.
https://github.com/anl-ceeesa/stream

Category: Energy Systems
Sub Category: Energy System Modeling Frameworks

Keywords

argonne energy-system-model industry

Last synced: about 20 hours ago
JSON representation

Repository metadata

Strategic Technology Roadmapping and Energy, Environmental, and Economic Analysis Model

README.md

STRE3AM

Strategic Technology Roadmapping, and Energy, Environmental, and Economic Analysis Model

The Strategic Technology Roadmapping and Energy, Environmental, and Economic
Analysis Model STRE3AM is an optimization-based modeling tool and
analysis framework to assist with strategic planning and technology investments
of the industrial sector. This open-source framework is written in Julia using
JuMP objects, which enables users to model future pathways for incumbent and
future production technologies, fuels and energy carriers, emissions, and other
impacts from industries as they transform in pursuit of a robust, competitive,
resilient, and sustainable manufacturing sector. The model starts with an
initial stock of industrial production technologies and assets at a facility
level or an aggregated national level, and then determines pathways that
minimize cost or similar economic objective(s), subject to an array of
constraints on demand, annual or cumulative emissions, market shares, and other
exogenously specified operational considerations such as capacity utilization
rates or regional availability of feedstocks and energy sources. Key features of
the framework include flexibility to model a wide range of industries and
industrial technologies/processes at varying levels of granularity from
facility-level to regional or national level, ability to perform parametric
sensitivity analyses, and ability to visualize model results using visualization
objects.

Documentation

Documentation.

Source Code Organization

Directory Description
test/ testing files
instance/ case studies
data/ instance data
src/ source code
docs/ documentation src

Key Requirements

Quick installation

After installing Julia, conda, and git.

In the terminal the following should be typed.

git clone https://github.com/ANL-CEEESA/STREAM.git

This will clone the repository. Then at the STREAM repository, start the
Julia REPL by typing in the terminal:

julia

Then, at the REPL pressing the ] key one, would start the package manager,
i.e.,

(@v1.11) pkg> 

At this point the following command should activate the environment,

activate .

Followed by

instantiate

This will get the stre3am module ready to be used. E.g. at the command-line
interface,

user@local directory % julia --project=/path_to_STREAM/
               _
   _       _ _(_)_     |  Documentation: https://docs.julialang.org
  (_)     | (_) (_)    |
   _ _   _| |_  __ _   |  Type "?" for help, "]?" for Pkg help.
  | | | | | | |/ _` |  |
  | | |_| | | | (_| |  |  Version 1.11.6 (2025-07-09)
 _/ |\__'_|_|_|\__'_|  |  Official https://julialang.org/ release
|__/                   |

julia> using stre3am

The final step is optional.
At the STREAM folder, the following must by typed in the terminal:

conda env create --name stre3am --file environment.yml 

And then activating i.e. conda activate stre3am.

Software X

Please refer to this page for further instructions.

Contributors

  • David Thierry, Argonne National Laboratory, ESIA division
  • Sarang Supekar, Argonne National Laboratory, ESIA division
  • Jeff Bennett, Argonne National Laboratory, ESIA division

License

STRE3AM (stre3am) is licensed under the 3-Clause BDS licence.
Additionally, STRE3AM (stre3am) utilizes several dependencies, which
have their own licences. Please refer to their respective repositories for more
information about the licenses.


Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 115
Total Committers: 8
Avg Commits per committer: 14.375
Development Distribution Score (DDS): 0.148

Commits in past year: 12
Committers in past year: 2
Avg Commits per committer in past year: 6.0
Development Distribution Score (DDS) in past year: 0.167

Name Email Commits
dthierry d****y@g****m 98
dthierry d****y@C****l 8
Sarang Supekar s****r@g****m 3
Thierry D d****y@a****v 2
dthierry d****y@e****v 1
dthierry d****y@e****v 1
dthierry d****y@e****v 1
dthierry d****y@C****l 1

Committer domains:


Issue and Pull Request metadata

Last synced: 8 months ago

Total issues: 0
Total pull requests: 8
Average time to close issues: N/A
Average time to close pull requests: 1 minute
Total issue authors: 0
Total pull request authors: 1
Average comments per issue: 0
Average comments per pull request: 0.13
Merged pull request: 8
Bot issues: 0
Bot pull requests: 0

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

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/anl-ceeesa/stream

Top Issue Authors

Top Pull Request Authors

  • dthierry (8)

Top Issue Labels

Top Pull Request Labels


Dependencies

environment.yml conda
  • geopandas
  • matplotlib
  • pandas
  • python
Manifest.toml julia
  • 103 dependencies
Project.toml julia
  • CSV *
  • DataFrames *
  • Dates *
  • Gurobi *
  • HiGHS *
  • Interpolations *
  • JuMP *
  • Printf *
  • XLSX *

Score: 3.1780538303479453