Data

Tools

Indexes

Applications

Experiments

Open Source Science

Recent Releases of The country converter coco - a Python package for converting country names between different classification schemes

The country converter coco - a Python package for converting country names between different classification schemes - FIFA and switch to uv

Changelog

1.3.1

Classifications

  • added FIFA country codes

Development

  • switch to uv based development environment
  • switch to ruff for linting
  • update pyproject.toml with new dependencies

1.3 - 20241115

Classifications

  • added BACI - BACI: International Trade Database at the Product-Level (by @mabudz)
  • added UNIDO - UNIDO INDSTAT database (by @mabudz)
  • added EXIOBASE hybrid 3 classification (by @mabudz)
  • added EXIOBASE hybrid 3 consequential classification (by @mabudz)
  • added GEOnumeric GEO numerical codes (also used in Prodcom) (by @mabudz)
  • fixed some spellings

Development

  • set minimum python version to 3.9
  • added CI tests for up to 3.13

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler 6 months ago

The country converter coco - a Python package for converting country names between different classification schemes - Classification Extensions

1.3 - 20241115

Classifications

  • added BACI - BACI: International Trade Database at the Product-Level (by @mabudz)
  • added UNIDO - UNIDO INDSTAT database (by @mabudz)
  • added EXIOBASE hybrid 3 classification (by @mabudz)
  • added EXIOBASE hybrid 3 consequential classification (by @mabudz)
  • added GEOnumeric GEO numerical codes (also used in Prodcom) (by @mabudz)
  • fixed some spellings

Development

  • set minimum python version to 3.9
  • added CI tests for up to 3.13

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 1 year ago

The country converter coco - a Python package for converting country names between different classification schemes - ioc and continent classification

1.2 - 20231212

Classifications

  • added IOC classification (by @Azrael3000)
  • added 7 continents classification (by @marthhoi)
  • assigned Heard Island and McDonald Islands to Antarctica

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 2 years ago

The country converter coco - a Python package for converting country names between different classification schemes - version and classification fix

1.1.1 - 20231110

Development

  • fix pypi uploader
  • fix version numbering

1.1 - 20231110

Development

  • removed htmlcov
  • fixed numerical position warning

Classifications

  • Added CC41 common classification (by @hazimhussein)
  • Correct spelling "Faeroe Islands" to "Faroe Islands" #145 (by @jpatokal)
  • Added country code for Kosovo (by @jimmy927)
  • Added Carribian Netherlands/Bonaire (by @jimmy927)
  • Switched short name of Czech Republic to Czechia
  • Added EL to the ISO2 codes for Greece
  • Allow Guiana/Guiyana in most cases when given British/Dutch/French prefix
  • Allow Gabun/Gabon
  • Allow Botsuana/Botswana
  • Allow England for UK

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 2 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Classification improvments

1.1 - 20231110

Development

  • removed htmlcov
  • fixed numerical position warning

Classifications

  • Added CC41 common classification (by @hazimhussein)
  • Correct spelling "Faeroe Islands" to "Faroe Islands" #145 (by @jpatokal)
  • Added country code for Kosovo (by @jimmy927)
  • Added Carribian Netherlands/Bonaire (by @jimmy927)
  • Switched short name of Czech Republic to Czechia
  • Added EL to the ISO2 codes for Greece
  • Allow Guiana/Guiyana in most cases when given British/Dutch/French prefix
  • Allow Gabun/Gabon
  • Allow Botsuana/Botswana
  • Allow England for UK

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 2 years ago

The country converter coco - a Python package for converting country names between different classification schemes - The jump to version 1.0

Version 1.0.0

We finally jump to version 1.0! Overall, it is only a minor update, including the move to github.com/IndEcol. However, the functionality seems quite stable and the country converter is heavily used in production. So going forward we will be conservative in changing existing functionality, avoiding breaking changes as much as possible.

Changelog

