plot_3D: Create 3D interactive elevation map from gpx tracklogs

View source: R/plot_3D.R

plot_3DR Documentation

Create 3D interactive elevation map from gpx tracklogs

Description

Create 3D interactive elevation map from gpx tracklogs

Usage

plot_3D(
  tracklog_folder = NULL,
  cache_folder = "~/cache_plot_3D",
  elevation_scale = 6,
  elevation_scale_tracklog_corr = 0.01,
  buffer_around_tracklog_km = 1,
  render_high_quality = FALSE,
  sunangle = 250,
  sunaltitude = 75,
  color_tracklog = "blue",
  color_background = "lightskyblue1",
  water_detect = FALSE
)

Arguments

tracklog_folder

The path to the folder of your gpx file to be read by strava::process_data(). process_data() will read all gpx files from this folder and plot_3D() will plot them all. It is however recommended to PLACE ONLY ONE GPX file within the folder. If the tracks cover an extended area plot_3D() can slow down significantly. If tracklog_folder is undefined plot_3D() loads an example tracklog provided with the package.

cache_folder

Directory to store the downloaded elevation data and overlay image for reuse

elevation_scale

Horizontal vs vertical ratio of the plot. Could be estimated with geoviz::raster_zscale(dem).

elevation_scale_tracklog_corr

Raises elevation_scale for the tracklog by the specified percentage. Useful if tracklog occasionally disappears into the ground.

buffer_around_tracklog_km

Buffer distance around the tracklog in km. Scene is cut outside this.

render_high_quality

If set to TRUE the function downloads higher resolution elevation and overlay data. All steps are very time and resource consuming.

sunangle

The direction of the light source of the scene

sunaltitude

The angle, in degrees (as measured from the horizon) from which the light originates.

color_tracklog

Color of the tracklog on the scene.

color_background

Color of the scene's background.

water_detect

If set to TRUE rayshader will look for flat surfaces in the scene and render them in blue

Examples

## Not run: 
# Generate a built in demo by simply running
strava::plot_3D()

## End(Not run)

marcusvolz/strava documentation built on Jan. 12, 2024, 4:29 a.m.