Module investment 

Code for performing agent investment.

Modules

appraisal

Calculation for investment tools such as Levelised Cost of X (LCOX) and Net Present Value (NPV).

Functions

calculate_candidate_asset_capacity_scale

Calculates a characteristic capacity scale for a candidate asset.

flatten_preset_demands_for_year

Flatten the preset commodity demands for a given year into a map of commodity, region and time slice to demand.

get_demand_limiting_capacity

Returns the minimum installed capacity required for asset to satisfy the demand that it can potentially serve, accounting for its activity constraints.

is_any_remaining_demand 🔒

Check whether there is any remaining demand that is unmet in any time slice

log_on_equal_appraisal_outputs 🔒

Print debug message if there are multiple equally good outputs

perform_agent_investment

Perform agent investment to determine capacity investment of new assets for next milestone year.

prepare_commissioned_assets_for_retention 🔒

Prepare existing assets for reappraisal.

record_asset_selection 🔒

Record a selected asset. Candidate selections represent one tranche; repeated selections of the same candidate increase the resulting asset’s number of tranches while preserving its tranche size.

remove_assets_exceeding_agent_limits 🔒

Remove assets that exceed the provided process limits for one complete tranche.

select_best_assets

Get the best assets for meeting demand for the given commodity

subtract_capacity_from_remaining_limit 🔒

update_net_demand_map

Update net demand map with flows from a set of assets

update_selection_state 🔒

Update the remaining investment options and selection state.

Type Aliases

AllDemandMap

Demand for a given combination of commodity, region and time slice

DemandMap

A map of demand across time slices for a specific market