Ari Lamstein

Note: Choroplethr is currently in “maintenance mode”. I am responding to requests from CRAN for minor updates, but am not otherwise working on the project. Please contact me if you are interested in taking ownership of the project.

Choroplethr is a suite of R packages I wrote that facilitates mapping demographic statistics. The name “Choroplethr” comes from combining the words “choropleth map” and “R programming language”. A choropleth is any map that shows regions, and expresses values for those regions with color.

Choroplethr is easy to use, has built-in support for mapping every country in the world and integrates with several open data sources, such as the US Census Bureau’s American Community Survey (ACS). It has been installed hundreds of thousands of times.

The video below, which is based on a talk I gave at the US Centers for Disease Control and Prevention (CDC), gives an overview of the project.

Getting Started

To start using Choroplethr simply type install.packages(“choroplethr”) at the R console.


I have created three courses which give detailed instructions on how to use various aspects of of Choroplethr. The first two courses previously sold for $99 each, but are now available for free.

Asking Questions

If you have a technical question related to Choroplethr, I recommend asking on Stack Overflow. Please tag your question with the keyword “choroplethr”. (Click here to see past questions).