An R package to create Mexico choropleths
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
R documentation Apr 1, 2018
README_files/figure-markdown_github update dates Mar 29, 2018
data
docs documentation Apr 1, 2018
man
tests
vignettes/articles add remove municipio borders example Jul 28, 2018
.Rbuildignore issue template May 15, 2018
.gitignore
.travis.yml
DESCRIPTION version 0.5.3 with choroplethr 3.6.3 Aug 21, 2018
ISSUE_TEMPLATE.md google group Jul 5, 2018
LICENSE
NAMESPACE documentation Apr 1, 2018
NEWS.md version 0.5.3 with choroplethr 3.6.3 Aug 21, 2018
README.Rmd forum Jul 5, 2018
README.md google group Jul 5, 2018
_pkgdown.yml
index.Rmd
mxmaps.Rproj roxygen2 docs Jan 5, 2016

README.md

Mexico Choropleths

Diego Valle-Jones May 28, 2018

Master: Travis-CI Build Status Coverage Status

Author: Diego Valle-Jones
License: BSD_3
Website: https://www.diegovalle.net/mxmaps/
Forum https://groups.google.com/forum/#!forum/mxmaps

What does it do?

This package is based on choroplethr and can be used to easily create maps of Mexico at both the state and municipio levels. It also includes functions to create interactive maps using the leaflet package, map INEGI data from its API, and format strings so they match the INEGI state and municipio codes. Be sure to visit the official website.

Installation

For the moment this package is only available from github. For the development version:

if (!require(devtools)) {
    install.packages("devtools")
}
devtools::install_github('diegovalle/mxmaps')

Quick Example

library(mxmaps)

data("df_mxstate")
df_mxstate$value <- df_mxstate$pop
mxstate_choropleth(df_mxstate,
                    title = "Total population, by state") 

Data

The data.frame that you provide to the plotting functions must have one column named "region" and one column named "value". The entries for "region" must match the INEGI codes for states ("01", "02", etc) and municipios ("01001", "01002", etc) either as a string with or without a leading "0" or as numerics. The functions str_mxstate and str_mxmunicipio are provided to easily format codes to the INEGI specification. Also, two example data.frames, df_mxstate and df_mxmunicipio, are provided with demographic variables from the Encuesta Intercensal 2015.

data("df_mxstate")
knitr::kable(head(df_mxstate))
region state_name state_name_official state_abbr state_abbr_official pop pop_male pop_female afromexican part_afromexican indigenous part_indigenous
01 Aguascalientes Aguascalientes AGS Ags. 1312544 640091 672453 653 4559 153395 18716
02 Baja California Baja California BC BC 3315766 1650341 1665425 7445 10432 283055 38391
03 Baja California Sur Baja California Sur BCS BCS 712029 359137 352892 11032 5132 103034 11728
04 Campeche Campeche CAMP Camp. 899931 441276 458655 3554 6833 400811 13140
05 Coahuila Coahuila de Zaragoza COAH Coah. 2954915 1462612 1492303 2761 8137 204890 28588
06 Colima Colima COL Col. 711235 350791 360444 762 3314 145297 12373
data("df_mxmunicipio")
knitr::kable(head(df_mxmunicipio))
state_code municipio_code region state_name state_name_official state_abbr state_abbr_official municipio_name pop pop_male pop_female afromexican part_afromexican indigenous part_indigenous metro_area long lat
01 001 01001 Aguascalientes Aguascalientes AGS Ags. Aguascalientes 877190 425731 451459 532 2791 104125 14209 Aguascalientes -102.2960 21.87982
01 002 01002 Aguascalientes Aguascalientes AGS Ags. Asientos 46464 22745 23719 3 130 1691 92 NA -102.0893 22.23832
01 003 01003 Aguascalientes Aguascalientes AGS Ags. Calvillo 56048 27298 28750 10 167 7358 2223 NA -102.7188 21.84691
01 004 01004 Aguascalientes Aguascalientes AGS Ags. Cosío 15577 7552 8025 0 67 2213 191 NA -102.3000 22.36641
01 005 01005 Aguascalientes Aguascalientes AGS Ags. Jesús María 120405 60135 60270 32 219 8679 649 Aguascalientes -102.3434 21.96127
01 006 01006 Aguascalientes Aguascalientes AGS Ags. Pabellón de Arteaga 46473 22490 23983 3 74 6232 251 NA -102.2765 22.14920

Municipios

Here's another example showing Mexican municipios (similar to counties):

data("df_mxmunicipio")
df_mxmunicipio$value <-  df_mxmunicipio$indigenous / df_mxmunicipio$pop 
mxmunicipio_choropleth(df_mxmunicipio, num_colors = 1,
                       title = "Percentage of the population that self-identifies as indigenous")