Skip to main content
In Scenario Builder, your work is organised into projects and scenarios:
  • A project is a container for related scenarios, for example all the scenarios exploring one research question or country
  • A scenario explores a single possible future for the electricity system, based on your assumptions about demand, technology, and policy

1. Create a project

From your workspace, click New Project, give it a name, and create it. You can rename or delete a project later from the project page.

2. Create a scenario

Open your project and click New Scenario. The form has a few core fields plus a Configuration section that sets the shape of your model.

Name and research question

  • Name: a unique name for the scenario (e.g. Growth economy)
  • Research question (optional): a short description of what the scenario explores (e.g. A high-growth economy with increased energy demand). This is also a useful starting point for AMP.

Geographies and spatial resolution

Choose the geographies your scenario covers, then a spatial resolution that controls how finely those geographies are divided into nodes:
ResolutionWhat it means
NationalThe whole country is modelled as a single node.
RegionalThe country is split into multiple interconnected nodes (e.g. states, islands, or grid zones), so the model can represent electricity flows between them.
Multi-nationalMultiple countries are modelled together, with cross-border interconnectors.
The available resolutions and node counts differ by country. See the Country models section for what each model offers. For more on how spatial detail affects results, see Model resolution.

Model type

Choose the framework that fits your question:
Model typeBest forFramework
Capacity ExpansionMulti-year, long-term investment planning at lower time resolutionTZ-OSeMOSYS
DispatchA single year of operation at high time resolutionPyPSA
See Model frameworks for a fuller comparison and guidance on choosing, and on soft-linking a capacity expansion plan into a dispatch model.

Timeline

Set the years your scenario covers:
  • Capacity Expansion runs over a range: pick a Start and End year
  • Dispatch models a single year only

Temporal resolution

Temporal resolution sets how many time slices the model uses to represent variation within a year. Each scenario’s time slices are the product of parts of a year × parts of a day:
ResolutionTime slicesDetail
Low1A single annual average.
Medium324 parts of a year × 8 parts of a day.
High8760Full hourly detail (used for Dispatch).
Higher resolution captures more demand and renewable variability but takes longer to solve. See Model resolution for the trade-offs.

3. What happens next

Every scenario starts from a calibrated base model with sensible default inputs, so you can run it immediately to get a least-cost baseline. From there you can:
1

Customise the inputs

Adjust any of the model’s input data types to reflect your assumptions. See Editing Scenarios for how.
2

Run the model

Click Run and follow the run statuses through building, solving, and results.
3

Explore and compare

View your results and compare scenarios side by side.
Only draft scenarios can be edited. To change a scenario that has already been run, duplicate it first.