FINITO Link by mmowers · Pull Request #128 · ReEDS-Model/ReEDS

mmowers · 2026-06-23T23:06:38Z

Summary

This PR provides a linkage to the FINITO model, which is currently a private repository at https://github.com/NatLabRockies/FINITO). The linkage allows the full electricity sector detail of the ReEDS model to be used in combination with the industrial (and other) sector representation of the FINITO model.

The linkage is turned off by default, so this PR itself should not have impact on ReEDS results (although very small differences were observed in out years, presumably because the ReEDS model itself was touched, even if the matrix is identical).

For a high-level overview of FINITO and the linkage points see this slide deck.

See companion FINITO PR: https://github.com/NatLabRockies/FINITO/pull/438

Technical details

Turning on the linkage adds the constraints of the FINITO model to those of the ReEDS model, and adds the two objective functions together.

To turn on the linkage, clone the FINITO model and checkout the bs/reeds_link2 branch, unless this branch has already been merged into main, at which point main.

Configure these switches:

GSw_FINITO_Link: This switch turns on the linkage
finito_dir: This switch needs to point to the FINITO directory as a complete, absolute path
finito_cases_file: This switch should be the suffix of the cases file in the FINITO directory, which contains the corresponding FINITO scenario configuration
finito_case: This switch is the specific case in finito_cases_file to be run
first_year_finito: This switch is the first year that the linkage will be implemented

The reeds conda environment should be used for the linked model.

Linked runs result in the the same set of ReEDS outputs, but new outputs are also added from FINITO in the finito subdirectory of the run directory.

Relevant sources or documentation

FINITO documentation is at https://github.com/NatLabRockies/FINITO

Validation, testing, and comparison report(s)

A comparison of default (Ref) was made berfore and after this change, showing no changes, as expected:
reeds_report_ref_2026-08-05.zip

Running the USA_fast case with the linkage turned on results in moderate generation differences to the ReEDS standalone "USA_fast", but similar amonts of fossil and renewables by 2050:

Electricity load differences show that FINITO endogenous industrial electricity demand is lower than the reference demand that was removed from the EER load profiles, even in the near term:

Gas price differences align with gas generation differences by 2050, although alignment isn't perfect for the years before:

See more results of the comparison here:
reeds_report_finito_vs_usa-fast_plus4_2026-08-08.zip

Also, a more thorough comparison of the reference industrial electricity load that was removed from ReEDS load profiles, as compared to the endogenous finito load that was added back in, is here:
finito_load_check_2026-08-06.zip

Checklist for author

Details to double-check

General information to guide review

Zero impact on results of default case
No large data file(s) added/modified
No substantive impact on runtime for full-US reference case
No substantive impact on folder size for full-US reference case
No change to process flow (runreeds.py, reeds/core/solve/solve.py)
No change to code organization
No change to package requirements (environment.yml or Project.toml)

Did you use LLM tools (chatbot or copilot) in the preparation of this PR? If so, describe how

Tag points of contact here if you would like additional review of the relevant parts of the model

…/finito_link

…NITO output

…O for resource adequacy calcs

bsergi

Thanks for the helpful feedback here--I took a pass at addressing most of these but let me know if there's any I missed.

I plan to rerun the comparison cases once the HPC comes back. The other outstanding piece is that I'm still sorting through the best way to report fuel prices for coal, biomass, and nuclear from FINITO just to ensure our system cost isn't missing any fuel costs.

bsergi · 2026-08-28T14:18:07Z

-pras_unitsize_source,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,r2x
-pras_vre_combine,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1
-pras_samples,,,,,,10,10,10,,,,,,,,,,,,,,,,10,10,,,,,,
+,Default Value,Pacific,USA_defaults,Mid_Case,USA_decarb,github_Pacific,github_Everything,github_MA_county_CC,Pacific_CC,Pacific_weks,Pacific_full_year,Interday_storage,Pacific_2020,Pacific_rep15,WY_county,WECC_county,PJM_county_CC,NYVT_mixed,OR_water,MonteCarlo_Random,MonteCarlo_LHS,Everything,Simple,USA_fast,USA_faster,MultiMetricRA,Pacific_DR,Pacific_MGA,Pacific_LoadSite95,MARICTNYNJPAOH_Offshore,R2P,FINITO,FINITO_Pacific


The original motivation for two was to have a quick test and a test with the recommended defaults for a national-scale linked run. I'll move the latter to the cases_examples.csv.

My thinking for including the quick test here was that it would be nice as part of Kennedy's regular checks to run a linked case to see if it's working or not. There wouldn't necessarily be an obligation to fix before merging, but it could be helpful for tracing when something broke (it already seems like we have some test cases that are failing in the tagged versions).

bsergi · 2026-08-28T14:35:03Z

 demandscen,Demand scenario (see inputs\load),N/A,AEO_2026_baseline,
 dr_shedscen,DR shed scenario,demo_data_January_2025,demo_data_January_2025,
 evmcscen,EVMC scenario for load and supply curve and flexibility,Baseline,Baseline,
