Data

Tools

Indexes

Applications

Experiments

Open Source Science

countrycode

countrycode: An R package to convert country names and country codes - Published in JOSS (2018)

https://github.com/vincentarelbundock/countrycode

Science Score: 95.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • ○
    CITATION.cff file
  • ✓
    codemeta.json file
    Found codemeta.json file
  • ✓
    .zenodo.json file
    Found .zenodo.json file
  • ✓
    DOI references
    Found 6 DOI reference(s) in README and JOSS metadata
  • ✓
    Academic publication links
    Links to: joss.theoj.org
  • ✓
    Committers with academic emails
    2 of 24 committers (8.3%) from academic institutions
  • ○
    Institutional organization owner
  • ✓
    JOSS paper metadata
    Published in Journal of Open Source Software

Keywords from Contributors

tidyverse
Last synced: 6 months ago · JSON representation

Repository

R package: Convert country names and country codes. Assigns region descriptors.

Basic Info
Statistics
  • Stars: 358
  • Watchers: 11
  • Forks: 85
  • Open Issues: 15
  • Releases: 7
Created over 14 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog License

README.Rmd 

---
output: github_document
---










[![DOI](http://joss.theoj.org/papers/10.21105/joss.00848/status.svg)](https://doi.org/10.21105/joss.00848)

[![R build status](https://github.com/vincentarelbundock/countrycode/workflows/R-CMD-check/badge.svg)](https://github.com/vincentarelbundock/countrycode/actions)



`countrycode` standardizes country names, converts them into ~40 different coding schemes, and assigns region descriptors. Scroll down for more details or visit the [countrycode CRAN page](http://cran.r-project.org/web/packages/countrycode/index.html)

If you use `countrycode` in your research, we would be very grateful if you could cite our paper:

> Arel-Bundock, Vincent, Nils Enevoldsen, and CJ Yetman, (2018). countrycode: An R package to convert country names and country codes. Journal of Open Source Software, 3(28), 848, https://doi.org/10.21105/joss.00848

## Why `countrycode`?

### The Problem

Different data sources use different coding schemes to represent countries (e.g. CoW or ISO). This poses two main problems: (1) some of these coding schemes are less than intuitive, and (2) merging these data requires converting from one coding scheme to another, or from long country names to a coding scheme.

### The Solution

The `countrycode` function can convert to and from 40+ different country coding schemes, and to 600+ variants of country names in different languages and formats. It uses regular expressions to convert long country names (e.g. Sri Lanka) into any of those coding schemes or country names. It can create new variables with various regional groupings.

## Installation

From the R console, type: 

```r
install.packages("countrycode")
```

To install the latest development version, you can use the `remotes` package:

```r
library(remotes)
install_github('vincentarelbundock/countrycode')
```

## Supported codes

To get an up-to-date list of supported country codes, install the package and type `?codelist`. These include:

* 600+ variants of country names in different languages and formats.
* AR5
* Continent and region identifiers.
* Correlates of War (numeric and character)
* European Central Bank
* [EUROCONTROL](https://www.eurocontrol.int) - The European Organisation for the Safety of Air Navigation
* Eurostat
* Federal Information Processing Standard (FIPS)
* Food and Agriculture Organization of the United Nations
* Global Administrative Unit Layers (GAUL)
* Geopolitical Entities, Names and Codes (GENC)
* Gleditsch & Ward (numeric and character)
* International Civil Aviation Organization
* International Monetary Fund
* International Olympic Committee
* ISO (2/3-character and numeric)
* Polity IV
* United Nations
* United Nations Procurement Division
* Varieties of Democracy
* World Bank
* World Values Survey
* Unicode symbols (flags)

Owner

  • Name: Vincent Arel-Bundock
  • Login: vincentarelbundock
  • Kind: user
  • Location: Montreal, Canada

Political science prof

JOSS Publication

countrycode: An R package to convert country names and country codes
Published
August 09, 2018
DOI
Volume 3, Issue 28, Page 848
Authors
Vincent Arel-Bundock ORCID
Université de Montréal
Nils Enevoldsen ORCID
Massachussetts Institute of Technology
Cj Yetman ORCID
Hertie School of Governance
Editor
Thomas J. Leeper ORCID
Tags
CRAN social science country names country codes geography
View PDF Review Thread Software Archive

GitHub Events

Total
  • Issues event: 7
  • Watch event: 15
  • Issue comment event: 23
  • Push event: 5
  • Pull request review event: 1
  • Pull request event: 2
  • Fork event: 2
Last Year
  • Issues event: 7
  • Watch event: 15
  • Issue comment event: 23
  • Push event: 5
  • Pull request review event: 1
  • Pull request event: 2
  • Fork event: 2

Committers

Last synced: 7 months ago

All Time
  • Total Commits: 431
  • Total Committers: 24
  • Avg Commits per committer: 17.958
  • Development Distribution Score (DDS): 0.613
Past Year
  • Commits: 5
  • Committers: 2
  • Avg Commits per committer: 2.5
  • Development Distribution Score (DDS): 0.2
Top Committers
Name Email Commits
Vincent Arel-Bundock v****l@u****u 167
Vincent Arel-Bundock v****k@u****a 151
CJ Yetman cj@c****m 42
Nils Enevoldsen N****n 31
Etienne Bacher 5****r 9
Salim B s****m@p****e 4
Christophe Gouel c****l@i****r 4
Étienne Tétreault-Pinard e****d@g****m 3
Ed Hagen e****n@g****m 2
Enrico Spinielli e****i@e****t 2
Hisham Galal g****l@u****g 2
mcooper m****r@g****m 2
Altaf Ali a****f@f****m 1
Bastiaan Quast b****t@g****m 1
Christopher Gandrud c****d@g****m 1
Dan Baston d****n@i****m 1
Luis Valenzuela l****z@u****l 1
Michal Ovádek 4****k 1
Pascal Burkhard p****d@g****m 1
Sébastien Thonnard 3****d 1
Niklas Roming n****g@c****g 1
Anh Le a****3@d****u 1
Andrew B. Collier a****w@e****z 1
Y. Yu 5****e 1
Committer Domains (Top 20 + Academic)
exegetic.biz: 1 duke.edu: 1 climateanalytics.org: 1 uc.cl: 1 isciences.com: 1 fastmail.com: 1 unhcr.org: 1 eurocontrol.int: 1 inra.fr: 1 posteo.de: 1 cjyetman.com: 1 umontreal.ca: 1 umich.edu: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 92
  • Total pull requests: 45
  • Average time to close issues: 7 months
  • Average time to close pull requests: 3 months
  • Total issue authors: 49
  • Total pull request authors: 15
  • Average comments per issue: 4.99
  • Average comments per pull request: 3.09
  • Merged pull requests: 33
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 3
  • Pull requests: 2
  • Average time to close issues: about 7 hours
  • Average time to close pull requests: 4 days
  • Issue authors: 3
  • Pull request authors: 1
  • Average comments per issue: 6.33
  • Average comments per pull request: 0.5
  • Merged pull requests: 2
  • Bot issues: 0
  • Bot pull requests: 0
View more stats
Top Authors
Issue Authors
  • vincentarelbundock (22)
  • cjyetman (9)
  • NilsEnevoldsen (5)
  • morrisseyj (3)
  • iago-pssjd (3)
  • luispfonseca (2)
  • iamgyang (2)
  • geotheory (2)
  • dieghernan (2)
  • christophe-gouel (1)
  • smoser11 (1)
  • JohnsonBrent (1)
  • fschaffner (1)
  • sumtxt (1)
  • embruna (1)
Pull Request Authors
  • cjyetman (11)
  • NilsEnevoldsen (7)
  • salim-b (5)
  • vincentarelbundock (5)
  • sthonnard (4)
  • Nenuial (2)
  • espinielli (2)
  • christophe-gouel (2)
  • luisvalenzuelar (2)
  • michalovadek (2)
  • etiennebacher (2)
  • PursuitOfDataScience (1)
  • galalH (1)
  • olivroy (1)
  • dieghernan (1)
Top Labels
Issue Labels
regex (6) match issue (3) many-to-one issue (2) new feature (2) new code (2) bug (1) test (1) won't fix (1)
Pull Request Labels

Packages

  • Total packages: 2
  • Total downloads:
    • cran 136,635 last-month
  • Total docker downloads: 133,239
  • Total dependent packages: 47
    (may contain duplicates)
  • Total dependent repositories: 153
    (may contain duplicates)
  • Total versions: 39
  • Total maintainers: 1
cran.r-project.org: countrycode

Convert Country Names and Country Codes

  • Versions: 30
  • Dependent Packages: 45
  • Dependent Repositories: 152
  • Downloads: 136,635 Last month
  • Docker Downloads: 133,239
Rankings
Forks count: 0.8%
Stargazers count: 1.2%
Dependent repos count: 1.6%
Average: 1.8%
Dependent packages count: 2.0%
Docker downloads count: 2.3%
Downloads: 3.0%
Maintainers (1)
vincent.arel-bundock@umontreal.ca
Last synced: 6 months ago
conda-forge.org: r-countrycode
  • Versions: 9
  • Dependent Packages: 2
  • Dependent Repositories: 1
Rankings
Dependent packages count: 19.6%
Forks count: 20.8%
Average: 21.7%
Stargazers count: 22.0%
Dependent repos count: 24.3%
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 2.10 depends
  • testthat * suggests
  • tibble * suggests
  • utf8 * suggests
.github/workflows/check-standard.yaml actions
  • actions/checkout v3 composite
  • r-lib/actions/check-r-package v2 composite
  • r-lib/actions/setup-pandoc v2 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
.github/workflows/lint.yaml actions
  • actions/checkout v3 composite
  • r-lib/actions/setup-r v2 composite
  • r-lib/actions/setup-r-dependencies v2 composite
dictionary/Dockerfile docker
  • r-base latest build