Building blocks

This section explains the building blocks that make up a Calliope model in detail: how to define a model, how to run and analyse it, and how to extend it with your own math.

If you are new to Calliope, work through the getting started and examples & tutorials sections first; the pages here go into the detail behind those introductions.

• Defining your model

  ---

  • Model configuration: the config section that controls how a model is built and solved.
  • Technologies: defining the techs that produce, consume, store, and convert energy.
  • Nodes: defining the nodes at which technologies are placed.
  • Loading tabular data: bringing in data from CSV files or dataframes via data_tables.
  • Data definitions: how parameters and indexed data are defined.

• Running & analysing

  ---

  • Modes: the available build and solve modes (plan, operate, spores).
  • Scenarios and overrides: managing variations of a model.
  • Running in the command line: building and solving from the CLI.
  • Running in Python: building and solving from a Python session.
  • Postprocessing: working with results after solving.

• User-defined math

  ---

  • Defining your own math: extending Calliope's base math.
  • Math components: variables, constraints, expressions, and objectives.
  • Math syntax: the syntax for writing math expressions.
  • Helper functions: functions available within math.
  • Adding your own math to a model: applying custom math to a model.