mapdeck

R interface to Deck.gl and Mapbox

https://github.com/symbolixau/mapdeck

Science Score: 36.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
  • Academic publication links
  • Committers with academic emails
    1 of 20 committers (5.0%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (20.2%) to scientific vocabulary

Keywords

deckgl geospatial mapbox mapbox-gl mapbox-gl-js maps r rstats

Keywords from Contributors

geo google-map gdal proj tidy-data grammar spatial-analysis google-maps-javascript-api google-maps-api graphics
Last synced: 6 months ago · JSON representation

Repository

R interface to Deck.gl and Mapbox

Basic Info
Statistics
  • Stars: 370
  • Watchers: 15
  • Forks: 41
  • Open Issues: 79
  • Releases: 5
Topics
deckgl geospatial mapbox mapbox-gl mapbox-gl-js maps r rstats
Created over 7 years ago · Last pushed 11 months ago
Metadata Files
Readme Changelog

README.Rmd

---
output: github_document
---



```{r setup, include = FALSE}
knitr::opts_chunk$set(
  collapse = TRUE,
  comment = "# ",
  fig.path = "man/figures/README-",
  out.width = "100%"
)
```
# mapdeck

[![R build status](https://github.com/SymbolixAU/mapdeck/workflows/R-CMD-check/badge.svg)](https://github.com/SymbolixAU/mapdeck/actions)
[![Codecov test coverage](https://app.codecov.io/gh/symbolixau/mapdeck?branch=master)
[![CRAN_Status_Badge](http://www.r-pkg.org/badges/version/mapdeck)](https://CRAN.R-project.org/package=mapdeck)
![downloads](http://cranlogs.r-pkg.org/badges/grand-total/mapdeck)
[![CRAN RStudio mirror downloads](http://cranlogs.r-pkg.org/badges/mapdeck)](https://CRAN.R-project.org/package=mapdeck)
[![Github Stars](https://img.shields.io/github/stars/SymbolixAU/mapdeck.svg?style=social&label=Github)](https://github.com/SymbolixAU/mapdeck)

![](./docs/articles/img/articles/hexagons.png)

## What is mapdeck?

An R library which lets you plot large data sets (as much as your GPU &
browser can handle), on interactive maps using Mapbox GL and Deck.gl

![](./docs/articles/img/articles/polygon_transitions.gif)

## What is mapbox?

> Mapbox is the location data platform for mobile and web applications. We provide building blocks to add location features like maps, search, and navigation into any experience you create.

- https://www.mapbox.com/about/company

## What is deck.gl?

> deck.gl is a WebGL-powered framework for visual exploratory data analysis of large datasets.

- https://deck.gl/#/

## How do I use it? 

First you need to install it, either from CRAN

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

Or from github (to get the latest development version)

```r
remotes::install_github("SymbolixAU/mapdeck")
```

If the github version fails to install, you'll probably need to update dependencies first

```r
remotes::install_github("dcooley/geometries")
remotes::install_github("dcooley/sfheaders")
remotes::install_github("SymbolixAU/spatialwidget")
```


Then everything you need to know to get you started is on the [home page](https://symbolixau.github.io/mapdeck/articles/mapdeck.html)



## Quick Start

Mapdeck uses [Mapbox maps](https://www.mapbox.com/), and to use Mapbox you need an [access token](https://docs.mapbox.com/help/how-mapbox-works/access-tokens/).

Once you've generate a token you can use their maps.

Call `mapdeck(token = 'your_token')` to generate a basic map. Then start adding layers by using one of the various `add_*()` functions. 

```r
url <- 'https://raw.githubusercontent.com/plotly/datasets/master/2011_february_aa_flight_paths.csv'
flights <- read.csv(url)
flights$info <- paste0("",flights$airport1, " - ", flights$airport2, "")

mapdeck(token = key, style = mapdeck_style('dark')) %>%
  add_arc(
    data = flights
    , origin = c("start_lon", "start_lat")
    , destination = c("end_lon", "end_lat")
    , stroke_from = "airport1"
    , stroke_to = "airport2"
    , tooltip = "info"
    , layer_id = 'arclayer'
  )
```

![Arcs](./vignettes/img/readme_arcs_small.gif)


See the [Layers](https://symbolixau.github.io/mapdeck/articles/layers.html) page for more examples

## Getting help

For general help and advice the best place to ask is on [StackOverflow](https://stackoverflow.com/questions/tagged/mapdeck) (using the `mapdeck` tag).

If you've found a bug, or want a new feature added then use the [issue tracker](https://github.com/SymbolixAU/mapdeck/issues) on github.

I don't respond to emails asking for help because this is an open source package, and any advice should be kept open so everyone can benefit. (unless you want to pay me!)



Owner

  • Name: SymbolixAU
  • Login: SymbolixAU
  • Kind: organization
  • Location: Melbourne, Australia

GitHub Events

Total
  • Issues event: 5
  • Watch event: 9
  • Member event: 2
  • Issue comment event: 18
  • Push event: 6
  • Pull request event: 2
  • Fork event: 1
  • Create event: 4
Last Year
  • Issues event: 5
  • Watch event: 9
  • Member event: 2
  • Issue comment event: 18
  • Push event: 6
  • Pull request event: 2
  • Fork event: 1
  • Create event: 4

Committers

Last synced: 10 months ago

All Time
  • Total Commits: 1,020
  • Total Committers: 20
  • Avg Commits per committer: 51.0
  • Development Distribution Score (DDS): 0.436
Past Year
  • Commits: 16
  • Committers: 3
  • Avg Commits per committer: 5.333
  • Development Distribution Score (DDS): 0.438
Top Committers
Name Email Commits
SymbolixAU d****y@s****u 575
tospig d****1@g****m 283
SymbolixAU d****y@S****u 102
dcooley = 16
Mitchell m****d@m****u 13
SymbolixAU d****t@s****u 6
SymbolixAU d****d@D****l 5
Michael Sumner m****r@g****m 4
SymbolixAU e****k@s****u 3
mpadge m****m@e****m 2
Hernán Mejía h****n@u****o 2
ChrisMuir c****A@g****m 1
Jakub Nowosad N****d 1
Kim Fitter k****r@y****m 1
Zac Davies z****v@Z****l 1
Mara Averick m****k@g****m 1
Michael Chirico m****4@g****m 1
Tyler Littlefield t****1@g****m 1
Zachary Davies z****v 1
Zekiye-Y 6****Y 1
Committer Domains (Top 20 + Academic)

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 122
  • Total pull requests: 9
  • Average time to close issues: 3 months
  • Average time to close pull requests: 11 months
  • Total issue authors: 48
  • Total pull request authors: 6
  • Average comments per issue: 3.3
  • Average comments per pull request: 0.78
  • Merged pull requests: 5
  • Bot issues: 0
  • Bot pull requests: 0
Past Year
  • Issues: 5
  • Pull requests: 3
  • Average time to close issues: 2 months
  • Average time to close pull requests: N/A
  • Issue authors: 4
  • Pull request authors: 2
  • Average comments per issue: 2.8
  • Average comments per pull request: 0.0
  • Merged pull requests: 0
  • Bot issues: 0
  • Bot pull requests: 0
Top Authors
Issue Authors
  • dcooley (40)
  • SymbolixAU (24)
  • Robinlovelace (4)
  • Zekiye-VAP (4)
  • mitchelloharawild (4)
  • yvanrichard (3)
  • yoshida-gisc (3)
  • hdmm3 (3)
  • jzadra (3)
  • symbalex (2)
  • bdbmax (2)
  • rwjam (2)
  • xtimbeau (2)
  • chrislim5 (2)
  • wolfeclw (2)
Pull Request Authors
  • hdmm3 (4)
  • sahinya17 (2)
  • mitchelloharawild (2)
  • RayShao01010010 (2)
  • dcooley (1)
  • Zekiye-Y (1)
Top Labels
Issue Labels
enhancement (78) question (14) bug (2) External Dependency (2) documentation (1)
Pull Request Labels

Packages

  • Total packages: 4
  • Total downloads:
    • cran 1,519 last-month
  • Total docker downloads: 20,920
  • Total dependent packages: 6
    (may contain duplicates)
  • Total dependent repositories: 15
    (may contain duplicates)
  • Total versions: 20
  • Total maintainers: 1
cran.r-project.org: mapdeck

Interactive Maps Using 'Mapbox GL JS' and 'Deck.gl'

  • Versions: 7
  • Dependent Packages: 5
  • Dependent Repositories: 15
  • Downloads: 1,519 Last month
  • Docker Downloads: 20,920
Rankings
Stargazers count: 1.1%
Forks count: 1.8%
Docker downloads count: 5.0%
Average: 5.6%
Dependent repos count: 7.4%
Dependent packages count: 8.0%
Downloads: 10.1%
Maintainers (1)
Last synced: 6 months ago
proxy.golang.org: github.com/SymbolixAU/mapdeck
  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
proxy.golang.org: github.com/symbolixau/mapdeck
  • Versions: 5
  • Dependent Packages: 0
  • Dependent Repositories: 0
Rankings
Dependent packages count: 5.4%
Average: 5.6%
Dependent repos count: 5.8%
Last synced: 6 months ago
conda-forge.org: r-mapdeck
  • Versions: 3
  • Dependent Packages: 1
  • Dependent Repositories: 0
Rankings
Stargazers count: 18.8%
Forks count: 25.4%
Average: 26.8%
Dependent packages count: 28.8%
Dependent repos count: 34.0%
Last synced: 6 months ago

Dependencies

DESCRIPTION cran
  • R >= 3.5.0 depends
  • Rcpp * imports
  • colourvalues >= 0.3.6 imports
  • geojsonsf >= 1.3.3 imports
  • googlePolylines >= 0.7.2 imports
  • htmlwidgets * imports
  • jsonify >= 1.1.1 imports
  • magrittr * imports
  • sfheaders >= 0.3.0 imports
  • shiny * imports
  • covr * suggests
  • googleway * suggests
  • jsonlite * suggests
  • knitr * suggests
  • rmarkdown * suggests
  • spatialwidget * suggests
  • testthat * suggests
.github/workflows/R-CMD-check.yaml actions
  • actions/cache v1 composite
  • actions/checkout v2 composite
  • actions/upload-artifact main composite
  • r-lib/actions/setup-pandoc master composite
  • r-lib/actions/setup-r master composite