Edition 2.0

Model documentation

Theoretical framework and architecture. The document is the source of truth for mechanisms, equations and code names. This page tells you how to read it, what each chapter covers, and where to get it.

How to read it

The document follows the agents of the model and closes with the markets that connect them. Chapter 1 sets out the architecture. Chapters 2 to 5 take the household, the firm, the government and the rest of the world in turn. Chapter 6 is where the pieces meet.

If you care about one part of the model, read Chapter 1, then that chapter, then the section of Chapter 6 that closes it. If you are going to work with the code, read Chapter 1 and the appendix first: between them they explain almost all of the notation.

Where the text claims something about the model, a note gives the equation, set or switch in the code that supports it.

At a glance

  • Six chapters and one appendix
  • Endnotes carry the code evidence
  • Revised as the model is revised
  • Free to download as a PDF

Contents

Open a chapter to see what it treats, what the model decides there, and what it takes as given. The chapter itself is in the PDF.

—ForewordWhat the model is, who it was built for, and the one feature that sets it apart

GreenREFORM-EU is a dynamic general equilibrium model for fiscal and environmental policy analysis. It was built for the finance ministries, planning bureaus and emissions agencies of EU Member States, and it descends from GreenREFORM, the model the Danish government uses for climate policy, and through it from MAKRO.

It integrates the economic national accounts with physical energy balances and greenhouse gas emissions. Capital is split into buildings, machines and transport, each paired with the energy it needs, so a change in an energy price acts on the capital stock that consumes that energy rather than on one undifferentiated aggregate.

The distinctive feature is how technology is treated. Switching fuel, electrifying a process or fitting carbon capture are discrete decisions, and the usual choices are to leave them out of the economic model or to solve a separate engineering model and pass results back and forth. This model represents them continuously instead, and solves the technology sub-model together with the macroeconomic core.

Foreword, and “How to read this document”.

1IntroductionWhy the model exists, the technical problem behind its architecture, code structure and modularity, the model economy, the chapter to code map

Read this first, whichever chapter you need. It sets out why the model exists, the technical problem that shapes its architecture, how the code is organised and named, the dimensions of the model economy in goods and in time, and the map from chapters to code files.

The case for the model is a legal one as much as an analytical one. The revised EU economic governance framework, through the amendments to the directive on national budgetary frameworks, requires Member States to assess the macro-fiscal implications of climate policy. Meeting that asks for tools that capture economy-wide feedback on output, employment, wages, trade and the public finances at once.

The technical problem is the gap between engineering and macroeconomics. Energy models know what the technologies cost; macroeconomic models know what a policy does to the economy. The architecture of this model is the answer to joining them, and the rest of the document is the detail of that answer.

Chapter 1. Sections: Background, motivation and purpose; The core technical challenge; Code structure and modularity; The model economy; Structure of the documentation and code files.

2HouseholdsSavings, the Ramsey problem, the consumption tree, energy consumption, housing services

Households optimise over two margins and no more: how much to consume rather than save, and what to buy with the consumption budget.

Decided here: disposable income, aggregate consumption and saving, demand for the twelve consumption purposes, and demand for individual energy goods within them.

Taken as given: labour supply, because employment comes from a Phillips curve around an exogenous path for structural employment, so there is no trade-off between work and leisure; and the composition of wealth, which is fixed outside the model and enters as a single average return on net financial assets.

There is no household housing stock and no life-cycle structure. Households buy housing services. The dwelling stock is the building capital of the industry that supplies them.

Chapter 2. Sections: Exogenous savings and income; Endogenous savings (Ramsey); The consumption tree; Energy consumption; Housing.

3FirmsOutput and price, the production function, factor demand, capital goods, energy end purposes, the energy technology model, the multi-output firm, corporate finance

The longest chapter, and the most detailed part of the model. Most of that detail comes from the data rather than from the code: the industry list has 57 entries in the Danish benchmark data set, and a different data set gives a different list.

Decided here: output and the price the firm sets, including industry markups; demand for labour, machinery, structures, vehicles and materials, with the investment that builds the capital stocks; the mix of energy goods, chosen on levelised cost; and corporate earnings, borrowing and dividends.

Taken as given: the size of the market, the base wage, the return investors require, and every tax, subsidy and allowance price.

The energy technology model sits in this chapter. It is long, and its length is out of proportion to its reach: it changes what happens where an energy end purpose is resolved into energy goods, and nothing else. What it buys is the ability to bring engineering evidence into the model and analyse energy policy with it.

