Document how to configure pre-specified planning

[tomalrussell]

Question: How do I specify in the model run which interventions should be chosen? Does it just scan through all possible interventions and pick what is specified in the pre-specified pipeline?

Two-part answer - there's a config bit and a data bit (examples from the smif sample project):

1. config: add a pre-specified planning strategy to the model run, e.g. config/model_runs/energy_central.yml#L14-L17

- type: pre-specified-planning
  description: build_nuclear
  filename: build_nuke.csv
  model_name: energy_supply

2. data: specify the interventions to build in that strategy in a CSV with name and build_year columns, e.g. planning/energy_supply.csv

name,build_year
ac_line1,1995
ac_line2,1995
ac_line3,1995
ac_line4,1995

The name is used as a unique identifier and matched against the name in the intervention definition files, e.g. data/interventions/energy_supply.csv

name,capital_cost_value,capital_cost_unit,technical_lifetime_value,operational_lifetime_value,line_num,from_location,to_location,capacity_value,capacity_unit,length_value,length_unit
ac_line1,5,£/km,5,80,1,1,2,525,MW,50,km
ac_line2,4,£/km,5,80,2,1,3,132,MW,40,km
ac_line3,4.2,£/km,5,80,3,2,4,760,MW,42,km
ac_line4,6,£/km,5,80,4,4,7,1090,MW,60,km

The idea, loosely, is that the lists of interventions define the possible decisions, then the pre-specified plans and/or decision modules choose from those options.

[willu47]

Note that this was started added in 1f0d0f2 - see https://smif.readthedocs.io/en/latest/decisions.html#pre-specified-planning for rendered version

[tomalrussell]

👍 linked from contents (sidebar/homepage) as of 742df72