robinlovelace / foss4g-workshop

Material for FOSS4G 2022 workshop on tidy spatial network analysis with sfnetworks

sfnetworks: Tidy Geospatial Networks in R

Material for FOSS4G 2022 workshop on tidy spatial network analysis with sfnetworks

• Abstract

• Slides

• sfnetworks repo

• Live demo

How to follow the tutorial

Option 1: Binder

Launch the Binder environment with the badge at the top of the README. This will open an RStudio session where you can follow along. Please be patient, the first time you run in can take a while.

Option 2: Docker

You can create a Docker container with all the packages needed. The main pre-requisite is to install Docker if you do not have it already. See instructions for Windows here and for Linux here.

Once you have Docker available, you can clone this repo, navigate to docker/ and run:

docker build -t sfnetworks .

This will build a Docker container based on the Dockerfile in that directory.

Then to start the container for the first time run:

cd ..
bash ./docker/create_container.sh

Troubleshoot - Windows:

• You might need to run sh ./docker/create_container.sh

• Make sure to update your working directory to mount a volume to the current directory inside create_container.sh, specifically this line: -v CHANGE_DIR_HERE://home/rstudio/workdir \. Note the extra / before home.

Option 3: You are an R-Spatial user

If this is not your first time doing R-Spatial, it is likely that you already count with all the artillery needed to work with sfnetworks on your local machine.

If that is the case, you would need to install the following packages:

install.packages('dbscan')
install.packages('igraph')
install.packages('mapview')
install.packages('tidygraph')
install.packages('TSP')
install.packages('tidyverse')
devtools::install_github('luukvdmeer/sfnetworks')
devtools::install_github('ropensci/osmextract')

Question or problems?

If you have any question related to running this tutorial, please open an issue here.

If you have been using sfnetworks already and have an interesting problem to discuss, you can go to our Discussions tab of the package here.