Learn R Programming

simIDM (version 0.1.0)

Simulating Oncology Trials using an Illness-Death Model

Description

Based on the illness-death model a large number of clinical trials with oncology endpoints progression-free survival (PFS) and overall survival (OS) can be simulated, see Meller, Beyersmann and Rufibach (2019) . The simulation set-up allows for random and event-driven censoring, an arbitrary number of treatment arms, staggered study entry and drop-out. Exponentially, Weibull and piecewise exponentially distributed survival times can be generated. The correlation between PFS and OS can be calculated.

Copy Link

Version

Install

install.packages('simIDM')

Monthly Downloads

202

Version

0.1.0

License

Apache License 2.0

Issues

Pull Requests

Stars

Forks

Maintainer

Alexandra Erdmann

Last Published

December 11th, 2023

Functions in simIDM (0.1.0)

ExpSurvOS

OS Survival Function from Constant Transition Hazards
PWCsurvPFS

PFS Survival Function from Piecewise Constant Hazards
ExpQuantOS

Quantile function for OS survival function induced by an illness-death model
PCWInversionMethod

Single Piecewise Exponentially Distributed Event Time
PWCsurvOS

OS Survival Function from Piecewise Constant Hazards
PFSOSInteg

Helper Function for survPFSOS()
assert_positive_number

Assertion for Positive Number
addStaggeredEntry

Staggered Study Entry
getCensoredData

Helper function for censoringByNumberEvents
avgHRIntegExpOS

Helper Function for avgHRExpOS()
WeibSurvOS

OS Survival Function from Weibull Transition Hazards
getClinicalTrials

Simulation of a Large Number of Oncology Clinical Trials
assert_intervals

Assertion for vector describing intervals
avgHRExpOS

Average OS Hazard Ratio from Constant Transition Hazards
ExpSurvPFS

PFS Survival Function from Constant Transition Hazards
expvalPFSInteg

Helper Function for Computing E(PFS^2)
expvalOSInteg

Helper Function for Computing E(OS^2)
WeibSurvPFS

PFS Survival Function from Weibull Transition Hazards
censoringByNumberEvents

Event-driven censoring.
getDatasetWideFormat

Conversion of a Data Set from One Row per Transition to One Row per Patient
WeibOSInteg

Helper Function for WeibSurvOS()
exponential_transition

Transition Hazards for Exponential Event Times
corPFSOS

Correlation of PFS and OS event times for data from the IDM
getTarget

Generate the Target Function for Optimization
haz

Hazard Function for Different Transition Models
pwA

Cumulative Hazard for Piecewise Constant Hazards
getTimePoint

Time-point by which a specified number of events occurred.
runTrial

Helper Function for Adding Progress Bar to Trial Simulation
corTrans

Correlation of PFS and OS event times for Different Transition Models
empSignificant

Empirical Significance for a List of Simulated Trials
getWaitTimeSum

Event Times Distributed as Sum of Weibull
getNumberEvents

Helper Function for trackEventsPerTrial
estimateParams

Estimate Parameters of the Multistate Model Using Clinical Trial Data
getPWCHazard

Piecewise Constant Hazard Values
getSimulatedData

Simulate Data Set from an Illness-Death Model
simIDM-package

simIDM Package
p11Integ

Helper Function for log_p11()
singleExpQuantOS

Helper Function for Single Quantile for OS Survival Function
getOneClinicalTrial

Simulation of a Single Oncology Clinical Trial
piecewise_exponential

Transition Hazards for Piecewise Exponential Event Times
log_p11

Probability of Remaining in Progression Between Two Time Points for Different Transition Models
getSumPCW

Sum of Two Piecewise Constant Hazards
passedLogRank

Helper function to conduct log-rank tests for either PFS or OS
getResults

Format Results of Parameter Estimation for Different Transition Models
negLogLik

Compute the Negative Log-Likelihood for a Given Data Set and Transition Model
getInit

Retrieve Initial Parameter Vectors for Likelihood Maximization
getEventsAll

Number of recruited/censored/ongoing Patients.
getOneToTwoRows

Transitions from the Intermediate State to the Absorbing State
integrateVector

Helper for Efficient Integration
prepareData

Preparation of a Data Set to Compute Log-likelihood
trackEventsPerTrial

Event tracking in an oncology trial.
getPCWDistr

Piecewise Exponentially Distributed Event Times
survOS

OS Survival Function for Different Transition Models
logRankTest

Log-Rank Test for a Single Trial
survPFSOS

Survival Function of the Product PFS*OS for Different Transition Models
survPFS

PFS Survival Function for Different Transition Models
survTrans

Survival Function for Different Transition Models
weibull_transition

Transition Hazards for Weibull Distributed Event Times
PwcOSInt

Helper Function of PWCsurvOS()
ExpHazOS

OS Hazard Function from Constant Transition Hazards