Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
92 commits
Select commit Hold shift + click to select a range
436ade0
branch transfer finito linkage
Apr 15, 2026
0424508
branch transfer finito linkage
bsergi Apr 16, 2026
3596316
Merge branch 'bs/finito_link' of github.com:ReEDS-Model/ReEDS into bs…
bsergi Apr 16, 2026
e76819c
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi Apr 16, 2026
5fd4848
Fix windows bug in outputs for linked ReEDS-FINITO runs
mmowers Apr 23, 2026
a2c1935
Merge branch 'main' into bs/finito_link
May 12, 2026
99147d1
Update to autopop_set.py call
May 13, 2026
c06a183
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi May 22, 2026
e74e2c4
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi May 22, 2026
6c98dde
Update region switches in cases_finito.csv
mmowers May 30, 2026
046b21d
Fix bug in report.gms for linked FINITO runs
mmowers Jun 2, 2026
8cecf3c
Add comment to report.gms
mmowers Jun 3, 2026
b0720c9
Convert USE_ELE_FINITO to busbar load when using in ReEDS
mmowers Jun 3, 2026
bf47a9b
error handling for missing finito gdx file
bsergi Jun 8, 2026
eaaaa7e
error handling for finito gdx
bsergi Jun 8, 2026
32c5b48
Merge with main
mmowers Jun 9, 2026
877b591
Fix bug in standalone ReEDS outputs by putting if statement around FI…
mmowers Jun 9, 2026
86c4093
Update to z54 by default in cases_finito.csv
mmowers Jun 9, 2026
74443a6
Remove round statement to align with main
mmowers Jun 13, 2026
9688064
Cleaning up unnecessary changes for cleaner comparison to main
mmowers Jun 19, 2026
93bd58b
Remove old switch from cases_finito.csv
mmowers Jun 29, 2026
d687d47
Remove call to removed finito file
mmowers Jun 30, 2026
5aa7540
Revert to main for Canada switch behavior
mmowers Jul 2, 2026
ea246a9
Revert to main for rounding of parameters
mmowers Jul 2, 2026
88ff50d
Add FINITO case to cases_test.csv
mmowers Jul 2, 2026
6310db7
Update FINITO case
mmowers Jul 2, 2026
02f14b8
clean up finito_dir entry
bsergi Jul 6, 2026
58f1227
For now, use only rep period load (not stress period load) from FINIT…
mmowers Jul 14, 2026
259f9f1
Fix FINITO load inclusion in handoff to PRAS
mmowers Jul 14, 2026
c82fbc3
Remove completed TODO item
mmowers Jul 14, 2026
27ca6a7
Add USA_fast case settings to FINITO case in cases_test.csv
mmowers Jul 14, 2026
8e86fe5
Merge with main
mmowers Jul 17, 2026
8f0f564
Fix bug in finito load adjustments
mmowers Jul 17, 2026
33717fd
Convert finito reference load to busbar before subtracting
mmowers Jul 17, 2026
c04037e
Simplify comment
mmowers Jul 17, 2026
c75cc9b
Clip negative loads after subtracting finito reference load, and add …
mmowers Jul 17, 2026
449b115
Fix region handling in FINITO-linkage
mmowers Jul 19, 2026
7593735
Fix H2 fixed-price bug in ReEDS-FINITO linkage
mmowers Jul 22, 2026
92fe3f3
Merge with main
mmowers Jul 29, 2026
27da55f
reduce some duplicative code
bsergi Jul 30, 2026
a9020dc
Merge branch 'bs/finito_link' of github.com:ReEDS-Model/ReEDS into bs…
bsergi Jul 30, 2026
7174aa2
remove cases_finito.csv
bsergi Jul 31, 2026
9f94ef4
some comment and formatting changes
bsergi Jul 31, 2026
2e604e7
add FINITO column to cases_test.csv
bsergi Jul 31, 2026
df894f1
fix bug in FINITO cases file setup
bsergi Jul 31, 2026
5f3bf1b
updates to gas and biomass pricing (need to finalize)
bsergi Jul 31, 2026
d0738d6
Add FINITO_Pacific case to cases_test.csv
mmowers Jul 31, 2026
48b4a06
Fix bug: Add missing .l suffix
mmowers Aug 5, 2026
3f6e960
Fix FINITO gas price aggregation bug in report.gms
mmowers Aug 5, 2026
7ee8166
Fix divide by zero in ReEDS-FINITO repbioprice output
mmowers Aug 5, 2026
ac23719
Fix repgasprice_finito weighting
mmowers Aug 6, 2026
d5c230e
Fix repgasprice overwrite for finito-linked years
mmowers Aug 6, 2026
49b2f31
Fix ng price in finito-linked runs by using the correct finito constr…
mmowers Aug 7, 2026
d899f5f
Add finito_load_check.py
mmowers Aug 7, 2026
52cfb69
Add missing reference lines on finito_load_check.py
mmowers Aug 7, 2026
b2adca4
Fix gas price reporting for finito-linked runs
mmowers Aug 7, 2026
386381c
Convert finito electricity load from end-use to busbar
mmowers Aug 8, 2026
f5babb4
Output annual LOAD.l
mmowers Aug 8, 2026
99f61b8
clean up old comment
bsergi Aug 11, 2026
2ca82c0
generalize FINITO path in cases.csv
bsergi Aug 11, 2026
9ed9a74
separate gas price reporting for supply curves and detailed fuels
bsergi Aug 11, 2026
6ee34b8
Remove finito_load_check.py script
mmowers Aug 11, 2026
5685ec2
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi Aug 12, 2026
73a23fa
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi Aug 13, 2026
daf14e5
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi Aug 28, 2026
989952e
fix some missing / to %ds% in gams
bsergi Aug 28, 2026
e2fd61f
move finito functions into separate script
bsergi Aug 28, 2026
2d86312
cleaning up the finito python module
bsergi Aug 28, 2026
948bf47
clean up FINITO switches in cases_test.csv
bsergi Aug 28, 2026
c9469cc
reorganization of FINITO switches
bsergi Aug 28, 2026
9f79b1c
avoid hardcoded FINITO dollaryear
bsergi Sep 9, 2026
b69ddcc
fix missing arguments
bsergi Sep 9, 2026
053ab53
load sw in function instead of passing as an argument
bsergi Sep 9, 2026
23e0c9b
add FINITO_first_year to call to solve_oneyear.gms
bsergi Sep 9, 2026
4a299e8
formatting
bsergi Sep 9, 2026
5db2ab2
add full FINITO case to cases_examples.csv
bsergi Sep 9, 2026
7a38f6a
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi Sep 9, 2026
fd2c0a2
Sw_DetailedFuels --> Sw_DetailedNG
bsergi Sep 9, 2026
1fa486f
add FINITO dollaryear to cases file
bsergi Sep 10, 2026
bdbcfd7
initial pass at user guide section for ReEDS-FINITO
bsergi Sep 12, 2026
b6bcf53
clean up call to read_mecs_heat.py
bsergi Sep 16, 2026
181bc1b
set default FINITO case to 10-year timesteps
bsergi Sep 18, 2026
ed72971
Update FINITO cases with recommend H2 settings
bsergi Sep 25, 2026
64ae189
A few other default settings for FINITO cases
bsergi Sep 25, 2026
b6b55f5
Add switch compatability for FINITO runs
bsergi Sep 25, 2026
f08a332
clean natural gas price reporting with FINITO
bsergi Sep 25, 2026
298d830
clean out some TODO items
bsergi Sep 25, 2026
65c0931
reorder dataframe pivot before merge for speed up
bsergi Sep 25, 2026
2fc9e5a
clean up copying of FINITO files with restart_runs.py
bsergi Sep 25, 2026
56c32a3
tfuel indent and comment cleanup
bsergi Sep 25, 2026
af4fa74
revised gas switch compability check
bsergi Sep 26, 2026
3a6edbf
Merge remote-tracking branch 'origin/main' into bs/finito_link
bsergi Sep 26, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .github/PULL_REQUEST_TEMPLATE.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ Include additional illustrative plots describing input data, methods, testing, a
<!-- - [ ] Demand data: @ahamilton5 -->
<!-- - [ ] Emissions: @atpham88 -->
<!-- - [ ] Financial calculations: @wesleyjcole -->
<!-- - [ ] FINITO: @merveturan or @cavraam -->
<!-- - [ ] FINITO: @bsergi or @cavraam -->
<!-- - [ ] Hybrids: @aschleif -->
<!-- - [ ] Monte Carlo: @bsergi -->
<!-- - [ ] Sparse chronology or interday diurnal storage: @Yunzhi-Chen -->
Expand Down
6 changes: 6 additions & 0 deletions cases.csv
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,12 @@ depreciation_schedules_suffix,File suffix for depreciation schedules,default,def
financials_sys_suffix,File suffix for the system-wide system discount rate,ATB(2023|2024),ATB2024,
financials_tech_suffix,File suffix for technology-specific financial assumptions (see inputs\financials_tech),ATB(2023|2023_CRP20|2024),ATB2024,
financials_trans_suffix,File suffix for transmission financial assumptions,default; 30ITC_0pen_2022_2031,default,
FINITO,Switch to enable running linked ReEDS-FINITO model (mapped to GSw_FINITO_Link),0; 1,0,
FINITO_cases_file,"Filename suffix of the FINITO cases file that includes the scenarios to be run (e.g., 'linked' for cases_linked.csv)",N/A,linked,
FINITO_case,FINITO case for this run; must be a column in the files specified by FINITO_cases_file. Use 'same' if the ReEDS run name matches the FINITO case name,N/A,same,
FINITO_dir,Directory with cloned FINITO repository,N/A,{reeds_path}/../FINITO,
FINITO_dollaryear,[$] real dollar year for FINITO; do not change until all inputs and reporting are adjusted appropriately,2018,2018,
FINITO_first_year,First year when the FINITO module is to be run,N/A,2018,
incentives_suffix,File suffix for incentive definition,ira; obbba; obbba_conservative; annual; biennial; ira_45q_45v_extension; none,obbba,
inflation_suffix,File suffix for historical inflation schedule,default,default,
ivt_suffix,File suffix for ivt csv file,default; small; step,default,
Expand Down
41 changes: 24 additions & 17 deletions cases_examples.csv
Original file line number Diff line number Diff line change
@@ -1,17 +1,24 @@
,Default Value,ERCOT_rep_days,ERCOT_rep_wek,ERCOT_full_year,ERCOT_cap_credit,USA_20_rep_days,USA_69_regions,USA_54_regions,USA_FasterSolve,NorthDakota_county,NY_VT_mixed,ERCOT_county
ignore,1,,,,,,,,,,,
endyear,2035,,,,,,,,,,,
GSw_Region,,interconnect/texas,interconnect/texas,interconnect/texas,interconnect/texas,,,,,st/ND,st/NY.VT,interconnect/texas
GSw_ZoneSet,,,,,,,z70,z54,z54,z3109,PJMcounty,z3109
GSw_GasCurve,,2,2,2,2,,,,,2,2,2
GSw_HourlyType,,,wek,year,,,,,,,,
GSw_OpRes,,,,0,,,,,0,,,
GSw_HourlyNumClusters,,,,,,20,,,20,,,
GSw_PRM_CapCredit,,,,,1,,,,,,,
GSw_StartCost,,,,,,,,,0,,,
GSw_LfillGas,,,,,,,,,0,,,
GSw_Geothermal,,,,,,,,,0,,,
GSw_Biopower,,,,,,,,,0,,,
GSw_Nuclear,,,,,,,,,0,,,
GSw_HourlyChunkLengthRep,,,,,,,,,4,,,
GSw_HourlyChunkLengthStress,,,,,,,,,4,,,
,Default Value,ERCOT_rep_days,ERCOT_rep_wek,ERCOT_full_year,ERCOT_cap_credit,USA_20_rep_days,USA_69_regions,USA_54_regions,USA_FasterSolve,NorthDakota_county,NY_VT_mixed,ERCOT_county,FINITO
ignore,1,,,,,,,,,,,,
endyear,2035,,,,,,,,,,,,
yearset,,,,,,,,,,,,,2010..2050..10
GSw_Region,,interconnect/texas,interconnect/texas,interconnect/texas,interconnect/texas,,,,,st/ND,st/NY.VT,interconnect/texas,
GSw_ZoneSet,,,,,,,z70,z54,z54,z3109,PJMcounty,z3109,z54
GSw_GasCurve,,2,2,2,2,,,,,2,2,2,
GSw_HourlyType,,,wek,year,,,,,,,,,
GSw_OpRes,,,,0,,,,,0,,,,
GSw_HourlyNumClusters,,,,,,20,,,20,,,,20
GSw_PRM_CapCredit,,,,,1,,,,,,,,
GSw_StartCost,,,,,,,,,0,,,,
GSw_LfillGas,,,,,,,,,0,,,,
GSw_Geothermal,,,,,,,,,0,,,,
GSw_Biopower,,,,,,,,,0,,,,
GSw_Nuclear,,,,,,,,,0,,,,
GSw_HourlyChunkLengthRep,,,,,,,,,4,,,,4
GSw_HourlyChunkLengthStress,,,,,,,,,4,,,,4
FINITO,,,,,,,,,,,,,1
FINITO_case,,,,,,,,,,,,,BAU
GSw_H2,,,,,,,,,,,,,1
GSw_H2_Demand_Case,,,,,,,,,,,,,BAU
GSw_H2_SMR,,,,,,,,,,,,,1
GSw_GasPriceAdjMethod,,,,,,,,,,,,,0
139 changes: 72 additions & 67 deletions cases_test.csv
Original file line number Diff line number Diff line change
@@ -1,67 +1,72 @@
,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_MGA_RV,Pacific_LoadSite95,MARICTNYNJPAOH_Offshore,R2P
ignore,1,0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_Region,cendiv/Pacific,,country/USA,country/USA,country/USA,,st/ID.WY.NE.IA.IL,st/MA,,,,,,,st/WY,interconnect/western,transreg/PJM,st/NY.VT,st/OR,st/NE.NY.PA,st/NE.NY.PA,st/ID.WY.NE.IA.IL,st/KS,country/USA,country/USA,st/NY.NJ,,,,,st/MA.RI.CT.NY.NJ.PA.OH,
endyear,2035,,2050,2050,2050,2030,2060,2030,,,,,,,,,,,2035,2030,2030,2060,2035,2050,2050,2050,,,,,,
yearset,,,,,,,2010..2060..10,,,,,,,,,,,,,,,2010..2060..10,2010_2015_2020..2050..3,,2010_2025_2050,,,,,,,
GSw_ZoneSet,,,,,,,z54,z3109,,,,,,,z3109,z3109,z3109,PJMcounty,,,,z54,z134,z54,z48,,,,,,,
GSw_GasCurve,2,,1,1,,,,,,,,,,,,,,,,,,,,1,1,,,,,,,
GSw_Geothermal,,,,2,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,
GSw_GrowthPenalties,,,,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_Upstream,,,,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_TransHurdleRate,,,,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,
distpvscen,,,,,stscen2023_mid_case_95_by_2035,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_AnnualCap,,,,,2,,1,,,,,,,,,,,,,,,1,,,,,,,,,,
GSw_AnnualCapScen,,,,,start2024_90pct2035_100pct2045,,start2027_95pct2035,,,,,,,,,,,,,,,start2027_95pct2035,,,,,,,,,,
GSw_LoadProfiles,,,,,EER2025_100by2050,EER2025_IRAlow,EER2025_IRAlow,EER2025_IRAlow,,,,,historic,,,,,,,,,EER2025_100by2050,,,,,historic,,,,,
GSw_NG_CRF_penalty,,,,,ramp_2045,,ramp_2023_2035,,,,,,,,,,,,,,,ramp_2023_2035,,,,,,,,,,
GSw_PRM_NetImportLimit,,,,,0,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_RetirePenalty,,,,,0,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_FakeData,,,,,,1,1,1,,,,,,,,,,,,,,,,,,,,,,,,
GSw_PRM_CapCredit,,,,,,,,1,1,,,,,,,,1,,,,,,,,,,,,,,,
GSw_PRM_scenario,,,,,,,,,static,,,,,,,,static,,,,,,,,,,,,,,,
GSw_PRM_UpdateMethod,,,,,,,,,1,,,,,,,,,,,,,,,,,,,,,,,
GSw_HourlyType,,,,,,,,,,wek,year,,,,,,,,,,,,,,,,,,,,,
GSw_InterDayLinkage,,,,,,,,,,,,1,,,,,,,,,,,,,,,,,,,,
GSw_HourlyWeatherYears,,,,,,,2012_2013,,,,,,2020,2007_2008_2009_2010_2011_2012_2013_2016_2017_2018_2019_2020_2021_2022_2023,,,,,,,,2012_2013,,,,,2018,,,,,
GSw_HourlyClusterMapMethod,,,,,,,,,,,,,,bestfirst,,,,,,,,,,,,,,,,,,
GSw_WaterCapacity,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,,
GSw_WaterMain,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,,
GSw_WaterUse,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,,
resource_adequacy_years,,,,,,,2011_2012_2013_2021_2022_2023,,,,,,,,,,,,,,,2011_2012_2013_2021_2022_2023,,,,,,,,,,
GSw_HourlyClusterAlgorithm,,,,,,,,,,,,,,,,,,,,user,user,,,,,,,,,,,
MCS_runs,,,,,,,,,,,,,,,,,,,,2,2,,,,,,,,,,,
MCS_dist_groups,,,,,,,,,,,,,,,,,,,,tech.hydro.nuclear.gas.coal.load_country,upv_tri.nuclear_tri.ng_fuel_price_tri.load_country_unif,,,,,,,,,,,
MCS_lhs,,,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,
GSw_PRM_StressIterateMax,,,,,,,,0,,,,,,,,0,0,,,1,1,,,,,,,,,,,
GSw_ReducedResource,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,
GSw_SitingUPV,,,,,,limited,limited,limited,,,,,,,,,,,,,,limited,,,,,,,,,,
GSw_SitingWindOfs,,,,,,limited,limited,limited,,,,,,,,,,,,,,open,,,,,,,,,,
GSw_SitingWindOns,,,,,,limited,limited,limited,,,,,,,,,,,,,,limited,,,,,,,,,,
GSw_TransScen,,,,,,,NTP_MT,,,,,,,,,,,,,,,NTP_MT,,,,,,,,,,
GSw_CO2_Detail,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,
GSw_DAC,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,
GSw_NoFossilOffsetCDR,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,
GSw_Biopower,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,
GSw_HourlyChunkLengthRep,,,,,,,,,,,,,,,,,,,,,,,6,4,4,,,,,,,
GSw_HourlyChunkLengthStress,,,,,,,,,,,,,,,,,,,,,,,6,4,4,,,,,,,
GSw_LfillGas,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,
GSw_Nuclear,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,
GSw_OpRes,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,
GSw_StartCost,,,,,,,,,,,,,,,,,,,,,,,0,0,0,,,,,,,
GSw_H2,,,,,,,,,,,,,,,,,,,,,,,,0,0,,,,,,,
GSw_H2_PTC,,,,,,,,,,,,,,,,,,,,,,,,0,0,,,,,,,
GSw_H2Combustion,,,,,,,,,,,,,,,,,,,,,,,,,0,,,,,,,
GSw_PRM_StressThresholdMetrics,,,,,,,,,,,,,,,,,,,,,,,,,,NEUE/LOLH/LOLE/LOLD/duration/depth,,,,,,
GSw_DRShed,,,,,,,,,,,,,,,,,,,,,,,,,,,1,,,,,
GSw_MGA_CostDelta,,,,,,,,,,,,,,,,,,,,,,,,,,,,0.01,0.01,,,
GSw_MGA_RV_runs,,,,,,,,,,,,,,,,,,,,,,,,,,,,,2,,,
GSw_LoadSiteCF,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0.95,,
GSw_OffshoreZones,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,
GSw_OffshoreBackbone,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,
GSw_OffshoreBackflow,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,
pras_agg_ogs_lfillgas,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1
pras_existing_unit_size,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0
pras_scheduled_outage,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0
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_MGA_RV,Pacific_LoadSite95,MARICTNYNJPAOH_Offshore,R2P,Pacific_FINITO
ignore,1,0,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_Region,cendiv/Pacific,,country/USA,country/USA,country/USA,,st/ID.WY.NE.IA.IL,st/MA,,,,,,,st/WY,interconnect/western,transreg/PJM,st/NY.VT,st/OR,st/NE.NY.PA,st/NE.NY.PA,st/ID.WY.NE.IA.IL,st/KS,country/USA,country/USA,st/NY.NJ,,,,,st/MA.RI.CT.NY.NJ.PA.OH,,
endyear,2035,,2050,2050,2050,2030,2060,2030,,,,,,,,,,,2035,2030,2030,2060,2035,2050,2050,2050,,,,,,,
yearset,,,,,,,2010..2060..10,,,,,,,,,,,,,,,2010..2060..10,2010_2015_2020..2050..3,,2010_2025_2050,,,,,,,,
GSw_ZoneSet,,,,,,,z54,z3109,,,,,,,z3109,z3109,z3109,PJMcounty,,,,z54,z134,z54,z48,,,,,,,,z54
GSw_GasCurve,2,,1,1,,,,,,,,,,,,,,,,,,,,1,1,,,,,,,,
GSw_Geothermal,,,,2,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,,
GSw_GrowthPenalties,,,,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_Upstream,,,,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_TransHurdleRate,,,,1,,,,,,,,,,,,,,,,,,,,,,,,,,,,,
distpvscen,,,,,stscen2023_mid_case_95_by_2035,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_AnnualCap,,,,,2,,1,,,,,,,,,,,,,,,1,,,,,,,,,,,
GSw_AnnualCapScen,,,,,start2024_90pct2035_100pct2045,,start2027_95pct2035,,,,,,,,,,,,,,,start2027_95pct2035,,,,,,,,,,,
GSw_LoadProfiles,,,,,EER2025_100by2050,EER2025_IRAlow,EER2025_IRAlow,EER2025_IRAlow,,,,,historic,,,,,,,,,EER2025_100by2050,,,,,historic,,,,,,
GSw_NG_CRF_penalty,,,,,ramp_2045,,ramp_2023_2035,,,,,,,,,,,,,,,ramp_2023_2035,,,,,,,,,,,
GSw_PRM_NetImportLimit,,,,,0,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_RetirePenalty,,,,,0,,,,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_FakeData,,,,,,1,1,1,,,,,,,,,,,,,,,,,,,,,,,,,
GSw_PRM_CapCredit,,,,,,,,1,1,,,,,,,,1,,,,,,,,,,,,,,,,
GSw_PRM_scenario,,,,,,,,,static,,,,,,,,static,,,,,,,,,,,,,,,,
GSw_PRM_UpdateMethod,,,,,,,,,1,,,,,,,,,,,,,,,,,,,,,,,,
GSw_HourlyType,,,,,,,,,,wek,year,,,,,,,,,,,,,,,,,,,,,,
GSw_InterDayLinkage,,,,,,,,,,,,1,,,,,,,,,,,,,,,,,,,,,
GSw_HourlyWeatherYears,,,,,,,2012_2013,,,,,,2020,2007_2008_2009_2010_2011_2012_2013_2016_2017_2018_2019_2020_2021_2022_2023,,,,,,,,2012_2013,,,,,2018,,,,,,
GSw_HourlyClusterMapMethod,,,,,,,,,,,,,,bestfirst,,,,,,,,,,,,,,,,,,,
GSw_WaterCapacity,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,,,
GSw_WaterMain,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,,,
GSw_WaterUse,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,,,
resource_adequacy_years,,,,,,,2011_2012_2013_2021_2022_2023,,,,,,,,,,,,,,,2011_2012_2013_2021_2022_2023,,,,,,,,,,,
GSw_HourlyClusterAlgorithm,,,,,,,,,,,,,,,,,,,,user,user,,,,,,,,,,,,
MCS_runs,,,,,,,,,,,,,,,,,,,,2,2,,,,,,,,,,,,
MCS_dist_groups,,,,,,,,,,,,,,,,,,,,tech.hydro.nuclear.gas.coal.load_country,upv_tri.nuclear_tri.ng_fuel_price_tri.load_country_unif,,,,,,,,,,,,
MCS_lhs,,,,,,,,,,,,,,,,,,,,,1,,,,,,,,,,,,
GSw_PRM_StressIterateMax,,,,,,,,0,,,,,,,,0,0,,,1,1,,,,,,,,,,,,
GSw_ReducedResource,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,,
GSw_SitingUPV,,,,,,limited,limited,limited,,,,,,,,,,,,,,limited,,,,,,,,,,,
GSw_SitingWindOfs,,,,,,limited,limited,limited,,,,,,,,,,,,,,open,,,,,,,,,,,
GSw_SitingWindOns,,,,,,limited,limited,limited,,,,,,,,,,,,,,limited,,,,,,,,,,,
GSw_TransScen,,,,,,,NTP_MT,,,,,,,,,,,,,,,NTP_MT,,,,,,,,,,,
GSw_CO2_Detail,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,,
GSw_DAC,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,,
GSw_NoFossilOffsetCDR,,,,,,,1,,,,,,,,,,,,,,,1,,,,,,,,,,,
GSw_Biopower,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,,
GSw_HourlyChunkLengthRep,,,,,,,,,,,,,,,,,,,,,,,6,4,4,,,,,,,,4
GSw_HourlyChunkLengthStress,,,,,,,,,,,,,,,,,,,,,,,6,4,4,,,,,,,,4
GSw_LfillGas,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,,
GSw_Nuclear,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,,
GSw_OpRes,,,,,,,,,,,,,,,,,,,,,,,0,,0,,,,,,,,
GSw_StartCost,,,,,,,,,,,,,,,,,,,,,,,0,0,0,,,,,,,,
GSw_H2,,,,,,,,,,,,,,,,,,,,,,,,0,0,,,,,,,,
GSw_H2_PTC,,,,,,,,,,,,,,,,,,,,,,,,0,0,,,,,,,,
GSw_H2Combustion,,,,,,,,,,,,,,,,,,,,,,,,,0,,,,,,,,
GSw_PRM_StressThresholdMetrics,,,,,,,,,,,,,,,,,,,,,,,,,,NEUE/LOLH/LOLE/LOLD/duration/depth,,,,,,,
GSw_DRShed,,,,,,,,,,,,,,,,,,,,,,,,,,,1,,,,,,
GSw_MGA_CostDelta,,,,,,,,,,,,,,,,,,,,,,,,,,,,0.01,0.01,,,,
GSw_MGA_RV_runs,,,,,,,,,,,,,,,,,,,,,,,,,,,,,2,,,,
GSw_LoadSiteCF,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0.95,,,
GSw_OffshoreZones,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,,
GSw_OffshoreBackbone,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,,
GSw_OffshoreBackflow,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,,
pras_agg_ogs_lfillgas,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,
pras_existing_unit_size,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0,
pras_scheduled_outage,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0,
pras_unitsize_source,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,r2x,
pras_vre_combine,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1,
pras_samples,,,,,,10,10,10,,,,,,,,,,,,,,,,10,10,,,,,,,,
FINITO,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1
FINITO_case,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,BAUfast_reg
GSw_H2_Demand_Case,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,BAU
GSw_H2_SMR,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,1
GSw_GasPriceAdjMethod,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,,0
58 changes: 58 additions & 0 deletions docs/source/user_guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -734,6 +734,64 @@ MCS Example: Total transmission capacity by interface.

