Templates¶
templates/ holds the maintained reference configurations for TANGO. Each file describes one complete geothermal system, from reservoir to economics. Each one is a valid starting point for your own study. Every file is covered by the full-length regression suite (tests/regtest/test_templates.py), which fails if a file here has no golden-value check. These files are therefore the source of truth for what a valid configuration looks like. tango_core init ships them with the installed package.
Run one¶
uv run tango_core validate templates/hydro_sf_electric.yml # check the file, no simulation
uv run tango_core run templates/hydro_sf_electric.yml --save-dir results/
Configurations¶
| File | System type | Plant and product | Fluid | Injection mode | Used by |
|---|---|---|---|---|---|
hydro_sf_electric.yml |
Hydrothermal, doublet | Single-flash, electricity | H₂O | manual-fracking-check |
Flagship reference; demo_hydro_sf_electric, demo_well_mesh_convergence, opt_hydro_sf_electric, LCOE regression |
hydro_sf_electric_5spot.yml |
Hydrothermal, five-spot pattern | Single-flash, electricity | H₂O | manual |
opt_hydro_sf_electric_5spot |
hydro_df_electric.yml |
Hydrothermal, doublet | Double-flash, electricity | H₂O | manual-fracking-check |
opt_hydro_df_electric |
hydro_ORC_electric.yml |
Hydrothermal, doublet | Binary (ORC), electricity | H₂O | manual-fracking-check |
opt_hydro_ORC_electric |
hydro_direct_heat.yml |
Hydrothermal, doublet | Heat exchanger, heat | H₂O | manual-fracking-check |
opt_hydro_direct_heat |
EGS_electric.yml |
Enhanced (EGS), doublet, Triemli site | Single-flash, electricity | H₂O | manual-fracking-check |
opt_EGS_electric |
EGS_direct_heat.yml |
Enhanced (EGS), doublet, Triemli site | Heat exchanger, heat | H₂O | manual-fracking-check |
opt_EGS_direct_heat |
CO2_EGS_electric.yml |
Enhanced (EGS), doublet | Direct CO₂ turbine, electricity | CO₂ | manual-fracking-check |
opt_CO2_EGS_electric |
CO2_EGS_ORC_electric.yml |
Enhanced (EGS), doublet | Binary (ORC) with a pre-injection cooler, electricity | CO₂ | manual-fracking-check |
opt_CO2_EGS_ORC_electric |
CO2_EGS_direct_heat.yml |
Enhanced (EGS), doublet | Heat exchanger, heat | CO₂ | manual-fracking-check |
opt_CO2_EGS_direct_heat |
CPG_electric.yml |
CO₂ plume (CPG), doublet | Direct CO₂ turbine, electricity | CO₂ | manual-fracking-check |
opt_CPG_electric |
CPG_direct_heat.yml |
CO₂ plume (CPG), doublet | Heat exchanger, heat | CO₂ | manual-fracking-check |
opt_CPG_direct_heat |
AGS_direct_heat.yml |
Advanced closed loop (AGS), Triemli site | Heat exchanger, heat | H₂O | manual |
opt_AGS_direct_heat |
AGS_ORC_electric.yml |
Advanced closed loop (AGS) | Binary (ORC), electricity | H₂O | manual |
opt_AGS_ORC_electric |
CO2_AGS_electric.yml |
Advanced closed loop (AGS) | Direct CO₂ turbine, electricity | CO₂ | manual |
opt_CO2_AGS_electric |
CO2_AGS_ORC_electric.yml |
Advanced closed loop (AGS) | Binary (ORC), electricity | CO₂ | manual |
opt_CO2_AGS_ORC_electric |
CO2_AGS_direct_heat.yml |
Advanced closed loop (AGS) | Heat exchanger, heat | CO₂ | manual |
opt_CO2_AGS_direct_heat |
How a configuration maps onto the code is described in Config to objects. The meaning of each injection mode is described in Boundary-condition iteration.
A file name containing ORC means a binary plant: the geofluid heats a secondary working fluid (R245fa) that drives the turbine, and tango_core run --save-dir writes a phase diagram for each fluid.
Conventions¶
- One system per file. Each file has a
title, optionally adescriptionblock (summary,date,description), and inline comments on every physical parameter with its unit. - SI units throughout (Pa, K, kg/s, m), unless a comment states otherwise.
- The header comment draws the component circuit, in
component_idxorder. - Names follow
<system>_<plant>_<product>[_<variant>].yml, for examplehydro_sf_electric_5spot.yml.
Adding a configuration¶
- Copy the closest existing file and change only what differs.
- Run
uv run tango_core validateand thenuv run tango_core run --no-save(or--save-dir DIR) on it. - Add it to
_CONFIGSintests/regtest/test_templates.py, with its golden LCOE value. The suite fails until you do. - Add a row to the table above.