sf | R Observatory

Overview

About

Maintained by Edzer PebesmaFirst published 2016-10-2672 releasesCRAN page ↗GitHub ↗

Support for simple feature access, a standardized way to encode and analyze spatial vector data. Binds to 'GDAL' doi:10.5281/zenodo.5884351 for reading and writing data, to 'GEOS' doi:10.5281/zenodo.11396894 for geometrical operations, and to 'PROJ' doi:10.5281/zenodo.5884394 for projection conversions and datum transformations. Uses by default the 's2' package for geometry operations on geodetic (long/lat degree) coordinates.

Install

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

install.packages("sf", 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("r-spatial/sf")

Development version from r-spatial/sf. 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-sf

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

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

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

Health

CRAN checks

1ERROR12NOTE

Failing flavors

NOTE r-devel-linux-x86_64-debian-clang
NOTE r-devel-linux-x86_64-debian-gcc
NOTE r-devel-linux-x86_64-fedora-clang
NOTE r-devel-linux-x86_64-fedora-gcc
NOTE r-devel-windows-x86_64
NOTE r-oldrel-macos-arm64
NOTE r-oldrel-macos-x86_64
NOTE r-oldrel-windows-x86_64
NOTE r-patched-linux-x86_64
NOTE r-release-linux-x86_64
NOTE r-release-macos-arm64
NOTE r-release-macos-x86_64
ERROR r-release-windows-x86_64

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

Code health

Yes

Tests · ratio 0.77

78.8%

Coverage · measured lines

100%

Documentation · exports

11

Dependencies · direct

Check history

ERROR2026-07-19
0 OK · 12 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
NOTE2026-06-08
2 OK · 10 NOTE · 0 WARNING · 0 ERROR · 1 FAILURE
ERROR2026-06-07
2 OK · 10 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
NOTE2026-05-02
6 OK · 7 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-04-25
4 OK · 7 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE

Show 5 earlier snapshots

NOTE2026-04-22
4 OK · 10 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-04-18
3 OK · 10 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
NOTE2026-04-11
4 OK · 10 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-04-09
3 OK · 10 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
NOTE2026-03-10
3 OK · 11 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMENoVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 95%
Documented parameters: 93%
Return-value docs: 64%
References docs: 1%

Downloads

5.7M

CRAN downloads in the past year

Rank #167 · ~15.6K/day · ~475.9K/mo

Releases R versions

Daily download trend is not available in this view yet.

334.8K30 days

1.1M90 days

5.7M1 year

Compare downloads with other packages →

Also on33K r2u163 autocran102.5K conda_forge888 c2d4u

Repository

GitHub ↗ r-spatial/sf

1,439Stars

301Forks

57Open issues

5Open PRs

8Releases

5,536Commits

128Contributors

rspatialgdalgeosprojr-packagerstats

5,536 commits · Last activity 2026-07-20 · +0.4% stars, 30d

Stars over time

2025-07-22 · 1,3652026-07-16 · 1,439

Repository practices

Upstream repositoryBeta

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

Checks run against github.com/r-spatial/sf on 2026-07-19.

Continuous integration (2)

GitHub Actionstic

Lint, format, editor (1)

RStudio project

Coverage (1)

Codecov

Governance and community (1)

Issue templates

Show all practices

Git structural (1)

.gitattributes

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

Dependencies

Declared dependencies

40 external dependencies (excludes base and recommended)

Depends (2)

R >= 4.1.0methods

Imports (10)

classInt DBIgraphicsgrDevicesgrids2statstoolsunitsutils

LinkingTo (1)

Rcpp

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

1,170direct

277indirect

and 1,123 more packages.

Code & Tests

Code Composition

R 21,047 (47%)C++ 10,109 (22%)Rd 6,232 (14%)Other 5,142 (11%)Vignettes 2,322 (5%)C 95 (0%)

Code characteristics

Object systems

S3375S4 method4

Cyclomatic complexity: 1.0 median / 71 max
Test cases: 239 / 0.77 per code line
System requirements: 4 external

Test coverage

Line coverage

79%

Expression

76.1%

Tests / Examples

78.8% / 56% ex

Functions

1242 151 exported

Complexity

2.9 avg / 71 max

Call network

1242 nodes / 1967 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

1242 functions

Function	Cyclo	Coverage
gdal_compressors exp	1	0%
gdal_create exp	1	0%
gdal_extract exp	1	0%
gdal_subdatasets exp	3	0%
gdal_write_mdim exp	1	0%
sf_proj_network exp	3	0%

People & History

People (14)

Maintainer (1)

Edzer Pebesma

Author, Maintainer

Authors (1)

Edzer Pebesma

Author, Maintainer

Contributors (13)

Dan Baston

Contributor · added in 0.8-0

Roger Bivand

Contributor

Ian Cook

Contributor

Alexandre Courtiol

Contributor · added in 1.1-1

Dewey Dunnington

Contributor · added in 1.0-0

Tim Keitt

Contributor

Robin Lovelace

Contributor

Kirill Müller

Contributor · added in 0.6-2

Show 5 more contributors

Jeroen Ooms

Contributor

Thomas Lin Pedersen

Contributor · added in 0.7-3

Etienne Racine

Contributor · added in 0.3-0

Michael Sumner

Contributor

Hadley Wickham

Contributor

Listed in earlier versions (2)

Kirill M<U+00FC>ller

no longer listed · 0.8-1

Kirill M\u00fcller

no longer listed · 0.9-0 to 1.1-1

Package Timeline

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

1.1-1Latest
2026-05-06 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
1.1-0
2026-02-24 · diff ↗
1.0-24
2026-01-13 · diff ↗
1.0-23
2025-11-28 · diff ↗
1.0-22
2025-11-10 · diff ↗
1.0-21
2025-05-15 · diff ↗
R
R 4.5.0 released · 2025-04-11
1.0-20
2025-03-24 · diff ↗
1.0-19
2024-11-05 · diff ↗
1.0-18
2024-10-11 · diff ↗
1.0-17
2024-09-06 · diff ↗
R
R 4.4.0 released · 2024-04-24
1.0-16
2024-03-25 · diff ↗
1.0-15
2023-12-18 · diff ↗
1.0-14
2023-07-11 · diff ↗

Show 67 earlier events

1.0-13
2023-05-24 · diff ↗
R
R 4.3.0 released · 2023-04-21
1.0-12
2023-03-20 · diff ↗
1.0-11
2023-03-15 · diff ↗
1.0-10
2023-03-12 · diff ↗
1.0-9
2022-11-08 · diff ↗
1.0-8
2022-07-14 · diff ↗
R
R 4.2.0 released · 2022-04-22
1.0-7
2022-03-07 · diff ↗
1.0-6
2022-02-04 · diff ↗
1.0-5
2021-12-17 · diff ↗
1.0-4
2021-11-14 · diff ↗
1.0-3
2021-10-07 · diff ↗
1.0-2
2021-07-26 · diff ↗
1.0-1
2021-06-29 · diff ↗
1.0-0
2021-06-09 · diff ↗
R
R 4.1.0 released · 2021-05-18
0.9-8
2021-03-17 · diff ↗
0.9-7
2021-01-06 · diff ↗
0.9-6
2020-09-13 · diff ↗
0.9-5
2020-07-14 · diff ↗
0.9-4
2020-06-13 · diff ↗
0.9-3
2020-05-04 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.9-2
2020-04-14 · diff ↗
0.9-1
2020-04-06 · diff ↗
0.9-0
2020-03-24 · diff ↗
0.8-1
2020-01-28 · diff ↗
0.8-0
2019-09-17 · diff ↗
0.7-7
2019-07-24 · diff ↗
0.7-6
2019-07-05 · diff ↗
0.7-5
2019-07-03 · diff ↗
0.7-4
2019-04-26 · diff ↗
R
R 3.6.0 released · 2019-04-26
0.7-3
2019-02-21 · diff ↗
0.7-2
2018-12-20 · diff ↗
0.7-1
2018-10-24 · diff ↗
0.7-0
2018-10-17 · diff ↗
0.6-3
2018-05-17 · diff ↗
0.6-2
2018-04-25 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.6-1
2018-03-22 · diff ↗
0.6-0
2018-01-06 · diff ↗
0.5-5
2017-10-31 · diff ↗
0.5-4
2017-08-28 · diff ↗
0.5-3
2017-07-30 · diff ↗
0.5-2
2017-07-12 · diff ↗
0.5-1
2017-06-23 · diff ↗
0.5-0
2017-06-15 · diff ↗
0.4-3
2017-05-15 · diff ↗
0.4-2
2017-05-05 · diff ↗
R
R 3.4.0 released · 2017-04-21
0.4-1
2017-03-28 · diff ↗
0.4-0
2017-03-21 · diff ↗
0.3-4
2017-02-06 · diff ↗
0.3-2
2017-02-04 · diff ↗
0.3-1
2017-01-31 · diff ↗
0.3-0
2017-01-28 · diff ↗
0.2-8
2017-01-05 · diff ↗
0.2-7
2016-12-07 · diff ↗
0.2-6
2016-12-06 · diff ↗
0.2-5
2016-11-24 · diff ↗
0.2-4
2016-11-22 · diff ↗
0.2-2
2016-10-31 · diff ↗
0.2-1
2016-10-27 · diff ↗
0.2-0
2016-10-26
R
R 3.3.0 released · 2016-05-03

Package metadata

First published: 2016-10-26
Total releases: 72 / 10 yrs
License: GPL-2 | MIT + file LICENSE OSI
Minimum R: ≥ 4.1.0
Download size: 9.4 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Appears in task views

Analysis of Spatial Data Handling and Analyzing Spatio-Temporal Data