evolve-methods: Evolutionary mode for Bayesian Factor Regression Modeling...

Description Methods Value See Also

Description

Runs an executable program released by West et al and available here (). Writes out temporary files, passes them to an executable, and reads summary files back into R. Temporary files are discarded once the R session is terminated unless specified otherwise. This method is specific to what the authors call evolutionary mode of the more general Bayesian Factor Regression Modeling (bfrm).

Methods

signature(data = "matrix", ...)
data

numeric matrix with one row per predictor and one column per observation / sample / patient to be passed to the bfrm algorithm

...

optional arguments, including:

design

design argument(s) to be passed to the bfrm algorithm

control

control argument(s) to be passed to the bfrm algorithm (i.e. "assay artifact" variables)

burnin

number of burn-in iterations in the MCMC – default is 2000

nmcsamples

number of MCMC iterations – default is 5000

init

the rownames (or indices) of data that are to be included in the initializing set of evolutionary mode – default is the first row of data

varThreshold

this parameter sets the threshold for bringing a new variable into the model - in considering whether to add in new variables (genes) at a given evolutionary analysis step, variables are ranked according to their approximate posterior probability of inclusion at that stage - pne of the two elements of the decision to include some of the most highly ranked variables is then a threshold on this posterior inclusion probability – variables with probabilities below that threshold will not be included – default is 0.75 (acceptable values from 0-1)

facThreshold

this parameter sets the threshold for adding a new latent factor into the model - a new latent factor will be added if and only if at least this number of variables (genes) for that factor have posterior probability of association with the factor that exceed this probability threshold – default is 0.75 (acceptable values from 0-1)

maxVarIter

this parameter sets the maximum number of variables (genes) that can be added to the model at each iteration – default is 5

minFacVars

this parameter sets the minimum number of variables (genes) showing significant association with a factor in order for that factor to be included in the model – default is 5

maxFacVars

this parameter sets the maximum number of variables that can be weighted on any one factor in the evolutionary inclusion steps - this allows the user to limit the number of variables brought into the model for each factor and hence to explore more effectively other factor dimensions – default is 15

maxFacs

this parameter sets the maximum number of latent factors that the final model can have – default is 5

maxVars

this parameter sets the maximum number of variables the final model can have – default is 100

outputDir

directory for output text files to be stored - default is withing a temporary directory which will be deleted once the R session is terminated.

other

named arguments overwriting of defaults specified in the slots of class bfrmParam - only for advanced users.

Value

Return value is of class bfrmResult

See Also

model classes

bfrmModel, evolveModel

methods

bfrm, projection

model results

bfrmResult


Sage-Bionetworks/bfrm documentation built on May 9, 2019, 12:11 p.m.