R Observatory: Metrics for roads version 1.2.1

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

CRAN requires the check problems on this package to be fixed before 2026-08-21 or it will be archived.

roads

1.2.1

Road Network Projection

0packages depend

5Kdownloads / year

73.7%test coverage

13/13checks pass

Overview

About

Maintained by Josie HughesFirst published 2022-06-225 releasesCRAN page ↗GitHub ↗

Iterative least cost path and minimum spanning tree methods for projecting forest road networks. The methods connect a set of target points to an existing road network using 'igraph' https://igraph.org to identify least cost routes. The cost of constructing a road segment between adjacent pixels is determined by a user supplied weight raster and a weight function; options include the average of adjacent weight raster values, and a function of the elevation differences between adjacent cells that penalizes steep grades. These road network projection methods are intended for integration into R workflows and modelling frameworks used for forecasting forest change, and can be applied over multiple time-steps without rebuilding a graph at each time-step.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("roads", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("LandSciTech/roads")

Development version from LandSciTech/roads. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-roads

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-roads

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-roads

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 8.4 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.33

73.7%

Coverage · measured lines

100%

Documentation · exports

9

Dependencies · direct

Check history

OK2026-08-05
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
NOTE2026-08-01
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 390 wordsVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 87%
Return-value docs: 78%
References docs: 15%

Downloads

5K

CRAN downloads in the past year

Rank #6,783 · ~14/day · ~415/mo

Releases R versions

Daily download trend is not available in this view yet.

25330 days

1.2K90 days

5K1 year

Compare downloads with other packages →

Also on136 r2u21 autocran

Repository

GitHub ↗ landscitech/roads

5Stars

3Forks

2Open issues

0Open PRs

4Releases

481Commits

7Contributors

481 commits · Last activity 2026-08-11

Stars over time

2025-05-14 · 52026-07-07 · 5

Repository practices

Upstream repositoryBeta

5 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/landscitech/roads on 2026-08-16.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Automation and maintenance (1)

pre-commit

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

14 external dependencies (excludes base and recommended)

Depends (1)

R >= 2.10

Imports (9)

dplyr igraph data.table sf units rlangmethodstidyselect terra

LinkingTo (0)

none

Suggests (6)

testthat knitr rmarkdown viridis bench gdistance

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Datasets

People & History

People (6)

Maintainer (1)

Josie Hughes

Author, Maintainer

Authors (4)

Author, Maintainer

Author

Author

Author

Copyright holders (2)

Her Majesty the Queen in Right of Canada as represented by the Minister of the Environment

Copyright holder

Province of British Columbia

Copyright holder

Package Timeline

5 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.2.1Latest
2026-01-16 · current release · diff ↗
R
R 4.5.0 released · 2025-04-11
1.2.0
2024-06-27 · diff ↗
R
R 4.4.0 released · 2024-04-24
1.1.1
2023-06-24 · diff ↗
R
R 4.3.0 released · 2023-04-21
1.1.0
2023-02-02 · diff ↗
unarchivedReturned to CRAN
2023-02-02
archivedRemoved from CRAN
2022-11-09
requires archived package 'Require'
1.0.0
2022-06-22
R
R 4.2.0 released · 2022-04-22

Package metadata

First published: 2022-06-22
Total releases: 5 / 4 yrs
License: Apache License (>= 2)
Minimum R: ≥ 2.10
Bundled data: 803 KB / 3 files
Download size: 1.4 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("roads")

Format

Hughes, J., Her Majesty the Queen in Right of Canada as represented by the Minister of the Environment, Province of British Columbia, Endicott, S., Kirby, P., & Lochhead, K. (2026). roads: Road Network Projection (Version 1.2.1) [Computer software]. https://doi.org/10.32614/CRAN.package.roads

This is what citation() produces when a package has no citation file of its own. If it prints something else, use that.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

Format

APA

Balamuta, J. J. (2026). R Observatory: Metrics for roads version 1.2.1 [Data set]. HJJB, LLC. Data release v2026-08-21. https://doi.org/10.5281/zenodo.21843040

From data release v2026-08-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →