Learn R Programming

Cyclops

Cyclops is part of the HADES.

Introduction

Cyclops (Cyclic coordinate descent for logistic, Poisson and survival analysis) is an R package for performing large scale regularized regressions.

Features

  • Regression of very large problems: up to millions of observations, millions of variables
  • Supports (conditional) logistic regression, (conditional) Poisson regression, as well as (conditional) Cox regression
  • Uses a sparse representation of the independent variables when appropriate
  • Supports using no prior, a normal prior or a Laplace prior
  • Supports automatic selection of hyperparameter through cross-validation
  • Efficient estimation of confidence intervals for a single variable using a profile-likelihood for that variable

Examples

  library(Cyclops)
  cyclopsData <- createCyclopsDataFrame(formula)
  cyclopsFit <- fitCyclopsModel(cyclopsData)

Technology

Cyclops in an R package, with most functionality implemented in C++. Cyclops uses cyclic coordinate descent to optimize the likelihood function, which makes use of the sparse nature of the data.

System Requirements

Requires R (version 3.1.0 or higher). Compilation on Windows requires RTools >= 3.4.

Installation

In R, to install the latest stable version, install from CRAN:

install.packages("Cyclops")

To install the latest development version, install from GitHub. Note that this will require RTools to be installed.

install.packages("devtools")
devtools::install_github("OHDSI/Cyclops")

User Documentation

Documentation can be found on the package website.

PDF versions of the documentation are also available:

Support

  • Developer questions/comments/feedback: OHDSI Forum
  • We use the GitHub issue tracker for all bugs/issues/enhancements

Contributing

Read here how you can contribute to this package.

License

Cyclops is licensed under Apache License 2.0. Cyclops contains the TinyThread libray.

The TinyThread library is licensed under the zlib/libpng license as described here.

Development

Cyclops is being developed in R Studio.

Acknowledgements

  • This project is supported in part through the National Science Foundation grants IIS 1251151 and DMS 1264153.

Copy Link

Version

Install

install.packages('Cyclops')

Version

3.4.0

License

Apache License 2.0

Issues

Pull Requests

Stars

Forks

Maintainer

Last Published

October 31st, 2023

Functions in Cyclops (3.4.0)

coverage

Coverage
getNumberOfCovariates

Get total number of covariates
getCrossValidationInfo

Get cross-validation information from a Cyclops model fit
getUnivariableSeparability

Get univariable linear separability
isInitialized

Check if a Cyclops data object is initialized
getFineGrayWeights

Creates a Surv object that forces in competing risks and the IPCW needed for Fine-Gray estimation.
getCyclopsPredictiveLogLikelihood

Compute predictive log-likelihood from a Cyclops model fit
getCyclopsProfileLogLikelihood

Profile likelihood for Cyclops model parameters
getNumberOfStrata

Get number of strata
getCovariateIds

Get covariate identifiers
getUnivariableCorrelation

Get univariable correlation
getCovariateTypes

Get covariate types
getSEs

Extract standard errors
getNumberOfTypes

Get total number of outcome types
reduce

Apply simple data reductions
fitCyclopsModel

Fit a Cyclops model
predict.cyclopsFit

Model predictions
fitCyclopsSimulation

Fit simulated data
getFloatingPointSize

Get floating point size
getHyperParameter

Get hyperparameter
plotCyclopsSimulationFit

Plot Cyclops simulation model fit
simulateCyclopsData

Simulation Cyclops dataset
getNumberOfRows

Get total number of rows
printMatrixMarket

Print Cyclops data matrix to file
mse

Mean squared error
oxford

Oxford self-controlled case series data
summary.cyclopsData

Cyclops data object summary
splitTime

Split the analysis time into several intervals for time-varying coefficients.
logLik.cyclopsFit

Extract log-likelihood
meanLinearPredictor

Calculates xbar*beta
readCyclopsData

Read Cyclops data from file
print.cyclopsFit

Print a Cyclops model fit object
print.cyclopsData

Print a Cyclops data object
vcov.cyclopsFit

Calculate variance-covariance matrix for a fitted Cyclops model object
survfit.cyclopsFit

Calculate baseline hazard function
convertToCyclopsVariance

Convert to Cyclops Prior Variance
Multitype

Create a multitype outcome object
convertToCyclopsData

Convert data from two data frames or ffdf objects into a CyclopsData object
convertToTimeVaryingCoef

Convert short sparse covariate table to long sparse covariate table for time-varying coefficients.
coef.cyclopsFit

Extract model coefficients
confint.cyclopsFit

Confidence intervals for Cyclops model parameters
aconfint

Asymptotic confidence intervals for a fitted Cyclops model object
appendSqlCyclopsData

appendSqlCyclopsData
Cyclops-package

Cyclops: Cyclic Coordinate Descent for Logistic, Poisson and Survival Analysis
convertToGlmnetLambda

Convert to glmnet regularization parameter
createCyclopsData

Create a Cyclops data object
cyclops

Cyclops: Cyclic coordinate descent for logistic, Poisson and survival analysis
createNonSeparablePrior

Create a Cyclops prior object that returns the MLE of non-separable coefficients
createPrior

Create a Cyclops prior object
createControl

Create a Cyclops control object
createAutoGridCrossValidationControl

Create a Cyclops control object that supports multiple hyperparameters
finalizeSqlCyclopsData

finalizeSqlCyclopsData
createParameterizedPrior

Create a Cyclops parameterized prior object
createWeightBasedSearchControl

Create a Cyclops control object that supports in- / out-of-sample hyperparameter search using weights