Classifications

  • fix Myanmar UN region (#125) [by Alan Orth]
  • add missing MESSAGE R11 regions [by Advait]
  • added Croatia to the Euro list [by PeterMaxwell]

Development

  • droped 3.6 support, added tests for 3.10 and 3.11
  • fixed github workflow
  • change repository from github.com/konstantinstadler to github.com/IndEcol
  • Add build-system requirements and isort configuration to pyproject.toml [by Mike Taves]

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler almost 3 years ago

The country converter coco - a Python package for converting country names between different classification schemes - updated classifications

Change Log

0.8.0

Classifications

  • added Costa Rica as new OECD member (2021), fix #118
  • added GWCodes, https://www.tandfonline.com/doi/abs/10.1080/03050629908434958
  • added ccTLD (country top-level domains) via @plotski
  • updated EEA (remove UK, Switzerland)
  • rename Turkey to Türkiye

Bug fixes

  • fix UN M.49 names

Development

  • added pandas-convert (via @jim-rivera) for faster conversion of pandas series

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 3 years ago

The country converter coco - a Python package for converting country names between different classification schemes - bug fix for uk/gb regex

Change Log

0.7.7 - 20220805

Bug fixes

  • ISO2 did return the regex for GB|UK - fix #113

0.7.6 - 20220802

Breaking

  • additional data must specify ISO2 (necessary for regex matching in ISO2)

Classifications

  • added DACcode (pull request by @jm-rivera)

Bug fixes

  • N Korea matches North Korea - fix #95

Development

  • All rst files (readme, changelog, etc. format changed to markdown
  • ISO2 column accepts regex - fix #92

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 3 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Classification updates and ISO2 regex possiblity

0.7.6 - 20220802

Breaking

  • additional data must specify ISO2 (necessary for regex matching in ISO2)

Classifications

  • added DACcode (pull request by @jm-rivera)

Bug fixes

  • N Korea matches North Korea - fix #95

Development

  • All rst files (readme, changelog, etc. format changed to markdown
  • ISO2 column accepts regex - fix #92

0.7.5 - 20220802

Classifications

Bug Fixes

  • Escape characters in country names to allow for names with special symbols (brackets) in regex (#101)
  • Updated regex of India to exclude Bassas Da India (#111)

Development

  • Minimum required version of Black is 22.3.0

Full Changelog: https://github.com/konstantinstadler/country_converter/compare/v0.7.5...v0.7.6

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 3 years ago

The country converter coco - a Python package for converting country names between different classification schemes - new official country names

Change Log

0.7.5 - 20220802

Classifications ^^^^^^^^^^^^^^^^ * Changed name from Republic of Turkey to Republic of Türkiye (see https://en.wikipedia.org/wiki/Turkey ). * Changed Macedonia to North Macedonia (following the Prespa agreement: https://en.wikipedia.org/wiki/Prespa_agreement).

Bug Fixes ^^^^^^^^^

  • Escape characters in country names to allow for names with special symbols (brackets) in regex (#101)
  • Updated regex of India to exclude Bassas Da India (#111)

Development ^^^^^^^^^^^^^^^^

  • Minimum required version of Black is 22.3.0

Full Changelog: https://github.com/konstantinstadler/country_converter/compare/v0.7.4...v0.7.5

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 3 years ago

The country converter coco - a Python package for converting country names between different classification schemes - IEA classification

What's Changed

  • IEA classification added by @Kajwan in https://github.com/konstantinstadler/country_converter/pull/97
  • restructured github actions tests, now including production env @konstantinstadler in https://github.com/konstantinstadler/country_converter/pull/98

New Contributors

  • @Kajwan made their first contribution in https://github.com/konstantinstadler/country_converter/pull/97

Full Changelog: https://github.com/konstantinstadler/country_converter/blob/master/CHANGELOG.rst

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 4 years ago

The country converter coco - a Python package for converting country names between different classification schemes -

Change Log

0.7.3 - 20210409

Classifications

  • added GBDcode (numerical Global Burden of Disease codes)

Bug Fixes

  • Update for regex for several regions which erroneous matched countries (solves #86)
  • CLI help fix (solves #81)
  • Added HKSAR for Hong Kong, N.Korea for North Korea and some Macaou tests (solves #84)
  • Fixed for pandas Series inputs (solves #54)
  • Fixed aggregation concordance (solves #82)
  • Indiana does not match India

Development

  • functionality for testing regions which should not match
  • handle pandas future regex warning
  • moved from travis to github actions for CI testing
  • restructured tests and added test for consistent CHANGELOG - module version

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 4 years ago

The country converter coco - a Python package for converting country names between different classification schemes - version 0.7.2

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

Changelog

Classifications

  • added FAOcode (numerical FAO code)

API

  • added CountryConverter().validcountryclassifications which gives all country classifications (without any aggregation like continents or models)

Bug Fixes

  • French Guyana resettled to America (was Africa before) (fixes #76)
  • D.P.R of Korea resolves to North Korea (fixes #79)

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler almost 5 years ago

The country converter coco - a Python package for converting country names between different classification schemes - version 0.7.1

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

0.7.1 - 20201014

Classifications

  • added 2020 OECD membership for Colombia

Misc

  • changed the description for installing from conda forge
  • updated contributing.rst
  • explained logging settings in the readme

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 5 years ago

The country converter coco - a Python package for converting country names between different classification schemes - 0.7.0 - 20200925

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

CHANGELOG

Breaking

  • removed support for python 3.5
  • minimum pandas version = 1.0
  • The classifications for the EU are now based on names (EU27, EU15, ...) - the years have been removed (Brexit had made this necessary).
  • The output of the class level attributes and methods for the classifications (e.g. coco.OECD or coco.EXIO3as()) has changed
  • The standard output of the command line changed from ISO3 to short names, pass --to=ISO3 for the previous behaviour

Classifications

  • Added EU12, EU15, EU25, EU272007, EU28 and EU27 classification. This follows the names as explained here https://ec.europa.eu/eurostat/statistics-explained/index.php/Glossary:EUenlargements
  • The classification EU is linked to EU27 (thus status after Brexit)
  • The classification UN is a shortcut for UNmember
  • Added IAM IMAGE and REMIND classifications
  • Added EEA, for now including UK as it is still in place
  • Added Schengen region classification
  • Updated Lithuania OECD membership
  • fixed Ireland, UK, US regex problems - UK, GB and US are now included in the regex search term
  • changed official name of Macao to Macau

Internals

  • Adding class level attributes for the shortcuts to the classifications is now automated
  • multiple bug and spelling fixes
  • using black and isort for the code style
  • logger used in the countryconverter is named (based on module _name__)
  • re-established test coverage

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 5 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Extended country classifications

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

0.6.7 - 20191011

  • fixed various country spellings
  • Calling the command line (coco) without arguments prints help message
  • Deprecated pandas methods (ix, read_table) replaced
  • CLI interface allows to
    • include obsolete countries (--include_obsolete, -i)
    • restrict to only UN membersstates (--UNmember_only, -u)
    • return classifications (e.g. coco OECD or coco EXIO1)
  • Extended classification helper

0.6.6 - 20180729

  • Added Cecilia2050 classification (merging pull request #36 (with some futher modifications)
  • Changing Swaziland to Eswatini, following the official name change in April 2018 (https://unterm.un.org/UNTERM/Display/Record/UNHQ/NA/01b637e1-1497-4825-b73d-e0114a7f4d22 …). Closes issue #35
  • Removed space from McDonald in "Heard and Mc Donald Islands" and updated offical name to "Territory of Heard Island and McDonald Islands". Closes issus #34.

0.6.5 - 20180309

Coco now includes as switch for including obsolete countries (off by default), see https://github.com/konstantinstadler/country_converter#classification-schemes

Further improved test coverage

0.6.4 - 20180308

Improved test coverage Changed ISO3 for Kosovo from KSV to XKV

0.6.3 - 20180105

Switched ROW in WIOD to RoW

0.6.2 - 20180105

Switched WIOD country names to upper case to fit the WIOD database case

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 6 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Cecilia2050 classification and Eswatini/Swaziland switch

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

0.6.6 - 20180729

  • Added Cecilia2050 classification (merging pull request #36 from @bixiou with some futher modifications)

  • Changing Swaziland to Eswatini, following the official name change in April 2018 (https://unterm.un.org/UNTERM/Display/Record/UNHQ/NA/01b637e1-1497-4825-b73d-e0114a7f4d22 …). Closes issue #35

  • Removed space from McDonald in "Heard and Mc Donald Islands" and updated offical name to "Territory of Heard Island and McDonald Islands". Closes issus #34.

0.6.5 - 20180309

Coco now includes as switch for including obsolete countries (off by default), see https://github.com/konstantinstadler/country_converter#classification-schemes

Further improved test coverage

0.6.4 - 20180308

Improved test coverage Changed ISO3 for Kosovo from KSV to XKV

0.6.3 - 20180105

Switched ROW in WIOD to RoW

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 7 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Obsolote country switch included

Pymrio is an open source tool for analysing global environmentally extended multi-regional input-output tables (EE MRIOs). Pymrio aims to provide a high-level abstraction layer for global EE MRIO databases in order to simplify common EE MRIO data tasks. Pymrio includes automatic download functions and parsers for available EE MRIO databases like EXIOBASE, WIOD and EORA26_. It automatically checks parsed EE MRIOs for missing data necessary for calculating standard EE MRIO accounts (such as footprint, territorial, impacts embodied in trade) and calculates all missing tables. Various data report and visualization methods help to explore the dataset by comparing the different accounts across countries.

Pymrio is an open source tool for analysing global environmentally extended multi-regional input-output tables (EE MRIOs). Pymrio aims to provide a high-level abstraction layer for global EE MRIO databases in order to simplify common EE MRIO data tasks. Pymrio includes automatic download functions and parsers for available EE MRIO databases like EXIOBASE, WIOD and EORA26_. It automatically checks parsed EE MRIOs for missing data necessary for calculating standard EE MRIO accounts (such as footprint, territorial, impacts embodied in trade) and calculates all missing tables. Various data report and visualization methods help to explore the dataset by comparing the different accounts across countries.

0.6.5 - 20180309

Coco now includes as switch for including obsolete countries (off by default), see https://github.com/konstantinstadler/country_converter#classification-schemes

Further improved test coverage

0.6.4 - 20180308

Improved test coverage Changed ISO3 for Kosovo from KSV to XKV

0.6.3 - 20180105

Switched ROW in WIOD to RoW

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler almost 8 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Kosovo ISO3 update and test coverage

Country Converter (Coco)

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

0.6.4 - 20180308

Improved test coverage Changed ISO3 for Kosovo from KSV to XKV

0.6.3 - 20180105

Switched ROW in WIOD to RoW

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler almost 8 years ago

The country converter coco - a Python package for converting country names between different classification schemes - The country converter (coco) - a Python package for converting country names between different classification schemes.

Country Converter (Coco)

The country converter (coco) is a Python package to convert and match country names between different classifications and between different naming versions. Internally it uses regular expressions to match country names. Coco can also be used to build aggregation concordance matrices between different classification schemes.

Change Log

0.6.3 - 20180105

Switched ROW in WIOD to RoW

0.6.2 - 20180105

Switched WIOD country names to upper case to fit the WIOD database case

0.6.1 - 20180102

Minor spelling fixes

0.6.0 - 20180102

Aggregation concordance building functionality with

  • method getcorrespondancedict in CountryConverter
  • function agg_conc which build concordance matrices in various formats
  • notebook tutorial

Include Eora(26) country codes

CountryConverter accepts a parameter only_UNmember to restrict the concordances to UN member countries.

Fix and close Issue #28 (Wrong ISO3 code for Palestine) and #25 (Non-standard codes).

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler almost 8 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Aggregation functionality, Eora26 codes and issue fixing

Aggregation concordance building functionality with

  • method getcorrespondancedict in CountryConverter
  • function agg_conc which build concordance matrices in various formats
  • notebook tutorial

Include Eora(26) country codes

CountryConverter accepts a parameter only_UNmember to restrict the concordances to UN member countries.

Fix and close Issue #28 (Wrong ISO3 code for Palestine) and #25 (Non-standard codes).

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler about 8 years ago

The country converter coco - a Python package for converting country names between different classification schemes - The country converter (coco) - a Python package for converting country names between different classifications schemes.

0.5.0 - 20170802

This is the version after the review for publication in The Journal of Open Source Software.

Changed

* Renamed XXin methods to XXas. For example coco.EU27in('ISO3') becomese coco.EU27as('ISO3')
* Some updates in README.rst (related software, badges, motivation)
* Added CONTRIBUTING.rst

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 8 years ago

The country converter coco - a Python package for converting country names between different classification schemes - Extended functionality for missing data and own data

Extended functionality:

  • Account for cases where countries or regions are specified with 'exclude ...'

    • Possibility to add custom countryfile for own mappings
    • Not found value can be specified also in the CLI version

  • Automatically detect input format (ISO2, ISO3, ISOnumeric)

Some bugfixes:

  • Change ISO3 for Romania from ROM to ROU (bugfix)

    • Change ISO3 for Congo from COD to COG (bugfix)

Scientific Software - Peer-reviewed - Python
Published by konstantinstadler over 8 years ago