+GSw_FINITO_Link,Switch to enable linkage with FINITO,0; 1,0,


bsergi · 2026-08-28T14:42:13Z

+finito_dir,Directory with cloned FINITO repository,N/A,/path/to/FINITO/directory,
+finito_cases_file,"extension of the FINITO cases file including all scenarios to be run, e.g., 'linked' for cases_linked.csv",N/A,linked,
+finito_case,Case name for FINITO in {finito_dir}/cases_linked.csv; use 'same' if the scenario name in cases_linked.csv matches the scenario name in the cases file,N/A,BAUfast,
+first_year_finito,First year when the FINITO module is enabled,N/A,2018,


I'm open to the idea, but how would this work given that FINITO starts in 2018 and StartMarkets is set to 2026? Are you proposing to try not running FINITO until 2026?

bsergi · 2026-08-28T14:51:43Z

+* ----- ReEDS-FINITO temporal parameters -----
+*=============================================
+$ifthene.linked_finito_temporal_params %GSw_FINITO_Link% ==1
+$include finito/model/linked_finito_temporal_params.gms


Thought I rooted all these out previously but looks like I missed a few.

bsergi · 2026-08-28T16:51:28Z

+* (ReEDS-FINITO) also reset t_finito
+$ifthene.linked_finito_time %GSw_FINITO_Link% == 1
+t_finito(t) = no ; 
+t_finito(t)$[tmodel(t)$(t.val>=first_year_finito)$(t.val<=endyear)] = yes ;


The refer to the same thing--standardized this one to match.

bsergi · 2026-09-25T16:15:21Z

+$ifthene.linked_load Sw_FINITO_Link==1
+    + (USE_ELE_FINITO(r,h,t) / (1.0 - distloss))$[t_finito(t)] * (1 + prm(r,t)$h_stress(h))
+$endif.linked_load


Similar to the other comment, but that approach will cause an error since USE_ELE_FINITO is only defined if FINITO is linked.

bsergi · 2026-09-25T16:22:09Z

+* capture from industry when linked with FINITO [metric_tons-CO2/hr]: 
+* calculation: hours_per_year [yrs/hr] * capture [scaled_metric_tons-CO2/yr] / co2_scale [scaled_metric_tons-CO2/metric_tons-CO2]


bsergi · 2026-09-25T16:29:02Z

    + sum{rr$co2_routes(r,rr), CO2_FLOW(rr,r,h,t) - CO2_FLOW(r,rr,h,t) }
+
+* (ReEDS-FINITO) extraction - use of CO2 [metric_tons-CO2/hr] 
+*calculation: hours_per_year [yrs/hr] * (1 / co2_scale [scaled_metric_tons-CO2/metric_tons-CO2]) * extraction/use [scaled_metric_tons-CO2/yr]


Thanks for flagging. I think many of these errors were holdover to when FINITO didn't have the h representation.

bsergi · 2026-09-29T20:54:00Z

+* (ReEDS-FINITO) extraction of CO2 [metric_tons-CO2/hr] 
+* calculation: hours_per_year [yrs/hr] * (1 / co2_scale [scaled_metric_tons-CO2/metric_tons-CO2]) * use [scaled_metric_tons-CO2/yr] 
+$ifthene.linked_co2_spurline_caplimit Sw_FINITO_Link==1
+    + [ (1 / co2_scale) * EXTRACT_CO2_CS(cs,r,h,t) ]$[h_rep(h)$t_finito(t)]


I think that's right about being used to reduce model size. I chatted through this with Charalampos and we think the best approach would be to remove the h_rep(h) conditionals throughout the CO2 equations for the time being so as to be consistent, and to open an issue on the need to revisit ways to improve the CO2 detail treatment more generally.

bsergi · 2026-10-02T18:37:33Z


 *gas used from each bin is the sum of all gas used
-eq_gasused(cendiv,h,t)$[tmodel(t)$((Sw_GasCurve=0) or (Sw_GasCurve=3))]..
+eq_gasused(cendiv,h,t)$[tmodel(t)$tfuel(t)$((Sw_GasCurve=0) or (Sw_GasCurve=3))]..


I went through to verify the new not tfinito(t) is applied to all the supply curve constraints.

bsergi and others added 22 commits April 15, 2026 14:35

branch transfer finito linkage

436ade0

branch transfer finito linkage

0424508

Merge branch 'bs/finito_link' of github.com:ReEDS-Model/ReEDS into bs…

3596316

…/finito_link

Merge remote-tracking branch 'origin/main' into bs/finito_link

e76819c

Fix windows bug in outputs for linked ReEDS-FINITO runs

5fd4848

Merge branch 'main' into bs/finito_link

a2c1935

Update to autopop_set.py call

99147d1

Merge remote-tracking branch 'origin/main' into bs/finito_link