Chapter 3. Sections: Output, cost and price; The production function; Factor demand; Capital goods and intermediate inputs; Energy end purposes; The energy technology model; The multi-output firm; Corporate finance.

4Government and public financesPublic revenue, expenditure and transfers, public production, net flows to the other sectors, fiscal closure and sustainability

The government is an accounting framework, not an optimising agent. There is no public objective function and no reaction function. Every revenue item is a rate or a share applied to a base decided elsewhere, and every expenditure item is either such a rate or an exogenous path. The modeller decides fiscal policy, not the model.

Decided here: the whole of public revenue and expenditure, the primary balance and the path of government net financial assets, the fiscal closure that keeps that path from drifting, and the consolidated net flows to firms, households and abroad.

Taken as given: the tax bases, which come from the labour market, firm, household and energy chapters; and the policy rates themselves, which are inputs.

The rules are mechanical, which is not the same as neutral. Public consumption is a constant share of GDP, which is what a government holding the service level steady would do. Transfers follow wages with a lag, which is what statutory indexation does. These are conventions rather than estimated behaviour, so they would not hold through a change of policy regime. They also decide who ends up paying for a shock, which is why it is worth knowing which rules are in force before reading a result off the model.

Chapter 4. Sections: Public revenue; Public expenditure and transfers; Public production; Net flows to the other sectors; Fiscal closure and sustainability.

5Rest of the worldExport demand, energy exports, import demand, the external balance and the trade elasticities

The shortest chapter, and the one that disciplines the model's prices.

The economy is a price taker on imports: world prices are exogenous, so a domestic cost increase cannot be passed to foreign suppliers. It is not a price taker on exports, where it faces a demand curve that slopes down, so a cost increase is passed to foreign buyers and they buy less. The elasticity of that response is what turns a cost shock into a quantity shock, which makes it the parameter that sets the size of the real effects in any policy experiment.

Decided here: export volumes, energy exports, and how much of domestic demand is met from abroad, cell by cell in the input-output table.

Taken as given: domestic prices, world prices, the size of the export markets, and the level of domestic demand. The chapter decides only how much of that demand is imported.

Chapter 5. Sections: Export demand; Energy exports; Import demand; The external balance and the trade elasticities.

6Markets and equilibriumThe input-output system, price setting and inflation, the labour market, energy markets and distributors, emissions and environmental accounts

Where the pieces meet. The chapter takes the decisions of households, firms, government and the rest of the world, and imposes the conditions that make them consistent.

One correction at the outset, because much of the chapter follows from it. This is not a model where excess demand pushes prices up until the market balances. Exactly one price is attached to a market clearing condition, and it is the wage. Goods prices are markups over unit cost, import prices are world prices, and energy supply prices are exogenous by default. So when demand for an industry's output rises, the first response is a quantity response. Prices do move, but because costs move, not because anything is short. The loop is a cost loop, not a scarcity loop.

Decided here: the clearing quantities, the wage and employment, the domestic price vector as one simultaneous system rather than a chain of markups, the national accounts aggregates, and total greenhouse gases, reported on both the national accounts and the UNFCCC conventions.

There is no unemployment rate. The employment gap measures employment against a structural benchmark. It is not the share of the labour force without work, and job search and participation are not modelled.

Chapter 6. Sections: The input-output system; Price setting and inflation; The labour market; Energy markets and distributors; Emissions and environmental accounts.

ACES trees and smart indexingThe algebra the chapters use without deriving, and how a nesting tree becomes one group of equations

Two halves. The first collects the algebra that Chapters 2 and 3 use without deriving it: the cost minimisation at one level of a nest, and what happens when levels are stacked.

The second is the more useful half for anyone working with the code. It explains how an entire nesting tree is written as a single group of equations, rather than one group per level. The device is not obvious on a first reading, and it is used in every module that contains a nest.

Read this with Chapter 1 if you are going to open the code. Between them they explain almost all of the notation.

Appendix A. Sections: CES algebra within a level; Multiple levels; Smart indexing in the code; The same algebra elsewhere in the model; Calibration and numerical notes.

Previous editions. Version 1.0 material from the Commission's TSI project stays available. When a later version is published, 2.0 will move here rather than disappear.

Tell me when the documentation changes

One short email when a new edition, correction or user guide is published.