R Observatory: Metrics for Surrogate version 3.4.2

Balamuta, James Joseph

doi:10.5281/zenodo.21843040

Surrogate

3.4.2

Evaluation of Surrogate Endpoints in Clinical Trials

0packages depend

8.4Kdownloads / year

16.0%test coverage

13/13checks pass

Overview

About

Maintained by Wim Van Der ElstFirst published 2014-03-1964 releasesCRAN page ↗GitHub ↗

In a clinical trial, it frequently occurs that the most credible outcome to evaluate the effectiveness of a new therapy (the true endpoint) is difficult to measure. In such a situation, it can be an effective strategy to replace the true endpoint by a (bio)marker that is easier to measure and that allows for a prediction of the treatment effect on the true endpoint (a surrogate endpoint). The package 'Surrogate' allows for an evaluation of the appropriateness of a candidate surrogate endpoint based on the meta-analytic, information-theoretic, and causal-inference frameworks. Part of this software has been developed using funding provided from the European Union's Seventh Framework Programme for research, technological development and demonstration (Grant Agreement no 602552), the Special Research Fund (BOF) of Hasselt University (BOF-number: BOF2OCPO3), GlaxoSmithKline Biologicals, Baekeland Mandaat (HBC.2022.0145), and Johnson & Johnson Innovative Medicine.

Install

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

