gcubed.constants

Defines a singleton class, Constants, that provides access to all constants.

class Constants:

Overview

This is a singleton class.

Most of the constants in GCUBED are variable names and prefixes.

VERSION: int

The version of the G-Cubed Python implementation.

BUILD: int

The build of the G-Cubed Python implementation.

LINEARISATION_DELTA: float

The delta used to compute numeric derivatives when linearising the model. This delta matches the value used in the Ox implementation of G-Cubed.

ITC_DELTA: float

The delta used to compute the Jacobian related to the intertemporal constants.

Note that a considerably larger value of DELTA is used when calculating the partial derivatives of the initial projection values of the variables whose values are adjusted by the intertemporal constants because those variable values are linear functions of the intertemporal constants. The size of the delta does not matter, theoretically, when calculating the partial derivatives of linear systems and a larger value of DELTA is used to eliminate precision issues. In the Ox implementation of G-Cubed, the DELTA used was 0.00001 but this can be made even larger to achieve better precision of the derivative estimates.

ROGY_PREFIX: str

The ROGY (potential output growth rate) variable prefix.

INFP_PREFIX: str

The INFP (inflation rate in PRID) variable prefix.

INFX_PREFIX: str

The INFX (inflation rate target) variable prefix.

PRID_PREFIX: str

The PRID (weighted price of domestic output) variable prefix.

REXC_PREFIX: str

The REXC variable prefix.

WAGE_PREFIX: str

The wage variable prefix.

NOMINAL_GDP_PREFIX: str

The nominal GDP variable prefix.

REAL_GDP_PREFIX: str

The real GDP variable prefix, LGDPR.

GDPR_PREFIX: str

The GDPR variable prefix.

GDPN_PREFIX: str

The GDPN variable prefix.

TRAN_PREFIX: str

The TRAN variable prefix (transfers to households).

GDP_RATIO_PREFIX: str

The ratio of nominal local GDP to nominal GDP of the reference country (typically the USA), both measured in the currency of the reference country. These variables are used to convert variables expressed as a percentage of local GDP to a percentage of reference country GDP. They are also used in the calibration of the ashr parameters describing international financial asset holdings by each region.

REAL_INTEREST_RATE_PREFIX: str

The real interest rate variable prefix.

NOMINAL_INTEREST_RATE_PREFIX: str

The nominal interest rate variable prefix.

ALL_REAL_INTEREST_RATE_PREFIXES: Tuple[str]

The real interest rate variable prefixes.

These are the prefixes of the variables that are set equal to the neutral real interest rate (set in the model configuration, ModelConfiguration.neutral_real_interest_rate) when doing linearisation of the model and when determining the adjustments to make to equate projections to observed data when doing the baseline projections.

  • INTF is the real short-run interest rate.
  • INTR is the 'risk-adjusted' real short-run interest rate, controlled by the central bank, equal to INTF plus RISR - an exogenous risk-premium in the yield curve. Note that RISR is typically zero in the databases and would be used to run simulation experiments.
ALL_NOMINAL_INTEREST_RATE_PREFIXES: Tuple[str]

The nominal interest rate variable prefixes.

These are the prefixes of the variables that are set equal to the neutral real interest rate plus the expected inflation rate when doing linearisation of the model and when determining the adjustments to make to equate projections to observed data when doing the baseline projections.

  • INTN is the nominal short-run interest rate, controlled by the central bank.
ALL_LAGGED_NOMINAL_INTEREST_RATE_PREFIXES: Tuple[str]

The lagged nominal interest rate variable prefixes.

These are the prefixes of the variables that are set equal to the neutral real interest rate plus the expected inflation rate when doing linearisation of the model and when determining the adjustments to make to equate projections to observed data when doing the baseline projections.

Note that with the removal of INTL, there are no longer any of these variables in G-Cubed models from build 181 onwards.

BOND_RATE_PREFIXES: Tuple[str]

The long bond rate (real and nominal) variable prefixes.

STATE_LEAD_VARIABLES: Tuple[str]

The state vector lead (stl variable types in SYM) variable prefixes.

UNITS_THAT_IMPLY_DIVISION_BY_REFERENCE_COUNTRY_GDP: Tuple[str]

The units of GDP that indicate that the variable values are divided by the nominal GDP of the reference country, expressed in local currency units for the reference country (USD if the USA is the reference country).

UNITS_THAT_IMPLY_DIVISION_BY_LOCAL_GDP: Tuple[str]

The units of GDP that indicate that the variable values are divided by local nominal GDP, expressed in the local currency of the reference country.

These units are of interest because we can multiply by ratio of local GDP to reference country GDP to convert the variable so that it is instead divided by reference country GDP.