Skip to content

Documentation of model components

The MIMOSA model consists of several sub-modules, called model components. Each component is made up of multiple variables (global or regional), parameters and equations (called constraints).

  • Economics

    Cobb-Douglas production function, investments, consumption and capital stock

    Read more

  • Welfare

    Welfare and the utility function

    Read more

  • Emissions and temperature

    • Baseline emissions, regional mitigated emissions and cumulative emissions
    • Temperature module
    • Constraints on emissions like inertia

    Read more

  • Mitigation

    Mitigation costs, Marginal Abatement Cost curve and technological learning

    Read more

  • Sea-level rise

    Determines the level of global sea-level rise

    Read more

  • Damages

    Temperature related damages and sea-level rise related damages

    Read more

  • Effort-sharing

    Optional Various effort-sharing regimes to distribute the mitigation (and sometimes damage) costs

    Read more

  • Emission trading

    Optional Allows for global trade of emission reductions

    Read more

  • Financial transfers

    Optional Financial transfer schemes like a global damage cost pool

    Read more

Building the abstract model

Builds the abstract model for MIMOSA by combining all components. Some components are optional. In the parameters, different variants of some components can be chosen. The components are:

Source code in mimosa/abstract_model.py 
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
def create_abstract_model(
    context: ModelContext,
) -> Tuple[AbstractModel, List[Equation]]:
    """
    ## Building the abstract model

    Builds the abstract model for MIMOSA by combining all components. Some components are optional. In the
    parameters, different variants of some components can be chosen. The components are:

    - [`damage module`](../parameters.md#model structure.damage module): The damage module to use
    - [`emissiontrade module`](../parameters.md#model structure.emissiontrade module): The emission trading module to use
    - [`financialtransfer module`](../parameters.md#model structure.financialtransfer module): The financial transfer module to use
    - [`welfare module`](../parameters.md#model structure.welfare module): The welfare module to use
    - [`objective module`](../parameters.md#model structure.objective module): The objective module to use
    - [`effortsharing module`](../parameters.md#model structure.effortsharing module): The effort-sharing module to use

    """
    m = create_base_model()

    # Each constraint will be put in this list,
    # then added to the model at the end of this file.
    constraints = []

    # Add all ordinary model components in catalogue order.
    for component in MODEL_COMPONENTS:
        constraints.extend(component.build(m, context))

    # Objective of optimisation
    model_objective, objective_constraints = OBJECTIVE_COMPONENT.build(m, context)
    constraints.extend(objective_constraints)

    ######################
    # Add constraints to abstract model
    ######################

    for constraint in constraints:
        add_constraint(m, constraint.to_pyomo_constraint(m), constraint.name)

    ######################
    # Get all equations (not constraints) for simulation mode
    ######################
    equations = [eq for eq in constraints if isinstance(eq, Equation)]

    m.objective = model_objective

    return m, equations