install.packages("Surrogate", 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("florianstijven/Surrogate-development")

Development version from florianstijven/Surrogate-development. 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-surrogate

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

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

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

Health

CRAN checks

13OK

Slowest check: 14.9 min · r-devel-windows-x86_64

Code health

Yes

Tests · ratio 0.29

16.0%

Coverage · measured lines

100%

Documentation · exports

23

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-06-09
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE
ERROR2026-06-08
12 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE
OK2026-05-02
13 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Show 1 earlier snapshots

ERROR2026-03-10
13 OK · 0 NOTE · 0 WARNING · 1 ERROR · 0 FAILURE

Documentation

READMEYes · 172 wordsVignettesNopkgdown siteNoNEWSYes · 67% structuredCode of conductNoContributing guideNo

Examples that run: 50%
Documented parameters: 82%
Return-value docs: 75%
References docs: 52%

Downloads

8.4K

CRAN downloads in the past year

Rank #4,768 · ~23/day · ~703/mo

Releases R versions

Daily download trend is not available in this view yet.

32230 days

1.7K90 days

8.4K1 year

Compare downloads with other packages →

Also on151 r2u

Repository

GitHub ↗ florianstijven/surrogate-development

1Stars

4Forks

3Open issues

0Open PRs

13Releases

415Commits

4Contributors

415 commits · Last activity 2026-06-04

Stars over time

2024-02-24 · 12026-07-07 · 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/florianstijven/surrogate-development on 2026-08-09.

Continuous integration (1)

GitHub Actions

Reproducibility and dev environment (1)

renv

CRAN release process (1)

cran-comments.md

Docs source (1)

README.Rmd

Show all practices

Lint, format, editor (1)

RStudio project

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

Dependencies

Declared dependencies

31 external dependencies (excludes base and recommended)

Depends (1)

R >= 3.5.0

Imports (23)

MASSlatticelatticeExtrasurvivalnlmelme4 logistf rms ks extraDistr pbapply flexsurv rvinecopulib maxLik purrr MBESS tidyr dplyr tibble lifecycle fastmatrix mratiosMatrix

LinkingTo (0)

none

Suggests (15)

copula FNNmgcvtestthat vdiffrparallelfitdistrplus kdecopula cubature mvtnorm withr stringr ggplot2 sn pracma

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Datasets

People & History

People (11)

Maintainer (1)

Wim Van Der Elst

Maintainer, Author

Authors (11)

Wim Van Der Elst

Maintainer, Author

Ariel Alonso

Author · added in 0.1-68

Dries De Witte

Author · added in 3.3.0

Gokce Deliorman

Author · added in 3.4.0

Hannah Ensor

Author · added in 3.2.0

Paul Meyvisch

Author · added in 0.1-66

Geert Molenberghs

Author · added in 3.2.0

Fenny Ong

Author · added in 2.1

Alvaro Poveda

Author · added in 3.2.0

Florian Stijven

Author · added in 2.5

Christoper Weir

Author · added in 3.2.0

Listed in earlier versions (5)

Ariel Alonso & Geert Molenbergs

no longer listed · 0.1-0

Ariel Alonso & Geert Molenberghs

no longer listed · 0.1-1 to 0.1-67

Hannah M. Ensor

no longer listed · 0.1-68 to 3.1

Christopher J. Weir & Geert Molenberghs

no longer listed · 0.1-68 to 3.1

Alvaro Florez Poveda

no longer listed · 1.0 to 3.1

Package Timeline

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

3.4.2Latest
2026-06-03 · current release · diff ↗
R
R 4.6.0 released · 2026-04-24
3.4.1
2025-04-29 · diff ↗
R
R 4.5.0 released · 2025-04-11
3.4.0
2025-04-09 · diff ↗
3.3.3
2025-02-12 · diff ↗
unarchivedReturned to CRAN
2025-02-12
archivedRemoved from CRAN
2025-02-07
issues were not corrected in time
3.3.1
2025-01-23 · diff ↗
3.3.0
2024-06-12 · diff ↗
3.2.6
2024-05-27 · diff ↗
R
R 4.4.0 released · 2024-04-24
3.2.5
2024-03-19 · diff ↗
3.2.4
2024-02-29 · diff ↗
3.2.2
2024-02-20 · diff ↗
3.2.1
2023-09-25 · diff ↗

Show 64 earlier events

3.2.0
2023-09-06 · diff ↗
3.1
2023-09-01 · diff ↗
3.0
2023-06-22 · diff ↗
R
R 4.3.0 released · 2023-04-21
2.8
2023-03-07 · diff ↗
2.7
2023-02-13 · diff ↗
2.6
2023-01-22 · diff ↗
2.5
2022-11-30 · diff ↗
2.4
2022-08-13 · diff ↗
2.3
2022-07-08 · diff ↗
2.2
2022-06-18 · diff ↗
2.1
2022-06-08 · diff ↗
R
R 4.2.0 released · 2022-04-22
2.0
2021-09-28 · diff ↗
1.9
2021-07-06 · diff ↗
R
R 4.1.0 released · 2021-05-18
1.8
2020-12-13 · diff ↗
R
R 4.0.0 released · 2020-04-24
1.7
2020-03-23 · diff ↗
1.6
2020-01-29 · diff ↗
1.5
2019-12-06 · diff ↗
1.4
2019-10-26 · diff ↗
1.3
2019-09-22 · diff ↗
R
R 3.6.0 released · 2019-04-26
1.2
2019-02-06 · diff ↗
1.1
2018-10-18 · diff ↗
1.0
2018-10-10 · diff ↗
0.9
2018-06-09 · diff ↗
0.8
2018-06-02 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.7
2018-04-20 · diff ↗
0.6
2018-01-20 · diff ↗
0.5
2017-10-08 · diff ↗
0.4
2017-08-18 · diff ↗
0.2
2017-06-05 · diff ↗
R
R 3.4.0 released · 2017-04-21
0.1-801
2017-03-05 · diff ↗
0.1-79
2016-10-28 · diff ↗
0.1-77
2016-10-01 · diff ↗
0.1-76
2016-09-24 · diff ↗
0.1-75
2016-09-03 · diff ↗
0.1-74
2016-07-27 · diff ↗
0.1-73
2016-05-16 · diff ↗
R
R 3.3.0 released · 2016-05-03
0.1-72
2016-04-23 · diff ↗
0.1-71
2016-04-01 · diff ↗
0.1-69
2016-03-18 · diff ↗
0.1-68
2016-02-21 · diff ↗
0.1-67
2016-02-05 · diff ↗
0.1-66
2016-01-23 · diff ↗
0.1-64
2015-11-21 · diff ↗
0.1-63
2015-10-10 · diff ↗
0.1-62
2015-08-25 · diff ↗
0.1-61
2015-06-11 · diff ↗
0.1-6
2015-05-15 · diff ↗
R
R 3.2.0 released · 2015-04-16
0.1-5
2015-03-26 · diff ↗
0.1-4
2014-12-12 · diff ↗
0.1-3
2014-10-25 · diff ↗
0.1-2
2014-07-30 · diff ↗
0.1-1
2014-05-12 · diff ↗
R
R 3.1.0 released · 2014-04-10
0.1-0
2014-03-19
R
R 3.0.0 released · 2013-04-03

Package metadata

First published: 2014-03-19
Total releases: 64 / 12 yrs
License: GPL (>= 2) OSI
Minimum R: ≥ 3.5.0
Bundled data: 146 KB / 12 files
Download size: 3.7 MB for 3.4.1
Installed size: not tracked yet
With dependencies: not tracked yet

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("Surrogate")

Format

Van Der Elst, W., Alonso, A., De Witte, D., Deliorman, G., Ensor, H., Meyvisch, P., Molenberghs, G., Ong, F., Poveda, A., Stijven, F., & Weir, C. (2026). Surrogate: Evaluation of Surrogate Endpoints in Clinical Trials (Version 3.4.2) [Computer software]. https://doi.org/10.32614/CRAN.package.Surrogate

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 Surrogate version 3.4.2 [Data set]. HJJB, LLC. Data release v2026-08-15. https://doi.org/10.5281/zenodo.21843040

From data release v2026-08-15, 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 →