futility

0.5

Interim Analysis of Operational Futility in Randomized Trials with Time-to-Event Endpoints and Fixed Follow-Up

0packages depend

2.5Kdownloads / year

–test coverage

13/13checks pass

Overview

About

Maintained by Michal JuraskaFirst published 2017-07-295 releasesCRAN page ↗GitHub ↗

Randomized clinical trials commonly follow participants for a time-to-event efficacy endpoint for a fixed period of time. Consequently, at the time when the last enrolled participant completes their follow-up, the number of observed endpoints is a random variable. Assuming data collected through an interim timepoint, simulation-based estimation and inferential procedures in the standard right-censored failure time analysis framework are conducted for the distribution of the number of endpoints--in total as well as by treatment arm--at the end of the follow-up period. The future (i.e., yet unobserved) enrollment, endpoint, and dropout times are generated according to mechanisms specified in the simTrial() function in the 'seqDesign' package. A Bayesian model for the endpoint rate, offering the option to specify a robust mixture prior distribution, is used for generating future data (see the vignette for details). Inference can be restricted to participants who received treatment according to the protocol and are observed to be at risk for the endpoint at a specified timepoint. Plotting functions are provided for graphical display of results.

Install

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

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

Development version from mjuraska/futility. 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-futility

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

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

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

Health

CRAN checks

13OK

Slowest check: 2.3 min · r-oldrel-macos-x86_64

Code health

None

Tests · ratio 0.00

not tracked

Coverage

100%

Documentation · exports

Yes

Vignettes

Yes

README

Dependencies · direct

Check history

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

Downloads

2.5K

CRAN downloads in the past year

Rank #20,092 · ~7/day · ~206/mo

Releases R versions

Daily download trend is not available in this view yet.

20330 days

59490 days

2.5K1 year

Compare downloads with other packages →

Also on109 r2u21 autocran

Repository

GitHub ↗ mjuraska/futility

1Stars

0Forks

0Open issues

0Open PRs

0Releases

20Commits

1Contributors

20 commits · Last activity 2026-02-16

Stars over time

2019-02-02 · 12026-07-07 · 1

Dependencies

Declared dependencies

2 external dependencies (excludes base and recommended)

Depends (0)

none

Imports (3)

graphicsstatsutils

LinkingTo (0)

none

Suggests (2)

knitr rmarkdown

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

0direct

0indirect

Nothing depends on this yet.

Code & Tests

Code Composition

R 1,848 (76%)Rd 437 (18%)Vignettes 94 (4%)Other 40 (2%)

Code characteristics

Cyclomatic complexity: 18.5 median / 74 max
Documented parameters: 100%

Test coverage

Line coverage

–

Expression

–

Tests / Examples

–

Functions

10 4 exported

Complexity

19.5 avg / 74 max

Call network

10 nodes / 8 edges

Test coverage has not been measured for this package yet; nodes fall back to a neutral fill.

Call graph

Open call graph →

Loading call graph…

Lowest coverage

Per-function coverage is not measured for this package yet.

People & History

People (7)

Maintainer (1)

Michal Juraska

Author, Maintainer

Authors (2)

Michal Juraska

Author, Maintainer

Yingying Zhuang

Author

Contributors (5)

Contributor

Contributor

Contributor

Contributor

Contributor

Release 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
0.5Latest
2026-02-17 · current release · diff ↗
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
R
R 4.3.0 released · 2023-04-21
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
R
R 4.0.0 released · 2020-04-24
R
R 3.6.0 released · 2019-04-26
0.4
2019-04-11 · diff ↗
0.3
2019-02-07 · diff ↗
R
R 3.5.0 released · 2018-04-23
0.2
2017-11-22 · diff ↗
0.1
2017-07-29
R
R 3.4.0 released · 2017-04-21

Package metadata

First published: 2017-07-29
Total releases: 5 / 9 yrs
License: GPL-2 OSI
Download size: 188 KB
Installed size: not tracked yet
With dependencies: not tracked yet