Skip to content

aeromaps.models.impacts.emissions.carbon_offset

carbon_offset

=============================== Module to compute effects of carbon offsets.

LevelCarbonOffset 

LevelCarbonOffset(name='level_carbon_offset', *args, **kwargs)

Bases: AeroMAPSModel

Class to compute carbon offset required to level emissions to offsetting targets compared to 2019 emissions.

Parameters:

Name Type Description Default
name str

Name of the model instance ('level_carbon_offset' by default).

 'level_carbon_offset'
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
29
30
def __init__(self, name="level_carbon_offset", *args, **kwargs):
    super().__init__(name=name, *args, **kwargs)

compute 

compute(co2_emissions, carbon_offset_baseline_level_vs_2019_reference_periods, carbon_offset_baseline_level_vs_2019_reference_periods_values)

Execute the computation of carbon offset required to level emissions.

Parameters:

Name Type Description Default
co2_emissions Series

CO2 emissions trajectory [MtCO2].

 required
carbon_offset_baseline_level_vs_2019_reference_periods list

Reference periods for the level of CO2 emissions relative to 2019 from which higher emissions are offset [years].

 required
carbon_offset_baseline_level_vs_2019_reference_periods_values list

Level of CO2 emissions relative to 2019 from which higher emissions are offset for the reference periods [%].

 required

Returns:

Type Description
carbon_offset_baseline_level_vs_2019

Level of CO2 emissions relative to 2019 from which higher emissions are offset [%].
level_carbon_offset

Annual carbon offset due to offsetting for a given level of emissions [MtCO2].
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
def compute(
    self,
    co2_emissions: pd.Series,
    carbon_offset_baseline_level_vs_2019_reference_periods: list,
    carbon_offset_baseline_level_vs_2019_reference_periods_values: list,
) -> Tuple[pd.Series, pd.Series]:
    """
    Execute the computation of carbon offset required to level emissions.

    Parameters
    ----------
    co2_emissions
        CO2 emissions trajectory [MtCO2].
    carbon_offset_baseline_level_vs_2019_reference_periods
        Reference periods for the level of CO2 emissions relative to 2019 from which higher emissions are offset [years].
    carbon_offset_baseline_level_vs_2019_reference_periods_values
        Level of CO2 emissions relative to 2019 from which higher emissions are offset for the reference periods [%].

    Returns
    -------
    carbon_offset_baseline_level_vs_2019
        Level of CO2 emissions relative to 2019 from which higher emissions are offset [%].
    level_carbon_offset
        Annual carbon offset due to offsetting for a given level of emissions [MtCO2].

    """
    carbon_offset_baseline_level_vs_2019 = aeromaps_leveling_function(
        self,
        carbon_offset_baseline_level_vs_2019_reference_periods,
        carbon_offset_baseline_level_vs_2019_reference_periods_values,
        model_name=self.name,
    )
    self.df.loc[:, "carbon_offset_baseline_level_vs_2019"] = (
        carbon_offset_baseline_level_vs_2019
    )

    for k in range(self.historic_start_year, self.prospection_start_year):
        self.df.loc[k, "level_carbon_offset"] = 0.0

    for k in range(self.prospection_start_year, self.end_year + 1):
        if (
            co2_emissions.loc[k]
            > co2_emissions.loc[2019]
            * self.df.loc[k, "carbon_offset_baseline_level_vs_2019"]
            / 100
        ):
            self.df.loc[k, "level_carbon_offset"] = (
                co2_emissions.loc[k]
                - co2_emissions.loc[2019]
                * self.df.loc[k, "carbon_offset_baseline_level_vs_2019"]
                / 100
            )
        else:
            self.df.loc[k, "level_carbon_offset"] = 0.0

    level_carbon_offset = self.df["level_carbon_offset"]

    return (carbon_offset_baseline_level_vs_2019, level_carbon_offset)

ResidualCarbonOffset 

ResidualCarbonOffset(name='residual_carbon_offset', *args, **kwargs)

Bases: AeroMAPSModel

Class to compute carbon offset to match a share of residual emissions.

Parameters:

Name Type Description Default
name str

Name of the model instance ('residual_carbon_offset' by default).

 'residual_carbon_offset'
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
102
103
def __init__(self, name="residual_carbon_offset", *args, **kwargs):
    super().__init__(name=name, *args, **kwargs)

compute 

compute(co2_emissions, level_carbon_offset, residual_carbon_offset_share_reference_years, residual_carbon_offset_share_reference_years_values)

Execute the computation of carbon offset to match a share of residual emissions.

Parameters:

Name Type Description Default
co2_emissions Series

CO2 emissions trajectory [MtCO2].

 required
level_carbon_offset Series

Annual carbon offset due to offsetting for a given level of emissions [MtCO2].

 required
residual_carbon_offset_share_reference_years list

Reference years for the share of remaining CO2 emissions offset [years].

 required
residual_carbon_offset_share_reference_years_values list

Share of residual emissions to be offset for the reference years [%].

 required

Returns:

Type Description
residual_carbon_offset_share

Share of residual emissions to be offset [%].
residual_carbon_offset

