Package: windscape 2.0.0

Matthew Kling

windscape: Model Landscape Connectivity by Wind

Model landscape connectivity by wind for ecological and evolutionary analyses. Summarize long time series of gridded wind data, downloaded from reanalyses or supplied by the user, into wind roses describing directional conductance between neighboring grid cells. Model dispersal through them with least-cost path and random walk algorithms, to map windsheds around sites and estimate pairwise connectivity among them, test hypotheses relating wind to ecological data, and visualize wind and connectivity with 'ggplot2'. The approach builds on Kling and Ackerly (2020) <doi:10.1038/s41558-020-0848-3> and Kling and Ackerly (2021) <doi:10.1073/pnas.2017317118>.

Authors:Matthew Kling [aut, cre, cph]

windscape_2.0.0.tar.gz
windscape_2.0.0.zip(r-4.7-x86_64)windscape_2.0.0.zip(r-4.7-arm64)windscape_2.0.0.zip(r-4.6-x86_64)windscape_2.0.0.zip(r-4.6-arm64)
windscape_2.0.0.tar.gz(r-4.7-arm64)windscape_2.0.0.tar.gz(r-4.7-x86_64)windscape_2.0.0.tar.gz(r-4.6-arm64)windscape_2.0.0.tar.gz(r-4.6-x86_64)
windscape_2.0.0.tgz(r-4.6-emscripten)
manual.pdf |manual.html✨
DESCRIPTION |NEWS
card.svg |card.png
windscape/json (API)

# Install 'windscape' in R:

install.packages('windscape', repos = c('https://cran.r-universe.dev', 'https://cloud.r-project.org'))

Bug tracker:https://github.com/matthewkling/windscape/issues

Pkgdown/docs site:https://matthewkling.github.io

Uses libs:

c++– GNU Standard C++ Library v3

Datasets:

birch - Silver birch landscape genetic data from Tsuda et al.

On CRAN:

cpp

2.70 score 58 exports 28 dependencies

Last updated from:3e96992352. Checks:10 OK. Indexed: yes.

Target	Result	Time
linux-devel-arm64	OK	367
linux-devel-x86_64	OK	404
source / vignettes	OK	340
linux-release-arm64	OK	374
linux-release-x86_64	OK	476
windows-devel-arm64	OK	574
windows-devel-x86_64	OK	426
windows-release-arm64	OK	473
windows-release-x86_64	OK	399
wasm-release	OK	157

Exports:aggregate cell_distance check_cell_distance combine_roses disagg download_land_mask download_wind_data download_wind_rose downscale generate_particles geoCorrection geom_wind_arrow geom_wind_path geom_wind_rose geom_wind_trail GeomWindArrow GeomWindRose GeomWindTrail iter_length least_cost least_cost_paths mantel_test mean net_flow pairwise_least_cost pairwise_means pairwise_random_walk pairwise_ratios point_distance project random_walk random_walk_paths resample rw_exit_prob rw_max_step rw_self_retention scale_color_bearing scale_colour_bearing scale_fill_bearing stat_wind_arrow stat_wind_rose stat_wind_trail StatWindArrow StatWindRose StatWindTrail subset subset_series weight_conductance wind_field wind_graph wind_rose wind_rose_cache wind_rose_catalog wind_series wind_times wind_trails windscape_example ws_summarize

Dependencies:cli cpp11 farver gdistance geosphere ggplot2 glue gtable igraph isoband labeling lattice lifecycle magrittr Matrix pkgconfig R6 raster RColorBrewer Rcpp rlang S7 scales sp terra vctrs viridisLite withr

Getting started with windscape

Rendered fromwindscape.Rmdusingknitr::rmarkdown

Last update: 2026-10-27
Started: 2026-10-27

Help page	Topics
Silver birch landscape genetic data from Tsuda et al. (2017)	birch
Pairwise distances between cell centroids	cell_distance
Check how grid cells distort distances among sites	check_cell_distance
Combine wind roses built from different time periods	combine_roses
Download a land-water layer from NCAR	download_land_mask
Download hourly wind data from NCAR	download_wind_data
Download a pre-built wind rose	download_wind_rose
Downscale a wind rose to higher spatial resolution	downscale
Convert windscape objects to data frames for ggplot2	fortify.random_walk fortify.windscape fortify.wind_field fortify.wind_rose fortify.wind_series
Generate initial particle locations	generate_particles
geoCorrection is not applicable to wind graphs	geoCorrection,wind_graph,ANY-method
Wind field arrows	GeomWindArrow geom_wind_arrow StatWindArrow stat_wind_arrow
Draw existing wind trails or paths	geom_wind_path
Wind rose glyphs: a map of local wind roses	GeomWindRose geom_wind_rose StatWindRose stat_wind_rose
Wind trails and streamlines	GeomWindTrail geom_wind_trail StatWindTrail stat_wind_trail
Iteration step length of a random walk	iter_length
Least-cost travel time surface	least_cost
Least-cost paths	least_cost_paths
Mantel test	mantel_test
Mean wind of a wind_series	mean,wind_series-method
Net flow of a wind rose, as a wind field	net_flow
Pairwise least-cost travel times among sites	pairwise_least_cost
Convert asymmetric pairwise matrix to symmetrical pairwise means	pairwise_means
Pairwise random walk connectivity among sites	pairwise_random_walk
Convert asymmetric pairwise matrix to reciprocally symmetrical matrix	pairwise_ratios
Pairwise distances between points	point_distance
Simulate wind dispersal by random walk	random_walk
Paths of material through a random walk	random_walk_paths
Probability of exiting a random walk's domain	rw_exit_prob
Maximum iteration duration for a random walk	rw_max_step
Self-contribution of each source cell in a stream-mode random walk	rw_self_retention
Color scales for wind direction	scale_color_bearing scale_colour_bearing scale_fill_bearing
Select time steps from a wind_series	subset_series
Weight a wind rose's conductances	weight_conductance
Create a wind_field	wind_field
An S4 object class representing a wind field	wind_field-class
Build a wind connectivity graph	build_wind_graph wind_graph
An S4 object class representing a wind graph	wind_graph-class
Build or load a wind rose	windrose_rasters wind_rose
Manage the wind rose download cache	wind_rose_cache
Catalog of pre-built wind roses	wind_rose_catalog
An S4 object class representing a wind rose	wind_rose-class
Changing the grid of a wind rose	aggregate,wind_rose-method disagg,wind_rose-method project,wind_rose-method resample,wind_rose,ANY-method wind_rose-grid
Create a wind_series	wind_series
An S4 object class representing a wind field time series	wind_series-class
Get the time of each step in a wind_series	wind_times
Trace particle trails through a wind field	wind_trails
Example wind data sets	windscape_example
Selecting and combining layers of windscape objects	c,wind_field-method c,wind_rose-method c,wind_series-method subset,wind_field-method subset,wind_rose-method subset,wind_series-method windscape-layers [[,wind_field,ANY,ANY-method [[,wind_rose,ANY,ANY-method [[,wind_series,ANY,ANY-method
Summary statistics for a windshed	ws_summarize

Package: windscape 2.0.0

windscape: Model Landscape Connectivity by Wind

Citation

Readme and manuals

Help Manual

Usage by other packages (reverse dependencies)