Author: Bhaskar V. Karambelar
Date: 2017-03-29

# Using Tilegrams in R

#### Bhaskar V. Karambelar

#### 2017-03-29

The goal of tilegramsR is to provide R spatial objects representing Tilegrams. The primary purpose of this data is for plotting either using base plotting, ggplot2 or leaflet. To know more about Tilegrams see this post and a this web app.

### Usage

#### Installation

    install.packages('tilegramsR')

    #OR Latest Development version

    devtools::install_github('bhaskarvk/tilegramsR')

#### Example Code

Check out `inst\examples` folder, or see it in action at Rpubs: tilegramsR and Rpubs: Election Map.

### Data

The package provides spatial objects in sf format.

#### Pitch Interactive Tilegrams

##### U.S.A

- sf_Pitch_US_Population_2016_v1: A `sf` object where each feature = 500K people
- sf_Pitch_US_Population_2016_v1.states: A `sf` object where each feature = 1 state of the U.S.A
- sf_Pitch_US_Population_2016_v1.centers: A `sf` object of centroids of each state of the U.S.A.

##### Germany

- sf_germany_constituencies: A `sf` object where each feature is a German Constituency
- sf_germany_constituencies.centers: A `sf` object of centroids of each German Constituency

##### France

- sf_france_regions_population: A `sf` object of French regions
- sf_france_regions_population.regions: A `sf` object of boundaries of French regions
- sf_france_regions_population.centers: A `sf` object of centroids of each French region
- sf_france_all_regions_population: A `sf` object of French Regions including overseas regions
- sf_france_all_regions_population.regions: A `sf` object of boundaries of all French regions
- sf_france_all_regions_population.centers: A `sf` object of centroids of each French Region including overseas regions
- sf_france_departments: A `sf` object of French departments
- sf_france_departments.centers: A `sf` object of centroids of each French department

#### fivethirtyeight’s Electoral College Tilegram

- sf_FiveThirtyEightElectoralCollege: A `sf` object where each feature = 1 electoral college
- sf_FiveThirtyEightElectoralCollege.states: A `sf` object where each feature = 1 state of the U.S.A
- sf_FiveThirtyEightElectoralCollege.centers: A `sf` object of centroids of each state of the U.S.A.

#### NPR

##### Hexagon Tilegram

- sf_NPR1to1: A `sf` object where each feature = 1 state of the U.S.A
- sf_NPR1to1.centers: A `sf` object of centroids of each state of the U.S.A.

##### NPR.DemersCartogram

- sf_NPR.DemersCartogram: A `sf` object where each feature = 1 state of the U.S.A
- sf_NPR.DemersCartogram.centers: A `sf` object of centroids of each state of the U.S.A.

#### Daily KOS

##### Dual Hexagon Tilegram

- sf_DKOS_50_State_OuterHex_Tilemap_v1: A `sf` object where each feature = 1 state of the U.S.A
- sf_DKOS_50_State_InnerHex_Tilemap_v1: A `sf` object where each feature = 1 state of the U.S.A
- sf_DKOS_50_State_Hex_Tilemap_v1.centers: A `sf` object of centroids of each state of the U.S.A.

##### Congressional Districts Tilegram

- sf_DKOS_CD_Hexmap_v1.1: A `sf` object where each feature = 1 congressional District
- sf_DKOS_CD_Hexmap_v1.1.states: A `sf` object where each feature = 1 state of the U.S.A
- sf_DKOS_CD_Hexmap_v1.1.centers: A `sf` object of centroids of each state of the U.S.A.

##### Electoral College Tilegram

- sf_DKOS_Electoral_College_Map_v1: A `sf` object where each feature = 1 electoral college
- sf_DKOS_Electoral_College_Map_v1.states: A `sf` object where each feature = 1 state of the U.S.A
- sf_DKOS_Electoral_College_Map_v1.centers: A `sf` object of centroids of each state of the U.S.A.

##### Distorted Electoral College Tilegram

- sf_DKOS_Distorted_Electoral_College_Map_v1: A `sf` object where each feature = 1 state of the U.S.A
- sf_DKOS_Distorted_Electoral_College_Map_v1.centers: A `sf` object of centroids of each state of the U.S.A.

#### Washington Post Tilegram

- sf_WP: A `sf` object where each feature = 1 state of the U.S.A
- sf_WP.centers: A `sf` object of centroids of each state of the U.S.A.

#### Wall Street Journal Tilegram

- sf_WSJ: A `sf` object where each feature = 1 state of the U.S.A
- sf_WSJ.centers: A `sf` object of centroids of each state of the U.S.A.

#### Datamap.io.tilegram

- sf_Datamap.io.tilegram: A `sf` object where each feature = 1 state of the U.S.A
- sf_Datamap.io.tilegram.centers: A `sf` object of centroids of each state of the U.S.A.

As and when newer Tilegrams are made available they will be added to this package.

### Credits

- Pitch Interactive for the excellent Tilegrams webapp and population tilegram.
- Daniel Donner of Daily KOS for Tilegrams.
- Ella Koeze for fivethirtyeight[.]com Tilegrams.
- Danny DeBelius & Brian Boyer for NPR’s Hexagon Tilegrams.
- NPR Demers Cartogram
- Washington Post Tilegram
- Wall Street Journal Tilegram
- Datamap.io Tilegram