Annual carbon offset due to offsetting of a given share of the remaining emissions [MtCO2].
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
def compute(
    self,
    co2_emissions: pd.Series,
    level_carbon_offset: pd.Series,
    residual_carbon_offset_share_reference_years: list,
    residual_carbon_offset_share_reference_years_values: list,
) -> Tuple[pd.Series, pd.Series]:
    """
    Execute the computation of carbon offset to match a share of residual emissions.

    Parameters
    ----------
    co2_emissions
        CO2 emissions trajectory [MtCO2].
    level_carbon_offset
        Annual carbon offset due to offsetting for a given level of emissions [MtCO2].
    residual_carbon_offset_share_reference_years
        Reference years for the share of remaining CO2 emissions offset [years].
    residual_carbon_offset_share_reference_years_values
        Share of residual emissions to be offset for the reference years [%].

    Returns
    -------
    residual_carbon_offset_share
        Share of residual emissions to be offset [%].
    residual_carbon_offset
        Annual carbon offset due to offsetting of a given share of the remaining emissions [MtCO2].

    """
    residual_carbon_offset_share_prospective = aeromaps_interpolation_function(
        self,
        residual_carbon_offset_share_reference_years,
        residual_carbon_offset_share_reference_years_values,
        model_name=self.name,
    )
    self.df.loc[:, "residual_carbon_offset_share"] = residual_carbon_offset_share_prospective
    for k in range(self.historic_start_year, self.prospection_start_year):
        self.df.loc[k, "residual_carbon_offset_share"] = 0.0
    residual_carbon_offset_share = self.df["residual_carbon_offset_share"]

    for k in range(self.historic_start_year, self.end_year + 1):
        self.df.loc[k, "residual_carbon_offset"] = (
            self.df.loc[k, "residual_carbon_offset_share"]
            / 100
            * (co2_emissions.loc[k] - level_carbon_offset.loc[k])
        )

    residual_carbon_offset = self.df["residual_carbon_offset"]

    return (residual_carbon_offset_share, residual_carbon_offset)

CarbonOffset 

CarbonOffset(name='carbon_offset', *args, **kwargs)

Bases: AeroMAPSModel

Class to compute total carbon offset.

Parameters:

Name Type Description Default
name str

Name of the model instance ('carbon_offset' by default).

 'carbon_offset'
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
167
168
def __init__(self, name="carbon_offset", *args, **kwargs):
    super().__init__(name=name, *args, **kwargs)

compute 

compute(level_carbon_offset, residual_carbon_offset)

Execute the computation of total carbon offset.

Parameters:

Name Type Description Default
level_carbon_offset Series

Annual carbon offset due to offsetting for a given level of emissions [MtCO2].

 required
residual_carbon_offset Series

Annual carbon offset due to offsetting of a given share of the remaining emissions [MtCO2].

 required

Returns:

Type Description
carbon_offset

Total annual carbon offset [MtCO2].
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
def compute(
    self,
    level_carbon_offset: pd.Series,
    residual_carbon_offset: pd.Series,
) -> pd.Series:
    """
    Execute the computation of total carbon offset.

    Parameters
    ----------
    level_carbon_offset
        Annual carbon offset due to offsetting for a given level of emissions [MtCO2].
    residual_carbon_offset
        Annual carbon offset due to offsetting of a given share of the remaining emissions [MtCO2].

    Returns
    -------
    carbon_offset
        Total annual carbon offset [MtCO2].

    """
    carbon_offset = level_carbon_offset + residual_carbon_offset

    self.df.loc[:, "carbon_offset"] = carbon_offset

    return carbon_offset

CumulativeCarbonOffset 

CumulativeCarbonOffset(name='cumulative_carbon_offset', *args, **kwargs)

Bases: AeroMAPSModel

Class to compute cumulative carbon offset.

Parameters:

Name Type Description Default
name str

Name of the model instance ('cumulative_carbon_offset' by default).

 'cumulative_carbon_offset'
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
208
209
def __init__(self, name="cumulative_carbon_offset", *args, **kwargs):
    super().__init__(name=name, *args, **kwargs)

compute 

compute(carbon_offset)

Execute the computation of cumulative carbon offset.

Parameters:

Name Type Description Default
carbon_offset Series

Total annual carbon offset [MtCO2].

 required

Returns:

Type Description
cumulative_carbon_offset

Cumulative carbon offset from air transport [GtCO2].
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
def compute(
    self,
    carbon_offset: pd.Series,
) -> pd.Series:
    """
    Execute the computation of cumulative carbon offset.

    Parameters
    ----------
    carbon_offset
        Total annual carbon offset [MtCO2].

    Returns
    -------
    cumulative_carbon_offset
        Cumulative carbon offset from air transport [GtCO2].

    """
    self.df.loc[self.prospection_start_year - 1, "cumulative_carbon_offset"] = 0.0
    for k in range(self.prospection_start_year, self.end_year + 1):
        self.df.loc[k, "cumulative_carbon_offset"] = (
            self.df.loc[k - 1, "cumulative_carbon_offset"] + carbon_offset.loc[k] / 1000
        )

    cumulative_carbon_offset = self.df["cumulative_carbon_offset"]

    return cumulative_carbon_offset