This tutorial is part of the guide for the Kigali Sim.

Tutorial 2: Single Application and Substance

We start with the basic building blocks of a simulation: applications and substances.
Contents

Motivation

In this tutorial, we examine ABC Country, a hypothetical country that we can use to explore Kigali Sim's functionality. Specifically, we will make a first HFC consumption model by using volume-based inputs. This approach helps us understand the relationship between populations and refrigerant consumption while working with initial charges, retirement rates, and servicing patterns. All of these parameters will work together to project consumption trends over time.

Let's start this analysis with domestic refrigeration using HFC-134a. We will use this to demonstrate how to model a single application with basic equipment data. This is the simplest simulation possible within the tool.

Setting Up Your First Application

Let's start by creating a new simulation for ABC:

You won't see results yet because we haven't added any substances or equipment data.

Adding HFC-134a Substance

Next, let's add our refrigerant substance:

Don't click save yet! We need to configure equipment properties first.

Equipment Properties

Now let's define the equipment characteristics that drive HFC consumption:

The retirement rate is sometimes called the hazard rate or scrap rate in equipment lifecycle analysis. Kigali Sim, by default, assumes a constant hazard rate when you specify a percentage. However, this can be modified by using a non-percentage retirement amount if you need more complex retirement patterns.

These basic parameters are enough to start modeling, but we also will want to account for servicing existing equipment.

Servicing Configuration

Refrigerants are needed both for new equipment (initial charge) and maintenance of existing equipment:

We're almost ready to run our first simulation! We just need initial conditions.

Initial Conditions

Head to the Set tab to specify ABC Country's starting conditions:

This 25 mt/year gives us a good demonstrative curve showing how consumption patterns evolve. However, until we specify changes in later tutorials, this production rate will remain steady based on tonnage. It will be used both for initial charge and recharge.

Note that, below the setpoints, you'll see a "Default sales assumption in a new year" dropdown. For this tutorial (and most simulations), leave this set to "Continue from last year (recommended)", which is the default. This setting controls how sales carry over from one year to the next. The default option maintains existing sales patterns, allowing the model to automatically balance substance allocation between initial charge and recharge based on equipment population dynamics.

Running Your First Simulation

Now let's see our model in action. After clicking save for our consumption record, do the following:

Interpreting Results

Let's examine what our model shows us.

We will add additional dynamics but this starts building an intuition for how Kigali Sim interpreted our very simple model.

Conclusion

You've successfully created ABC Country's first HFC consumption model! This basic simulation shows how 1 million existing refrigerators that, when combined with steady domestic production, create predictable consumption patterns. While we used simplified assumptions (uniform equipment characteristics, steady production), this foundation will flourish into much more sophisticated analysis as we add more information in. Specifically, we explored:

For some readers, this may seem like a lot of data to specify. Still, don't forget that we can use some basic assumptions to begin our analysis and get a rough idea of a system. These rough estimates can give way to more detailed information as we gather it. This includes adding actual historical values. For other readers, this may seem too simplistic. However, we will grow sophistication in this case study over time as we add in new dynamics.

Note that we specified HFC-134a to be both domestically produced and consumed during this first tutorial. This simplifies our ability to reason about the results: we don't have to consider trade attribution rules yet. However, a later tutorial will consider trade and how to analyze results under treaty conventions.

Download the completed tutorial: tutorial_02.qta - this contains the complete single application and substance model

Next Steps

Tutorial 3 will expand our model to include multiple equipment applications and refrigerant substances across ABC Country's complete national inventory. You'll learn to model commercial refrigeration, air conditioning, and other sectors while comparing different refrigerants and their climate impacts - building toward a comprehensive national HFC profile.

Previous: Tutorial 1 | Return to Guide Index | Next: Tutorial 3


This tutorial is part of the ABC Country case study series demonstrating progressive HFC policy analysis using Kigali Sim.