For additional information on using Hourlize, you can watch the training video: [Hourlize wind/solar resource preprocessing tutorial](https://nrel-my.sharepoint.com/:v:/r/personal/bsergi_nrel_gov/Documents/Misc/Recordings/Hourlize%20wind_solar%20resource%20preprocessing%20tutorial-20240212_150245-Meeting%20Recording.mp4?csf=1&web=1&e=vIds6r&nav=eyJyZWZlcnJhbEluZm8iOnsicmVmZXJyYWxBcHAiOiJTdHJlYW1XZWJBcHAiLCJyZWZlcnJhbFZpZXciOiJTaGFyZURpYWxvZy1MaW5rIiwicmVmZXJyYWxBcHBQbGF0Zm9ybSI6IldlYiIsInJlZmVycmFsTW9kZSI6InZpZXcifX0%3D)

## ReEDS-FINITO

The Fuels and Industry Integrated Optimization Model (FINITO) provides a representation of the U.S. energy system with a bottom-up, technology-rich representation of the industrial sector.
ReEDS and FINITO can be linked to provide integrated modeling of the power sector with economy-wide energy supply and demand dynamics.
When linked, ReEDS and FINITO are formulated as a single optimization problem.

### Setup

FINITO can be cloned from https://github.com/NatLabRockies/FINITO (Note: this repository is currently private and only available within NLR).
By default ReEDS will look for a copy of the FINITO in the parent directory, but this can be configured by setting a value for `FINITO_dir` in your cases file.

ReEdS switches controlling ReEDS-FINITO linkage:
- `FINITO` (default 0): Turn off/on the linked model.
Passes its value to `GSw_FINITO_Link` which is used to activate the linkage in the model.
- `FINITO_cases_file` (default 'linked'): Filename suffix of the FINITO cases file to use.
- `FINITO_case` (default 'same'): Name of the case in `FINITO_cases_file` to use for the ReEDS run; used to determine FINITO switch settings.
When set to 'same' it will assume the same case name as used in ReEDS.

A linked model run is launched using the same call to `runreeds.py` as a normal ReEDS run.

All ReEDS and FINITO switches are combined into a single group of switches.
As FINITO can also be run as a standalone model, some switches in the FINITO cases files have the same name as switches in ReEDS.
For any switches with conflicting values, a linked run will always use the value specified from ReEDS, using the default in the ReEDS `cases.csv` file as a fallback for any unspecfied switches.

### Linkage points

**Load balance**
- Electricity demand from FINITO's industrial focus sectors (set by the FINITO `focus_sectors` switch) and from converted fuel processing is added to the ReEDS load balancing equation via `USE_ELE_FINITO`.
- The load projection input data in ReEDS accounts for demand from sectors represented endogenously in FINITO.
To avoid double-counting, in a linked run the estimated 'reference' electricity demand for covered sectors is substracted from the load data processed for ReEDS in `hourly_load.py` (see the `finito.remove_finito_load` function)
- Due to lack of granular sector electricity demand data, the current approach takes annual demand estimates and allocates to hourly profiles assuming constant demand, and the broadcasts those across all weather years. This approach is a coarse assumption that enables running the linked model with detailed hourly sectoral, and future work aims to improve the temporal and interannual characterization of industrial loads.
- When itereating with PRAS, the demand represented by `USE_ELE_FINITO` is added back to the original load file. Values from each representative timeslice are mapped back to their corresponding 'actual' hour for the modeled year, with the data being repeated for other weather years. Currently all load is assumed to be inflexible; future work aims to explore characterizing the flexibility of this load in PRAS.
- The FINITO switch `GSw_ConstantProduction` can be used to enforce flat hourly production (and therefore electricity demand) across all hours represented by the model.

**Fuel supply curves**
- When linked, ReEDS defers to FINITO for representation of hydrocarbon and biomass supply curves for solve years with FINITO activated. This representation supersedes any settings specified by fuel price switches in ReEDS (e.g., `ngscen`, `GSw_GasCurve`).
- Consumption of fuel equivalents in ReEDS is accounted for in FINITO by the `USE_FE_REEDS` variable.
- The activation of the ReEDS supply curves is controlled by the `tfuel` set, which is populated for any years using the ReEDS version. In a standalone run `tfuel` will include all solve years; in a linked run it will only includes t < `FINITO_first_year`.
- When linked, the output reporting in `report.gms` utilizes the FINITO marginals for calculating prices on the relevant quantities.
- The fuel supply curves can be adjusted by scenario by the `GSw_supply_scen` in FINITO, which includes scenarios from the AEO (e.g., Reference, HOG, LOG).
- Setting `GSw_DetailedNG=1` in FINITO enables explicit representation of natural gas production and interstate pipeline transport.
- Projections for non-power sector demand are scenario based and can be toggled using `GSw_demand_scen`.

**Hydrogen**
- WHen linked FINITO defers to ReEDS for the representation of the production and transport of hydrogen.
- FINITO focus sector hydrogen demand from future conversion to hydrogen processes is tracked in ReEDS by `USE_H2_FINITO`.
- Note that when linked, FINITO does not represent existing industrial hydrogen demand; to account for this demand, when linked `GSw_H2_Demand_Case` should be set to `FINITO`.

**CO2 representation**
- The link model relies on ReEDS for the representation of CO2 transport and storage.
- Total CO2 captured from FINITO is represented by `CAPTURE_CO2EM`.
- In the absence of explicit CO2 transport and storage modeling (i.e., `GSw_CO2_Detail=0`), the FINITO switches `GSw_CO2Cost_opt` and `GSw_CO2Cost_value` should be used to provide a cost for transport and sequestration.

**Other linkages**
- Functions for processing related the linked model are located in the `reeds/finito.py` module.
- Costs represented by FINITO are captured by `Z_finito`, which is rescaled and converted from `FINITO_dollaryear` before being added to costs from ReEDS in `eq_ObjFn`.
- Select outputs are saved by FINITO to a `finito_reeds_outputs_%case%.gdx` file, which is processed by `report_dump.py` to save csv/h5 outputs alongside other ReEDS results.


## Troubleshooting

Expand Down
Loading
Loading