A common list of countries

Having an agreed list of country names including a mapping to alpha-3 and alpha-2 codes (also know as ISO3 and ISO2 codes) is an important prerequisite for scenario analysis and model comparison.

The nomenclature package builds on the pycountry package (link) to provide a utility for country names based on the ISO 3166-1 standard.

For consistency with established conventions in the modelling community, several country names are shortened compared to ISO 3166-1, e.g. from “Bolivia, Plurinational State of” to “Bolivia”. Also, “Kosovo” is added even though it is not a universally recognized state. See the full list of changes on GitHub.

You can access the list of countries via the model registration Excel template.

You can also use this utility for mapping between country names as used in the community and alpha-3 or alpha-2 codes, as shown in this example.

from nomenclature import countries

name = countries.get(alpha_3="...").name
alpha_3 = countries.get(name="...").alpha_3
alpha_2 = countries.get(name="...").alpha_2
class nomenclature.countries.Countries[source]

List of countries based on simplified ISO 3166 database

This list follows the nomenclature.countries module based on country names using ISO 3166-1, but it simplifies several country names for readability and in line with conventions of the IAMC community.

Methods

get(**kwargs)

Get a specific country by attribute
get(**kwargs)[source]

Get a specific country by attribute

Parameters:
namestr

Country name

alpha_3str

Alpha-3 code (ISO3)

alpha_2str

Alpha-2 code (ISO2)

Returns:
pycountry.Country