Skip to content

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