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

QubecTalk Reference: Commands

Commands are the executable statements within QubecTalk stanzas that define substance properties, set values, and configure policies.

Contents

Cap

Purpose: Limits consumption to specified levels, optionally with displacement to alternative substances.

Syntax: cap streamName to amount [displacing "substanceName"] during years startYear to endYear

Examples:

cap sales to 80% during years 2027 to 2030
cap domestic to 0 mt displacing "R-600a" during years 2031 to onwards
cap import to 50% during years 2028 to 2032

Change

Purpose: Applies growth or decline rates to consumption over time.

Syntax: change streamName by percentage % / year during years startYear to endYear

Examples:

change sales by 6% / year during years 2025 to 2030
change domestic by -3% / year during years 2031 to 2035
change import by 5% / year during years 2025 to onwards

Define

Purpose: Creates variables for use in calculations and conditional statements.

Syntax: define variableName as value

Examples:

define baseGrowthRate as 5
define phaseOutYear as 2030
define targetReduction as 80

Enable

Purpose: Activates specific supply streams for a substance.

Syntax: enable streamName

Available Streams: domestic, import, export

Examples:

enable domestic
enable import
enable export

Equals (GWP)

Purpose: Defines the Global Warming Potential and energy consumption for a substance.

Syntax: equals gwpValue tCO2e / unit [energyValue kwh / unit]

Examples:

equals 1430 tCO2e / mt
equals 675 tCO2e / mt 100 kwh / unit
equals 3 tCO2e / mt

Floor

Purpose: Sets minimum consumption levels to prevent unrealistic reductions.

Syntax: floor streamName to amount during years startYear to endYear

Examples:

floor sales to 10% during years 2030 to onwards
floor domestic to 5 mt during years 2025 to 2035

Initial Charge

Purpose: Specifies the amount of substance in new equipment per unit.

Syntax: initial charge with amount unit / unit for streamName

Examples:

initial charge with 0.15 kg / unit for domestic
initial charge with 0.20 kg / unit for import
initial charge with 1.5 kg / unit for domestic

Recharge

Purpose: Specifies servicing patterns for existing equipment including frequency and amount.

Syntax: recharge percentage % with amount unit / unit

Examples:

recharge 10% with 0.15 kg / unit
recharge 15% with 0.85 kg / unit during years 2025 to 2030
recharge 5% with 1.0 kg / unit in all years

Recover

Purpose: Implements recycling programs that recover and reuse substances from end-of-life equipment.

Syntax: recover percentage % with reuse_percentage % reuse during years startYear to endYear

Examples:

recover 30% with 90% reuse during years 2027 to onwards
recover 50% with 80% reuse during years 2030 to 2035
recover 25% with 100% reuse at eol during years 2028 to onwards

Replace

Purpose: Substitutes one substance with another in new equipment over specified time periods.

Syntax: replace with "newSubstanceName" during years startYear to endYear

Examples:

replace with "R-600a" during years 2027 to 2030
replace with "HFC-32" during years 2025 to onwards

Retire

Purpose: Sets equipment retirement rates determining equipment lifespan.

Syntax: retire percentage % each year

Examples:

retire 5% each year
retire 7% each year during years 2025 to 2030
retire 10% each year

Set

Purpose: Sets consumption volumes or equipment units for specific streams and time periods.

Syntax: set streamName to amount unit during year year

Examples:

set domestic to 25 mt during year 2025
set import to 15000 units during year 2025
set priorEquipment to 1000000 units during year 2025