Access GMD via Packages
You can access the Global Macro Database directly through our packages for Stata, Python, and R.
Access via Stata
Install Stata Package:
Our package is available on the Stata SSC Archive. You can install it using:
Install package:
ssc install gmd
The gmd command's syntax is straightforward:
Syntax:
gmd variable_abbreviation, option
To load the full dataset:
gmd
Downloading the raw data:
Pull the raw data from the underlying sources for real GDP
gmd rGDP, raw
Advanced filtering example:
Download real GDP for France
gmd rGDP, country(FRA)
Additional resources:
For detailed syntax, type help gmd in the Stata terminal.
Also see our dedicated article describing the gmd package.
Access via Python
Install via pip:
pip install global_macro_data
Example usage:
from global_macro_data import gmd
# Get preview data
df = gmd()
# Get latest version
df = gmd(show_preview=False)
# Specific version
df = gmd(version="2025_01")
# Specific country
df = gmd(country="USA")
# Multiple countries
df = gmd(country=["USA", "CHN", "DEU"])
# Specific variables
df = gmd(variables=["rGDP", "infl", "unemp"])
# Combine filters
df = gmd(version="2025_01", country=["USA", "CHN"], variables=["rGDP", "unemp", "CPI"])
Parameter guide:
- version (str): Dataset version in format
'YYYY_MM'. Defaults to latest. - country (str or list): ISO3 code(s), e.g.,
"SGP"or["SGP", "MRT"]. - variables (list): Variable codes like
["rGDP", "unemp"]. - show_preview (bool): If
Truewith no filters, shows sample data.
More info:
Please see package code on our GMD Python Package GitHub Page.
Access via R
Install via devtools:
# Install devtools if not already installed
install.packages("devtools")
# Install the package from GitHub
devtools::install_github("KMueller-Lab/Global-Macro-Database-R")
Example usage:
# Load the Package
library(globalmacrodata)
# Get preview data
df <- gmd()
# Get data from latest available version
df <- gmd(show_preview = FALSE)
# Get data from a specific version
df <- gmd(version = "2025_01")
# Get data for a specific country
df <- gmd(country = "USA")
# Get data for multiple countries
df <- gmd(country = c("USA", "CHN", "DEU"))
# Get specific variables
df <- gmd(variables = c("rGDP", "infl", "unemp"))
# Combine parameters
df <- gmd(version = "2025_01", country = c("USA", "CHN"), variables = c("rGDP", "unemp", "CPI"))
Parameter guide:
- version (character): Dataset version in format
"YYYY_MM". Defaults to latest. - country (character or vector): ISO3 code(s), e.g.,
"SGP"orc("MRT", "SGP"). - variables (character or vector): Variable codes like
c("rGDP", "unemp"). - show_preview (logical): If
TRUEwith no filters, shows preview data.
More info:
Please see package code on our GMD R Package GitHub Page.