message_ix_models.project.ssp.script.util.shares.main

message_ix_models.project.ssp.script.util.shares.main(scen, path_UE_share_input, ssp='SSP2', start_year=None, calibration_year=None, period_interpol=4, clean_relations=False, verbose=False)[source]

Add share constraints for end-use technologies.

The purpose of this script is to add share constraints for the end-use sectors, thereby replacing any exisiting relation based share constraints in the process. The share constraint parametrization is read from an Excel-file and has been setup so that it can be applied to all five SSPs. Some constraints are applicable for multiple SSPs and nodes. The share constraints are parameterized so that the total to which the share is applied is derived based on a level/commodity and the technologies contributing to a share are specified individually. Shares with a value of 1. are not added to the model. In the process of adding the share constraints, a check is undertaken to ensure that the share constraint values do do not violate the calibrated baseyear shares. If they do, then the baseyear share value is interpolated, so that the target-share value as specied in the Excel-file are gradually achieved over time.

Parameters:

  • scen (message_ix.Scenario) – scenario to which changes should be applies

  • ssp (string) – specify for which SSP the parameters should be added

  • start_year (int) – specify the year as of which constraints should be added; If None, then firstmodelyear

  • calibration_year (int) – specify the last year for data has been calibrated If None, the firstmodelyear -1

  • period_intpol (int (default=4)) – the number of time periods (not years) over which deviations converge

  • clean_relations (boolean) – option whether to entirely remove all relation based UE share constraints.

  • verbose (boolean (default=False)) – option whether to primnt onscreen messages.