'WhiteboxTools' R Frontend
Overview
An R frontend for the 'WhiteboxTools' library, which is an advanced geospatial data analysis platform developed by Prof. John Lindsay at the University of Guelph's Geomorphometry and Hydrogeomatics Research Group. 'WhiteboxTools' can be used to perform common geographical information systems (GIS) analysis operations, such as cost-distance analysis, distance buffering, and raster reclassification. Remote sensing and image processing tasks include image enhancement (e.g. panchromatic sharpening, contrast adjustments), image mosaicing, numerous filtering operations, simple classification (k-means), and common image transformations. 'WhiteboxTools' also contains advanced tooling for spatial hydrological analysis (e.g. flow-accumulation, watershed delineation, stream network analysis, sink removal), terrain analysis (e.g. common terrain indices such as slope, curvatures, wetness index, hillshading; hypsometric analysis; multi-scale topographic position analysis), and LiDAR data processing. Suggested citation: Lindsay (2016) doi:10.1016/j.cageo.2016.07.003.
- Fix for CRAN check (#135)
- GeoTIFF DEM sample data (_extdata/DEM.tif_) previously excluded, along with all other TIFF files, by _.Rbuildignore_ is now explicitly included
- Fix for behavior of
sample_dem_data()destfileargument: - Errors thrown from invalid sources from new
wbt_source()(introduced in v2.4.2) revealed an underlying issue with sample data assets. Invalid source errors are now intentionally captured and tested, and inclusion of the extdata file should ensure other parts of tests work as expected - When
destfileunset and no local file present,sample_dem_data()no longer attempts to download and write to the user package library (**which is read-only on CRAN**) destfilenow intended for copying the sample dataset from package _extdata_ folder, for workflows that need the sample data outside of the package librarysample_soils_data()now supportsdestfile(just likesample_dem_data())
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-04
- NOTE12 OK, 1 NOTE2026-08-01
- OK12 OK, 1 FAILURE2026-06-08
- ERROR12 OK, 1 ERROR2026-06-07
- OK14 OK2026-03-10
Documentation
- Help pages
- 568 (1 internal)includes a package overview page
- Examples that run
- 14%2 run in a plain check · 12 never run
- Exported functions with examples
- 2%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
- `wbt()` and `wbt_result` HTML
- whitebox Demo HTML
- whitebox Tool Metadata HTML
Downloads
Repository
- PRs merged (all time)
- 95%
- Median days to close, 50 most recently updated closed issues
- 3
- Median days to close, 50 most recently updated closed PRs
- 0
Stars over time
Forks over time
Releases over time
Issues over time
PRs over time
Commit identities over time
13 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/opengeos/whiteboxr on 2026-10-18.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
The repository owner accepts GitHub Sponsors
GitHub Pages site last deployed 2025-10-21 · The repository has a site deploy workflow
Show all practicesHide 3 practices
This repository shows signs of AI coding tools.
- GitHub Copilotfirst seen 2025-10-18Pull request: opened by its own account
Dependencies
Installing whitebox adds no packages beyond those that come with R.
Code & Tests
Datasets
People & History
Previously maintained by Qiusheng Wu (0.1.0).
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 2.4.3Latest
- 2.4.2
- RR 4.5.0 released · 2025-04-11
- 2.4.02024-05-27 · diff ↗
- RR 4.4.0 released · 2024-04-24
- 2.3.4
- 2.3.1
- RR 4.3.0 released · 2023-04-21
- 2.3.02023-03-29 · diff ↗ ·
added 15 exports
wbt, wbt_data_dir, wbt_dem_void_filling, wbt_individual_tree_detection, wbt_install_wb_extension, wbt_launch_wb_runner, wbt_list_unique_values_raster, wbt_multiscale_curvatures, wbt_normalize_lidar, wbt_remove_raster_polygon_holes, wbt_result, wbt_river_centerlines, wbt_source, wbt_topo_render, whitebox.env - 2.2.02022-10-27 · diff ↗ ·
added 19 exports
wbt_breakline_mapping, wbt_classify_lidar, wbt_colourize_based_on_class, wbt_colourize_based_on_point_returns, wbt_conditioned_latin_hypercube, wbt_depth_to_water, wbt_filter_lidar, wbt_heat_map, wbt_high_pass_bilateral_filter, wbt_lidar_eigenvalue_features, wbt_max_upslope_value, wbt_modify_lidar, wbt_multiply_overlay, wbt_piecewise_contrast_stretch, wbt_recover_flightline_info, wbt_rust_backtrace, wbt_sort_lidar, wbt_split_lidar, wbt_travelling_salesman_problem - 2.1.5
- 2.1.42022-05-15 · diff ↗
- RR 4.2.0 released · 2022-04-22
- 2.1.22022-03-21 · diff ↗
- 2.1.1
Show 9 earlier eventsHide 9 earlier events
- 2.1.02022-02-11 · diff ↗ ·
removed 1 export
wbt_change_in_contributing_areaadded 31 exports
wbt_accumulation_curvature, wbt_curvedness, wbt_dbscan, wbt_difference_curvature, wbt_gaussian_curvature, wbt_gaussian_scale_space, wbt_generalize_classified_raster, wbt_generalize_with_similarity, wbt_generating_function, wbt_geomorphons, wbt_horizontal_excess_curvature, wbt_knn_classification, wbt_knn_regression, wbt_lidar_shift, wbt_local_hypsometric_analysis, wbt_local_quadratic_regression, wbt_logistic_regression, wbt_max_upslope_elev_change, wbt_maximal_curvature, wbt_mean_curvature, wbt_minimal_curvature, wbt_random_forest_classification, wbt_random_forest_regression, wbt_ring_curvature, wbt_rotor, wbt_shape_index, wbt_slope_vs_aspect_plot, wbt_svm_classification, wbt_svm_regression, wbt_unsphericity and 1 more - unarchivedReturned to CRAN2021-09-10
- 2.0.02021-09-10 · diff ↗ ·
removed 396 exports
absolute_value, adaptive_filter, add, add_point_coordinates_to_table, aggregate_raster, and, anova, arc_cos, arc_sin, arc_tan, aspect, atan2, attribute_correlation, attribute_histogram, attribute_scattergram, average_flowpath_slope, average_overlay, average_upslope_flowpath_length, balance_contrast_enhancement, basins, bilateral_filter, block_maximum_gridding, block_minimum_gridding, breach_depressions, breach_single_cell_pits, buffer_raster, ceil, centroid, centroid_vector, change_vector_analysis and 366 moreadded 496 exports
check_whitebox_binary, install_whitebox, wbt_absolute_value, wbt_adaptive_filter, wbt_add, wbt_add_point_coordinates_to_table, wbt_aggregate_raster, wbt_and, wbt_anova, wbt_arc_cos, wbt_arc_sin, wbt_arc_tan, wbt_arcosh, wbt_arsinh, wbt_artanh, wbt_ascii_to_las, wbt_aspect, wbt_assess_route, wbt_atan2, wbt_attribute_correlation, wbt_attribute_correlation_neighbourhood_analysis, wbt_attribute_histogram, wbt_attribute_scattergram, wbt_average_flowpath_slope, wbt_average_normal_vector_angular_deviation, wbt_average_overlay, wbt_average_upslope_flowpath_length, wbt_balance_contrast_enhancement, wbt_basins, wbt_bilateral_filter and 466 more - RR 4.1.0 released · 2021-05-18
- RR 4.0.0 released · 2020-04-24
- RR 3.6.0 released · 2019-04-26
- archivedRemoved from CRAN2019-02-08policy violation
- 0.1.02019-02-07
- RR 3.5.0 released · 2018-04-23
Package metadata
- First published
- 2019-02-07
- Total releases
- 14 / 7 yrs
- License
- MIT + file LICENSE OSI
- Minimum R
- ≥ 3.5
- Bundled data
- 78 KB / 2 files
- Download size
- 1.0 MB
Cite
Cite this package
Run in R for the authors' entry:
citation("whitebox")The package provides a citation file, so citation() returns the authors' own entry.
It points to 10.1016/j.cageo.2016.07.003.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.