c06a183

Merge remote-tracking branch 'origin/main' into bs/finito_link

e74e2c4

Update region switches in cases_finito.csv

6c98dde

Fix bug in report.gms for linked FINITO runs

046b21d

Add comment to report.gms

8cecf3c

Convert USE_ELE_FINITO to busbar load when using in ReEDS

b0720c9

error handling for missing finito gdx file

bf47a9b

error handling for finito gdx

eaaaa7e

Merge with main

32c5b48

Fix bug in standalone ReEDS outputs by putting if statement around FI…

877b591

…NITO output

Update to z54 by default in cases_finito.csv

86c4093

Remove round statement to align with main

74443a6

Cleaning up unnecessary changes for cleaner comparison to main

9688064

Remove old switch from cases_finito.csv

93bd58b

Remove call to removed finito file

d687d47

mmowers marked this pull request as ready for review July 2, 2026 15:50

mmowers added 4 commits July 2, 2026 12:31

Revert to main for Canada switch behavior

5aa7540

Revert to main for rounding of parameters

ea246a9

Add FINITO case to cases_test.csv

88ff50d

Update FINITO case

6310db7

bsergi changed the title ~~Finito Link~~ FINITO Link Jul 6, 2026

bsergi and others added 2 commits July 6, 2026 16:02

clean up finito_dir entry

02f14b8

For now, use only rep period load (not stress period load) from FINIT…

58f1227

…O for resource adequacy calcs

github-actions Bot added the docs label Sep 12, 2026

bsergi and others added 12 commits September 16, 2026 14:26

clean up call to read_mecs_heat.py

b6bcf53

set default FINITO case to 10-year timesteps

181bc1b

Update FINITO cases with recommend H2 settings

ed72971

A few other default settings for FINITO cases

64ae189

Add switch compatability for FINITO runs

b6b55f5

clean natural gas price reporting with FINITO

f08a332

clean out some TODO items

298d830

reorder dataframe pivot before merge for speed up

65c0931

clean up copying of FINITO files with restart_runs.py

2fc9e5a

tfuel indent and comment cleanup

56c32a3

revised gas switch compability check

af4fa74

Merge remote-tracking branch 'origin/main' into bs/finito_link

3a6edbf

bsergi force-pushed the bs/finito_link branch from 6293f78 to 3a6edbf Compare September 27, 2026 21:41

bsergi added 11 commits September 29, 2026 16:55

remove h_rep from CO2 constraints, some cleanup

5a0563f

t_finito --> tfinito

a544a96

tfuel --> tfinito_all

1d48a51

re-enable restarting runs that are finished for postprocessing

2d8ab99

wrap long line for FINITO obj

ee8b66e

avoid duplicated code by using existing tfinito_all set

aa95695

turn off H2 PTC in FINITO example

2ebd0e2

remove requirement for GSw_GasCurve = 2

6685fe3

cleanup on a few comments

10afd07

cleanup on a few reporting items

86c781f

Merge remote-tracking branch 'origin/main' into bs/finito_link

12a3830

bsergi reviewed Oct 2, 2026

View reviewed changes

bsergi requested a review from cavraam October 2, 2026 20:26

patrickbrown4 self-requested a review October 2, 2026 20:45

bsergi added 2 commits October 5, 2026 11:15

fix endyear for FINITO run

ea89c23

clean up a few user-guide typos

2d1c8bf

Navigation Menu

Repository navigation

FINITO Link - #128

FINITO Link#128
mmowers wants to merge 105 commits into
mainfrom
bs/finito_link

mmowers commented Jun 23, 2026 •

edited

Loading

Uh oh!

bsergi left a comment

Uh oh!

bsergi Aug 28, 2026

Uh oh!

bsergi Aug 28, 2026

Uh oh!

bsergi Aug 28, 2026

Uh oh!

bsergi Aug 28, 2026

Uh oh!

bsergi Aug 28, 2026

Uh oh!

bsergi Sep 25, 2026

Uh oh!

bsergi Sep 25, 2026

Uh oh!

bsergi Sep 25, 2026

Uh oh!

bsergi Sep 29, 2026

Uh oh!

bsergi Oct 2, 2026

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

		* capture from industry when linked with FINITO [metric_tons-CO2/hr]:
		* calculation: hours_per_year [yrs/hr] * capture [scaled_metric_tons-CO2/yr] / co2_scale [scaled_metric_tons-CO2/metric_tons-CO2]

Conversation

mmowers commented Jun 23, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Technical details

Relevant sources or documentation

Validation, testing, and comparison report(s)

Checklist for author

Details to double-check

General information to guide review

Did you use LLM tools (chatbot or copilot) in the preparation of this PR? If so, describe how

Tag points of contact here if you would like additional review of the relevant parts of the model

Uh oh!

bsergi left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

This branch has not been deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

mmowers commented Jun 23, 2026 •

edited

Loading