choose.best: Chooses the best trained Clomial model.

Description Usage Arguments Details Value Note Author(s) References See Also Examples

View source: R/choose.best.R

Description

Given the output of Clomial function, the likelihoods of all models are compared, and the best model is determined.

Usage

1
2
choose.best(models, U = NULL, PTrue = NULL, compareTo = NULL, upto =
"All", doTalk=FALSE)

Arguments

models

The models trained by Clomial function.

U

The optional genotype matrix used for comparison.

PTrue

The optional clone frequency matrix used for comparison.

compareTo

The index of the model against which all other models are compared. Set to NULL to disable.

upto

The models with index less than this value are considered. Set to "All" to include every model.

doTalk

If TRUE, information on number of analyzed models is reported.

Details

If compareTo, U, and PTrue are NULL no comparison will be done, and the function runs considerably faster.

Value

A list will be made with the following entries:

err

A list with 2 entries; err$P and err$U the vectors of clonal frequency errors, and genotype errors, accordingly.

Li

A vector of the best obtained log-likelihood for each model.

bestInd

The index of the best model in terms of log-likelihood.

comparison

If compareTo is not NULL, the result of comparison with the corresponding model is reported.

bestModel

The best model in terms of log-likelihood.

seconds

A vector of the time taken, in seconds, to train each model.

Note

When the number of assumed clones, C, is greater than 6, the comparison will be time taking because all possible permutations of clones should be considered. The running time will be slowed down by C!.

Author(s)

Habil Zare

References

Inferring clonal composition from multiple sections of a breast cancer, Zare et al., Submitted.

See Also

Clomial, Clomial.likelihood, Clomial.iterate

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
set.seed(4)
data(breastCancer)
Dc <- breastCancer$Dc
Dt <- breastCancer$Dt
ClomialResult <-Clomial(Dc=Dc,Dt=Dt,maxIt=20,C=4,doParal=FALSE,binomTryNum=5)
chosen <- choose.best(models=ClomialResult$models)
M1 <- chosen$bestModel
print("Genotypes:")
round(M1$Mu)
print("Clone frequencies:")
M1$P
bestInd <- chosen$bestInd
plot(chosen$Li,ylab="Log-likelihood",type="l")
points(x=bestInd,y=chosen$Li[bestInd],col="red",pch=19)

Clomial documentation built on Nov. 8, 2020, 8:16 p.m.