tidyterra

1.2.0

'tidyverse' Methods and 'ggplot2' Helpers for 'terra' Objects

42packages depend

205Kdownloads / year

99.7%test coverage

13/13checks pass

Overview

About

Maintained by Diego HernangómezFirst published 2022-05-2420 releasesCRAN page ↗GitHub ↗

Provides methods from 'tidyverse' packages for 'SpatRaster' and 'SpatVector' objects created with 'terra', plus 'ggplot2' 'geoms' and scales for plotting those objects.

Install

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

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

Development version from dieghernan/tidyterra. 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-tidyterra

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

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

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

Health

CRAN checks

13OK

Slowest check: 15.2 min · r-devel-linux-x86_64-fedora-clang

Code health

Yes

Tests · ratio 1.21

99.7%

Coverage · measured lines

99%

Documentation · exports

Dependencies · direct

Check history

OK2026-07-04
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-07-01
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-06-29
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-25
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Show 4 earlier snapshots

WARNING2026-06-08
12 OK · 0 NOTE · 1 WARNING · 0 ERROR · 0 FAILURE
OK2026-03-21
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-03-18
13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMEYes · 812 wordsVignettesNopkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 74%
Documented parameters: 95%
Return-value docs: 96%
References docs: 3%

Downloads

205K

CRAN downloads in the past year

Rank #875 · ~562/day · ~17.1K/mo

Releases R versions

Daily download trend is not available in this view yet.

15.5K30 days

57.7K90 days

205K1 year

Compare downloads with other packages →

Also on873 r2u40 autocran38 c2d4u

Repository

GitHub ↗ dieghernan/tidyterra

218Stars

11Forks

4Open issues

1Open PRs

22Releases

733Commits

8Contributors

ggplot-extensionr-packager-spatialrspatialrstatsrstats-packageterracran

733 commits · Last activity 2026-07-20 · +0.9% stars, 30d

Stars over time

2025-06-21 · 1942026-07-07 · 218

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/dieghernan/tidyterra on 2026-07-19.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

data-raw/

CRAN release process (1)

revdep/

Docs source (1)

README.qmd

Show all practices

Research and citation (2)

CITATION.cffcodemeta.json

Automation and maintenance (1)

Dependabot

Lint, format, editor (4)

lintrAirVS CodeRStudio project

Governance and community (2)

Issue templatesSupport guide

Git structural (1)

.gitattributes

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

Dependencies

Declared dependencies

23 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.1.0

Imports (18)

cli data.table dplyr generics ggplot2grDevicesisoband lifecycle magrittr rlang scales sf terra tibble (>= 3.0.0)tidyrtoolsutilsvctrs

LinkingTo (0)

none

Suggests (8)

hexbin knitr maptiles quarto rmarkdown s2 stringi testthat

Enhances (0)

none

Dependency license breakdown →

Code & Tests

Code Composition

R 28,438 (66%)Rd 10,251 (24%)Markdown 3,029 (7%)Vignettes 746 (2%)Other 316 (1%)

Code characteristics

Object systems

S3109

Cyclomatic complexity: 1.0 median / 14 max
Test cases: 526 / 1.21 per code line

Test coverage

Line coverage

100%

Expression

99.5%

Tests / Examples

99.7% / 33% ex

Functions

282 89 exported

Complexity

2.2 avg / 14 max

Call network

282 nodes / 447 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

282 functions

Function	Cyclo	Coverage
get_crs_units	4	91%
warn_overlapping_layers	3	94%
get_coltab_pal exp	10	95%
check_regroups	11	96%
prepare_aes_spatraster	4	97%
bind_spat_rows exp	14	98%

Datasets

Bundled datasets · 4

Name	Class	Rows × Cols	Also ships in
cross_blended_hypsometric_tints_db	tbl_df/tbl/data.frame	41 × 6	–
grass_db	tbl_df/tbl/data.frame	2,920 × 6	–
hypsometric_tints_db	tbl_df/tbl/data.frame	1,102 × 6	–
princess_db	tbl_df/tbl/data.frame	75 × 5	–

2 internal objects are bundled for the package's own use and not listed here.

People & History

People (4)

Maintainer (1)

Diego Hernangómez

Author, Maintainer, Copyright holder

Authors (1)

Diego Hernangómez

Author, Maintainer, Copyright holder

Contributors (2)

Dewey Dunnington

Contributor

Andrea Manica

Contributor · added in 0.7.1

Diego Hernangómez

Author, Maintainer, Copyright holder

ggplot2 authors

Package Timeline

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

1.2.0Latest
2026-06-17 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
1.1.0
2026-03-11 · diff ↗
1.0.0
2026-01-23 · diff ↗
0.7.2
2025-04-14 · diff ↗
R
R 4.5.0 released · 2025-04-11
0.7.1
2025-04-07 · diff ↗
0.7.0
2025-02-03 · diff ↗
0.6.2
2025-01-08 · diff ↗
0.6.1
2024-06-08 · diff ↗
R
R 4.4.0 released · 2024-04-24
0.6.0
2024-04-23 · diff ↗
0.5.2
2024-01-19 · diff ↗
0.5.1
2023-12-15 · diff ↗
0.5.0
2023-11-22 · diff ↗
R
R 4.3.0 released · 2023-04-21

Show 11 earlier events

0.4.0
2023-03-17 · diff ↗
0.3.2
2023-02-24 · diff ↗
0.3.1
2022-11-09 · diff ↗
0.3.0
2022-10-12 · diff ↗
unarchivedReturned to CRAN
2022-10-12
archivedRemoved from CRAN
2022-10-07
issues were not corrected in time With startup messages
0.2.2
2022-09-29 · diff ↗
0.2.1
2022-09-23 · diff ↗
0.2.0
2022-06-21 · diff ↗
0.1.0
2022-05-24
R
R 4.2.0 released · 2022-04-22

Package metadata

First published: 2022-05-24
Total releases: 20 / 4 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Bundled data: 83 KB / 5 files
Download size: 1.9 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Analysis of Spatial Data

Report a problem with this page →