PIPELINE
Publication workflow
- Retrieve. The pipeline downloads observations and metadata from the World Bank and IMF.
- Preserve. Every provider response is retained as a dated, immutable snapshot.
- Standardize. Country codes, indicator names, units, and periods are normalized into a consistent data structure.
- Transform. Explicit configuration files determine source selection, scaling, row order, and display precision.
- Check and publish. Accounting checks run before a complete batch is published. A failed build cannot partially replace the current release.
COMPARATIVE GROUPS
World Bank aggregates
The Aggregates selector uses the World Bank’s official geography metadata. It includes income groups, regions, lending groups, demographic groups, small-state groupings, OECD members, and World when the World Development Indicators database returns at least one configured GUIDES observation.
Aggregate pages use the same GUIDES row order, units, rounding rules, and accounting checks as country pages. IMF-only fiscal rows remain visible and blank because World Bank group definitions are not IMF fiscal geographies. Detailed IMF balance-of-payments files are not shown for aggregates.
MAIN ECONOMIC INDICATORS
GUIDES
The GUIDES table brings together national accounts and other macroeconomic indicators commonly used in BGIE teaching. It follows the framework described in Matthew C. Weinzierl, Jonathan Schlefer, and Ann Cullen (2010), “GUIDES: Insight through Indicators,” HBS Background Note 710-044.
Sources and selection
- Most indicators come from the World Bank’s World Development Indicators.
- Overall fiscal balance, primary fiscal balance, and gross government debt come from the IMF Fiscal Monitor.
- When the same concept is available from both institutions, the pipeline selects the source with the more complete country history and uses the World Bank when coverage is tied.
- All standard indicator rows are shown even when no observation is available; the pipeline does not fill missing annual values.
Units and rounding
Units appear in each row label. Nominal GDP is shown in billions of U.S. dollars, population in millions, and reserves in millions of U.S. dollars. Presentation rounding follows an indicator-specific rule and does not alter the stored source observation.
For the five expenditure shares, controlled rounding makes the displayed values add to 100 when the unrounded difference can be explained by their combined rounding range. If the difference is too large, independently rounded values are retained and the affected year is identified on the country page. No statistical-discrepancy row is introduced.
EXTERNAL ACCOUNTS
Balance of payments
The balance-of-payments table uses IMF data in the repository’s BPM6 standard presentation. Values are expressed in either millions or billions of U.S. dollars according to the scale of the country data, with the unit identified in the downloadable exhibit. For an introduction to interpreting these accounts, see David A. Moss, “Reading a Balance of Payments”.
Current account
Goods, services, primary income such as investment income, and secondary income such as transfers.
Capital account
Capital transfers and transactions in non-produced, non-financial assets; usually small relative to the other accounts.
Financial account
Direct investment, portfolio investment, derivatives, other investment, and reserve assets. Change in reserves remains within this account in the standard presentation.
Errors and omissions
The balancing residual arising from timing, coverage, valuation, and other measurement differences across source records.
A positive entry denotes an increase in the activity or asset represented by that line. The table presents exports and assets positively and imports and liabilities as deductions when calculating net balances. Because the financial account is subtracted in the identity, a current-account surplus is ordinarily matched by a positive financial-account balance, apart from the capital account and errors and omissions.
TRANSPARENT CHECKS
Quality checks
Country pages show short notes only when a year needs attention:
- GUIDES identity: years where the expenditure shares differ from 100 by more than the combined rounding tolerance.
- BOP identity: years where the four headline accounts do not balance to zero within numerical precision.
- Missing components: years where an identity cannot be evaluated because at least one required series is unavailable.
Notes for the displayed ten-year period appear first. Earlier issues are identified separately because they affect the Excel history but not the Word exhibit.
DATA VINTAGES
Revisions and reproducibility
The World Bank and IMF revise historical series and add estimates or projections over time. BGIE releases therefore may differ from older files even when the transformation is unchanged. The pipeline records retrieval time, provider series, country, period, units, and the release that produced each published file. Raw observations are preserved separately from presentation scaling and rounding so differences can be traced to either a provider revision or a BGIE transformation.
Exchange-rate workbooks and U.S. BEA bilateral balance-of-payments files from the previous repository are not part of the present release and will be restored in a later phase.
SOURCES
References
- World Bank, World Development Indicators
- IMF, Fiscal Monitor database
- IMF, Balance of Payments and International Investment Position Manual, sixth edition
- Cavallo (2022), “BGIE Macro Data Repository,” HBS Technical Note 722-037
- Matthew C. Weinzierl, Jonathan Schlefer, and Ann Cullen (2010), “GUIDES: Insight through Indicators,” HBS Background Note 710-044
- David A. Moss, “Reading a Balance of Payments”