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, corsia_reference_year, carbon_offset_baseline_level_vs_corsia_reference_year_reference_periods, carbon_offset_baseline_level_vs_corsia_reference_year_reference_periods_values, carbon_offset_baseline_share_total_emissions_reference_periods, carbon_offset_baseline_share_total_emissions_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
corsia_reference_year int

Fixed regulatory baseline year for CORSIA offsetting (default 2019). The offsetting baseline is measured against this year's emissions, independent of prospection_start_year.

 required
carbon_offset_baseline_level_vs_corsia_reference_year_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_corsia_reference_year_reference_periods_values list

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

 required
carbon_offset_baseline_share_total_emissions_reference_periods list

Reference periods for the share of total CO2 emissions on which offset is applied [years].

 required
carbon_offset_baseline_share_total_emissions_reference_periods_values list

Share of total CO2 emissions on which offset is applied for the reference periods [%].

 required

Returns:

Type Description
carbon_offset_baseline_level_vs_corsia_reference_year

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
 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
116
117
118
119
120
121
122
123
def compute(
    self,
    co2_emissions: pd.Series,
    corsia_reference_year: int,
    carbon_offset_baseline_level_vs_corsia_reference_year_reference_periods: list,
    carbon_offset_baseline_level_vs_corsia_reference_year_reference_periods_values: list,
    carbon_offset_baseline_share_total_emissions_reference_periods: list,
    carbon_offset_baseline_share_total_emissions_reference_periods_values: list,
) -> Tuple[pd.Series, pd.Series, pd.Series]:
    """
    Execute the computation of carbon offset required to level emissions.

    Parameters
    ----------
    co2_emissions
        CO2 emissions trajectory [MtCO2].
    corsia_reference_year
        Fixed regulatory baseline year for CORSIA offsetting (default 2019).
        The offsetting baseline is measured against this year's emissions,
        independent of prospection_start_year.
    carbon_offset_baseline_level_vs_corsia_reference_year_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_corsia_reference_year_reference_periods_values
        Level of CO2 emissions relative to 2019 from which higher emissions are offset for the reference periods [%].
    carbon_offset_baseline_share_total_emissions_reference_periods
        Reference periods for the share of total CO2 emissions on which offset is applied [years].
    carbon_offset_baseline_share_total_emissions_reference_periods_values
        Share of total CO2 emissions on which offset is applied for the reference periods [%].

    Returns
    -------
    carbon_offset_baseline_level_vs_corsia_reference_year
        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_corsia_reference_year = aeromaps_leveling_function(
        self,
        carbon_offset_baseline_level_vs_corsia_reference_year_reference_periods,
        carbon_offset_baseline_level_vs_corsia_reference_year_reference_periods_values,
        model_name=self.name,
    )

    carbon_offset_baseline_share_total_emissions = aeromaps_leveling_function(
        self,
        carbon_offset_baseline_share_total_emissions_reference_periods,
        carbon_offset_baseline_share_total_emissions_reference_periods_values,
        model_name=self.name,
    )

    self.df.loc[:, "carbon_offset_baseline_level_vs_corsia_reference_year"] = (
        carbon_offset_baseline_level_vs_corsia_reference_year
    )
    self.df.loc[:, "carbon_offset_baseline_share_total_emissions"] = (
        carbon_offset_baseline_share_total_emissions
    )

    self.df.loc[
        self.historic_start_year : self.prospection_start_year - 1, "level_carbon_offset"
    ] = 0.0

    baseline_level = (
        co2_emissions.loc[corsia_reference_year]
        * self.df.loc[
            self.prospection_start_year : self.end_year,
            "carbon_offset_baseline_level_vs_corsia_reference_year",
        ]
        / 100
    )

    # compute the ammount offset. "clip" sets it to zero if emissions do not exceeds the baseline.
    self.df.loc[self.prospection_start_year : self.end_year, "level_carbon_offset"] = (
        (
            (
                co2_emissions.loc[self.prospection_start_year : self.end_year] - baseline_level
            ).clip(lower=0.0)
        )
        * self.df.loc[
            self.prospection_start_year : self.end_year,
            "carbon_offset_baseline_share_total_emissions",
        ]
        / 100
    )

    level_carbon_offset = self.df["level_carbon_offset"]

    return (
        carbon_offset_baseline_level_vs_corsia_reference_year,
        carbon_offset_baseline_share_total_emissions,
        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 
136
137
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 
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
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)

ManualCarbonOffset 

ManualCarbonOffset(name='manual_carbon_offset', *args, **kwargs)

Bases: AeroMAPSModel

Class to compute an manually specified annual carbon offset trajectory.

The output is linearly interpolated across the reference years and added to the level + residual offsets by :class:CarbonOffset.

Parameters:

Name Type Description Default
name str

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

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

compute 

compute(manual_carbon_offset_reference_years, manual_carbon_offset_reference_years_values)

Execute the computation of the manual carbon offset trajectory.

Parameters:

Name Type Description Default
manual_carbon_offset_reference_years list

Reference years for the manual annual offset trajectory [years].

 required
manual_carbon_offset_reference_years_values list

Manually specified annual offset values at the reference years [MtCO2].

 required

Returns:

Type Description
manual_carbon_offset

Annual manually specified carbon offset [MtCO2].
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
207
208
209
210
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
238
239
240
def compute(
    self,
    manual_carbon_offset_reference_years: list,
    manual_carbon_offset_reference_years_values: list,
) -> pd.Series:
    """
    Execute the computation of the manual carbon offset trajectory.

    Parameters
    ----------
    manual_carbon_offset_reference_years
        Reference years for the manual annual offset trajectory [years].
    manual_carbon_offset_reference_years_values
        Manually specified annual offset values at the reference years [MtCO2].

    Returns
    -------
    manual_carbon_offset
        Annual manually specified carbon offset [MtCO2].
    """
    manual = aeromaps_interpolation_function(
        self,
        manual_carbon_offset_reference_years,
        manual_carbon_offset_reference_years_values,
        model_name=self.name,
    )
    for k in range(self.historic_start_year, self.prospection_start_year):
        self.df.loc[k, "manual_carbon_offset"] = 0.0
    for k in range(self.prospection_start_year, self.end_year + 1):
        self.df.loc[k, "manual_carbon_offset"] = manual.loc[k]

    manual_carbon_offset = self.df["manual_carbon_offset"]

    return manual_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 
253
254
def __init__(self, name="carbon_offset", *args, **kwargs):
    super().__init__(name=name, *args, **kwargs)

compute 

compute(level_carbon_offset, residual_carbon_offset, manual_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
manual_carbon_offset Series

Annual carbon offset provided exogenously via reference years/values [MtCO2].

 required

Returns:

Type Description
carbon_offset

Total annual carbon offset [MtCO2].
Source code in aeromaps/models/impacts/emissions/carbon_offset.py 
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
def compute(
    self,
    level_carbon_offset: pd.Series,
    residual_carbon_offset: pd.Series,
    manual_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].
    manual_carbon_offset
        Annual carbon offset provided exogenously via reference years/values [MtCO2].

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

    """
    carbon_offset = (
        level_carbon_offset.fillna(0)
        + residual_carbon_offset.fillna(0)
        + manual_carbon_offset.fillna(0)
    )

    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 
301
302
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 
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
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