Economics¶
economic components/economic/ · config economic: type: doublet
Economics is one central component, configured in the top-level
economic: block. It is not part of the fluid loop: it runs once, after
the last timestep, reads the solved wells and surface plant, and computes
capital cost (CAPEX), operating cost (OPEX) and the levelized cost of
electricity or heat (LCOE/LCOH). It prices the wells (from their geometry
and pump power) and the surface plant (from its turbines, pumps and
condensers); it does not price the reservoir, and it never feeds back into
the physics. Its results are the objectives most optimizations minimize.
How the model works¶
Doublet CAPEX/LCOE economic component for tango.
Computes total CAPEX (wells, permitting, exploration, surface pipes,
surface plant) and levelized cost (LCOE or LCOH, via MainProduct) for
a hydrothermal DOUBLET topology — one injection well, one production well
(itself possibly split across several physics sub-components, or paired
with a separate horizontal loop segment — see _compute_well_capex),
and a TESPy-node-based surface plant. Well costs use a single fixed
formula (the gengeo model — see _well_section_cost); its three
coefficients are overridable Fields, but the formula's SHAPE is not
configurable, and no alternative well-cost model is supported. Only H2O
is supported (no CO2-specific cost terms). This is not a general-purpose
economic engine — it covers exactly the well/surface-plant shapes tango's
own templates use today, nothing broader.
Runs exactly once, after every physical timestep completes — see
EconomicComponent's (base.py) and SystemDirect.finalize()'s
docstrings for why. Surface-plant CAPEX sizing and the LCOE denominator use
the RUN-AVERAGED power/heat-duty of each turbine/pump/condenser node — the
time-weighted mean over every recorded timestep, each weighted by the length
of its step (time_weighted_mean), not any single timestep's
snapshot — since a single timestep's value isn't representative of the
plant's actual annual output/cost basis the way a full-run average is.
Sign convention: GraphSurface's own TESPy wiring gives pumps POSITIVE
node power (consumes energy) and turbines NEGATIVE (generates energy). Every
cost formula that takes a fractional-exponent power of a raw node value
(e.g. a pump/turbine equipment-cost curve) applies abs() to that value
first, so it stays correct regardless of a given plant topology's exact
port wiring — a bare negative number raised to a fractional power would
otherwise silently NaN.
Known scope limits (real gaps, not oversights — flagged so a caller can
tell a config is hitting one rather than assume a wrong-looking number is
a bug):
- Direct-heat district-heating exchanger equipment cost is not costed at
all. A plain district-heating SimpleHeatExchanger node isn't
recognized by any surface-plant cost formula here (those only recognize
cooler/condenser/turbine/pump-style equipment), so CAPEX_surface_plant
comes back exactly 0.0 for a pure direct-heat topology (e.g. AGS/EGS
direct-heat configs). CAPEX_total/LCOH for such a config is therefore
real but understates true cost until a district-heat-exchanger cost
formula is added.
- No production-well-pump "lineshaft" cost add-on. Would only ever
apply when a production pump's average power is negative;
LumpedProductionWellWithPump.pump_power_watts (well/lumped.py) is
non-negative by construction, so that condition can never arise here.
- No cost-year/PPI-table interpolation. Uses a single fixed-year
cost-index snapshot (core/economic_constants.py) rather than
interpolating by calendar year, since tango has no calendar concept
(no start_date) yet.
Config keys¶
economic · doublet → DoubletEconomicComponent¶
| Key | Type | Default | Meaning |
|---|---|---|---|
component_idx |
int |
required | undocumented |
save_interval |
int \| None |
1 |
undocumented |
project_maturity |
ProjectMaturity |
required | undocumented |
discount_rate |
float |
required | undocumented |
main_product |
MainProduct |
<MainProduct.ELECTRICITY: 'electricity'> |
undocumented |
capacity_factor |
float |
0.9 |
undocumented |
opex_cost_fraction |
float |
0.045 |
undocumented |
electricity_price |
float |
0.25 |
undocumented |
heat_price |
float |
0.05 |
undocumented |
gengeo_quadratic_length_coeff |
float |
0.105 |
undocumented |
gengeo_diameter_length_coeff |
float |
1776.0 |
undocumented |
gengeo_mobilization_cost_usd |
float |
275300.0 |
undocumented |
Results¶
One row in <name>.econ.csv, written when the config has an economic: block.
| Column | Meaning |
|---|---|
CAPEX_well |
undocumented |
CAPEX_permitting |
undocumented |
CAPEX_exploration |
undocumented |
CAPEX_surface_pipes |
undocumented |
CAPEX_surface_plant |
undocumented |
CAPEX_total |
undocumented |
net_power_W |
undocumented |
net_thermal_W |
undocumented |
LCOE |
undocumented |
specific_investment_cost |
undocumented |
OPEX |
undocumented |