viewscape

3.0.0

Viewscape Analysis

0packages depend

2.7Kdownloads / year

66.2%test coverage

12/13checks pass

Overview

About

Maintained by Xiaohao YangFirst published 2024-02-045 releasesCRAN page ↗GitHub ↗

Provides tools for viewscape analysis from one or multiple viewpoints using a digital surface or elevation model. Core functionality includes computing viewsheds, quantifying visual magnitude, calculating a suite of viewscape configuration metrics (extent, depth, relief, Sky View Factor, skyline variation, and patch-based landscape structure), Shannon Diversity Index and land cover feature proportions within the visible area, pairwise intervisibility networks, panoramic view generation, and visualizing results as rasters or polygons. Viewscape configuration metrics follow the methods of Tabrizian et al. (2020) doi:10.1016/j.landurbplan.2019.103704. The viewshed algorithm is based on Franklin & Ray (1994) https://api.semanticscholar.org/CorpusID:10680920 and Wang et al. (2000) https://api.semanticscholar.org/CorpusID:131687018. Visual magnitude is derived from Chamberlain & Meitner (2013) doi:10.1016/j.landurbplan.2013.01.003. Sky View Factor is computed following Oke (1981) doi:10.1002/joc.3370010304 as implemented in the 'shadow' package (Dorman et al. 2019) doi:10.32614/RJ-2019-024.

Install

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

install.packages("viewscape", 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("billbillbilly/viewscape")

Development version from billbillbilly/viewscape. 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-viewscape

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-viewscape

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

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

Health

CRAN checks

1NOTE12OK

Failing flavors

NOTE r-devel-linux-x86_64-debian-gcc

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

Code health

Yes

Tests · ratio 0.24

66.2%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

NOTE2026-08-01
12 OK · 1 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
OK2026-04-22
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-04-18
13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-28
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-03-21
13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE

Show 1 earlier snapshots

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMENoVignettesYes · staticpkgdown siteNoNEWSNoCode of conductNoContributing guideNo

Examples that run: 56%
Documented parameters: 100%
Return-value docs: 100%
References docs: 30%

Downloads

2.7K

CRAN downloads in the past year

Rank #12,814 · ~7/day · ~224/mo

Releases R versions

Daily download trend is not available in this view yet.

33330 days

79590 days

2.7K1 year

Compare downloads with other packages →

Also on415 r2u

Repository

GitHub ↗ billbillbilly/viewscape

0Stars

1Forks

0Open issues

0Open PRs

0Releases

355Commits

2Contributors

License GPL-3.0 · 355 commits · Last activity 2026-07-13

Forks over time

2026-07-07 · 02026-07-24 · 1

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/billbillbilly/viewscape on 2026-07-30.

Continuous integration (1)

GitHub Actions

Docs source (1)

README.Rmd

Research and citation (1)

codemeta.json

Lint, format, editor (1)

RStudio project

Show all practices

Coverage (1)

Codecov

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

Dependencies

Declared dependencies

14 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.2

Imports (10)

Rcpp rlangmethodsdplyr sf sp terra ForestTools (>= 1.0.1)parallelpbmcapply

LinkingTo (1)

Rcpp

Suggests (5)

testthat knitr rmarkdown greenSD dsmSearch

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

People & History

People (4)

Maintainer (1)

Xiaohao Yang

Author, Maintainer, Copyright holder

Authors (4)

Xiaohao Yang

Author, Maintainer, Copyright holder

Author

Author

Author

Author, Maintainer, Copyright holder

Package Timeline

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

3.0.0Latest
2026-06-27 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
R
R 4.5.0 released · 2025-04-11
2.0.2
2024-12-19 · diff ↗
2.0.1
2024-11-11 · diff ↗
2.0.0
2024-11-09 · diff ↗
R
R 4.4.0 released · 2024-04-24
1.0.0
2024-02-04
R
R 4.3.0 released · 2023-04-21

Package metadata

First published: 2024-02-04
Total releases: 5 / 2 yrs
License: GPL-3 OSI
Minimum R: ≥ 4.2
Download size: 2.3 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →