An Introduction to Principal Surrogate Evaluation with the pseval Package

We describe a new package called pseval that implements the core methods for the evaluation of principal surrogates in a single clinical trial. It provides a flexible interface for defining models for the risk given treatment and the surrogate, the models for integration over the missing counterfactual surrogate responses, and the estimation methods. Estimated maximum likelihood and pseudo-score can be used for estimation, and the bootstrap for inference. A variety of post-estimation methods are provided, including print, summary, plot, and testing. We summarize the main statistical methods that are implemented in the package and illustrate its use from the perspective of a novice R user.

Michael C. Sachs , Erin E. Gabriel
2016-11-21

CRAN packages used

pseval, survival, survey, ggplot2, lattice, Surrogate

CRAN Task Views implied by cited packages

Graphics, SocialSciences, Survival, ClinicalTrials, Econometrics, Multivariate, OfficialStatistics, Pharmacokinetics, Phylogenetics

Reuse

Text and figures are licensed under Creative Commons Attribution CC BY 4.0. The figures that have been reused from other sources don't fall under this license and can be recognized by a note in their caption: "Figure from ...".

Citation

For attribution, please cite this work as

Sachs & Gabriel, "An Introduction to Principal Surrogate Evaluation with the pseval Package", The R Journal, 2016

BibTeX citation

@article{RJ-2016-046,
  author = {Sachs, Michael C. and Gabriel, Erin E.},
  title = {An Introduction to Principal Surrogate Evaluation with the pseval Package},
  journal = {The R Journal},
  year = {2016},
  note = {https://doi.org/10.32614/RJ-2016-046},
  doi = {10.32614/RJ-2016-046},
  volume = {8},
  issue = {2},
  issn = {2073-4859},
  pages = {277-292}
}