Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/FlowmapBlue/flowmapblue.R

Flowmap.blue widget for R
https://github.com/FlowmapBlue/flowmapblue.R

datavis mobility mobility-data movement-data rstats rstudio

Last synced: 3 months ago
JSON representation

Flowmap.blue widget for R

Awesome Lists containing this project

README

        

# Flowmap.blue R widget flowmapblue website

CRAN status
CRAN/METACRAN Total downloads
CRAN/METACRAN Downloads per month R-CMD-check
Lifecycle: stable

[![DOI](https://zenodo.org/badge/DOI/10.32614/CRAN.package.flowmapblue.svg)](https://doi.org/10.32614/CRAN.package.flowmapblue)

WORK IN PROGRESS

This is a [Flowmap.blue](https://www.flowmap.blue/) widget for R. Create
interactive flow maps using
[`FlowmapBlue`](https://github.com/FlowmapBlue/FlowmapBlue) TypeScript
library, which is a free tool for representing aggregated numbers of
movements between geographic locations as flow maps. It is used to
visualize urban mobility, commuting behavior, bus, subway and air
travels, bicycle sharing, human and bird migration, refugee flows,
freight transportation, trade, supply chains, scientific collaboration,
epidemiological and historical data and many other topics. The package
allows to either create standalone flow maps in form of ‘htmlwidgets’
and save them in ‘HTML’ files, or integrate flow maps into ‘Shiny’
applications.

You might also consider using this pure R flowmapping library based on
`ggplot2`: https://github.com/JohMast/flowmapper

![](man/figures/demo.png)

As an alternative, you may also consider using R to populate a
spreadsheet for publishing on [Flowmap.blue](https://www.flowmap.blue/)
as described in this [excellent blog
post](https://doodles.mountainmath.ca/blog/2020/01/06/flow-maps/).

### Installation

Install from CRAN:

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

To install the development version from GitHub you will need to install
`remotes` if you don’t have it yet:

``` r
if (!require("remotes")) install.packages("remotes")

remotes::install_github("FlowmapBlue/flowmapblue.R",
force = TRUE, dependencies = TRUE)
```

### Quick example

Setup your Mapbox access token. You can obtain a free token by signing
up at [Mapbox](https://account.mapbox.com/).

``` r
Sys.setenv(MAPBOX_API_TOKEN = "YOUR_MAPBOX_ACCESS_TOKEN")
```

``` r
library(flowmapblue)

# load locations and flows for Switzerland
data(ch_locations)
data(ch_flows)

flowmap <- flowmapblue(
ch_locations,
ch_flows,
mapboxAccessToken = Sys.getenv('MAPBOX_API_TOKEN'),
clustering = TRUE,
darkMode = TRUE,
animation = FALSE
)

# view the map
flowmap
```

Here is a [nice intro blog
post](https://www.paulamoraga.com/blog/2020-07-11-mobility.html) by
Paula Moraga.

For more examples with time and date in flows data, as well as
integration with Shiny, see the Quick Start vignette and documentation
for the package functions at
.