Years or time periods (year/*.yaml)

• See also:

  • The discussion of Years, periods, and time slices in the message_ix documentation, which explains the standard sense of time periods used across the MESSAGEix framework and specific models based on it.

  • ScenarioInfo.year_from_codes()

• These are not the only possible meanings of these codes; others may be used in data from other sources.

  For instance, the ID 2020 could be used to represent the period from 2017-07-01 to 2022-06-30. These lists alone cannot resolve these differences; they exist only to provide clarity about the sense used in message_ix_models.

• When working with data from other sources, message_ix_models code must:

  • Explicitly note (e.g. in comments or docstrings) any differing time discretization used in the other data.

  • Perform appropriate conversion or record a decision to use the data directly, without conversion.

• It is optional for code to fill Scenario parameters for the full set of historical years.

  For instance, when working with list B, code for a model variant or project could only populate parameter values for the historical periods 2010 and 2015, but not 2005 and earlier. This should be described and documented on at the scope (function or module) where such subsets are selected from the full codelist.

List A

# Time periods used in CD-LINKS, inter alia

1960:
  description: Period from 1951-01-01 to 1960-12-31.
  # Durations of subsequent periods are implied by the prior period
  duration_period: 10

1970:
  description: Period from 1961-01-01 to 1970-12-31.
1980:
  description: Period from 1971-01-01 to 1980-12-31.
1990:
  description: Period from 1981-01-01 to 1990-12-31.
2000:
  description: Period from 1991-01-01 to 2000-12-31.
2010:
  description: Period from 2001-01-01 to 2010-12-31.

2020:
  description: Period from 2011-01-01 to 2020-12-31.
  # Periods before this are historical
  firstmodelyear: true

2030:
  description: Period from 2021-01-01 to 2030-12-31.
2040:
  description: Period from 2031-01-01 to 2040-12-31.
2050:
  description: Period from 2041-01-01 to 2050-12-31.
2060:
  description: Period from 2051-01-01 to 2060-12-31.
2070:
  description: Period from 2061-01-01 to 2070-12-31.
2080:
  description: Period from 2071-01-01 to 2080-12-31.
2090:
  description: Period from 2081-01-01 to 2090-12-31.
2100:
  description: Period from 2091-01-01 to 2100-12-31.
2110:
  description: Period from 2101-01-01 to 2110-12-31.

List B

# Time periods used in ENGAGE, inter alia

1950:
  description: Period from 1946-01-01 to 1950-12-31.
  # Durations of subsequent periods are implied by the prior period
  duration_period: 5
1955:
  description: Period from 1951-01-01 to 1955-12-31.
1960:
  description: Period from 1956-01-01 to 1960-12-31.
1965:
  description: Period from 1961-01-01 to 1965-12-31.
1970:
  description: Period from 1966-01-01 to 1970-12-31.
1975:
  description: Period from 1971-01-01 to 1975-12-31.
1980:
  description: Period from 1976-01-01 to 1980-12-31.
1985:
  description: Period from 1981-01-01 to 1985-12-31.
1990:
  description: Period from 1986-01-01 to 1990-12-31.
1995:
  description: Period from 1991-01-01 to 1995-12-31.
2000:
  description: Period from 1996-01-01 to 2000-12-31.
2005:
  description: Period from 2001-01-01 to 2005-12-31.
2010:
  description: Period from 2006-01-01 to 2010-12-31.
2015:
  description: Period from 2011-01-01 to 2015-12-31.

2020:
  description: Period from 2016-01-01 to 2020-12-31.
  # Periods before this are historical
  firstmodelyear: true

2025:
  description: Period from 2021-01-01 to 2025-12-31.
2030:
  description: Period from 2026-01-01 to 2030-12-31.
2035:
  description: Period from 2031-01-01 to 2035-12-31.
2040:
  description: Period from 2036-01-01 to 2040-12-31.
2045:
  description: Period from 2041-01-01 to 2045-12-31.
2050:
  description: Period from 2046-01-01 to 2050-12-31.
2055:
  description: Period from 2046-01-01 to 2055-12-31.
2060:
  description: Period from 2056-01-01 to 2060-12-31.
2070:
  description: Period from 2061-01-01 to 2070-12-31.
2080:
  description: Period from 2071-01-01 to 2080-12-31.
2090:
  description: Period from 2081-01-01 to 2090-12-31.
2100:
  description: Period from 2091-01-01 to 2100-12-31.
2110:
  description: Period from 2101-01-01 to 2110-12-31.