Fits a penetrance model for family data with missing genotypes via the EM algorithm and provides model parameter estimates and corresponding gender and genotypespecific penetrance estimates.
1 2  penmodelEM(parms, vbeta, data, design="pop", base.dist="Weibull",
robust=FALSE, method="data", mode="dominant", q=0.02)

parms 
Vector of initial values for baseline parameters.

vbeta 
Vector of initial values for the regression coefficients for gender and majorgene,

data 
Data frame generated from 
design 
Study design of the family data. Possible choices are: 
base.dist 
Choice of baseline hazard distribution to fit. Possible choices are: 
robust 
Logical; if TRUE, use robust 'sandwich' standard errors and variance matrix, otherwise use conventional standard errors and variance matrix. 
method 
Choice of methods for calculating the carrier probabilities for individuals with missing mutation status. Possible choices are If 
mode 
Choice of modes of inheritance for calculating carrier probabilies for individuals with missing mutation status. Possible choices are 
q 
Frequency of the disease causing allele used for calculating carrier pobabilities. The value should be between 0 and 1. If 
The expectation and maximization (EM) algorithm is applied for making inference about the missing genotypes. In the expectation step, for individuals with unknown carrier status, we first compute their carrier probabilities given their family's observed phenotype and genotype information based on current estimates of parameters θ
w_{fi} = P(X_{fi}=1Y_{fi}, X^o_f) ,
where X_{fi} represents the mutation carrier status and Y_{fi} represents the phenotype (t_{fi}, δ_{fi}) in terms of age at onset t_{fi} and disease status δ_{fi} for individual i in family f and X^o_f represents the observed genotypes in family f.
Then, we obtain the conditional expectation of the loglikelihood function of the complete data given the observed data as a weighted loglikelihood, which has the form
E_{θ} [\ell (θ)  Y, X^o)] = ∑_f^n ∑_i^{n_f} \ell_{fi}(θ  X_{fi}=1) w_{fi} + \ell_{fi}(θ  X_{fi}=0) (1w_{fi}),
In the maximization step, the updated parameter estimates are obtained by maximizing the weighted log likelihood computed in the Estep.
These expectation and maximization steps iterate until convergence to obtain the maximum likelihood estimates.
See more details in Choi and Briollais (2011) or Choi et al. (2014).
Transformed baseline parameters (λ, ρ) were used for estimation; see penmodel
for details.
Returns an object of class 'penmodel'
, including the following elements:
coefficients 
Parameter estimates of transformed baseline parameters (λ, ρ) and regression coefficients for gender and mutation status (β_s, β_g) including their standard errors and also their robust standard errors. 
varcov 
Variance covariance matrix of parameter estimates. If 
se 
Standard errors of parameter estimates. If 
pen70.est 
Penetrance estimates by age 70 specific to gender and mutationstatus subgroups. 
pen70.se 
Standard errors of penetrance estimates by age 70 specific to gender and mutationstatus subgroups. 
pen70.ci 
95% confidence interval estimates of penetrance by age 70 specific to gender and mutationstatus subgroups. 
ageonset 
Vector of ages of onset ranging from 
pen.maleCarr 
Vector of penetrance estimates for male carriers from 
pen.femaleCarr 
Vector of penetrance estimates for female carriers from 
pen.maleNoncarr 
Vector of penetrance estimates for male noncarriers from 
pen.femaleNoncarr 
Vector of penetrance estimates for female noncarriers from 
logLik 
Loglikelihood value for the fitted penetrance model. 
YunHee Choi
Choi, Y.H. and Briollais, L. (2011) An EM composite likelihood approach for multistage sampling of family data with missing genetic covariates, Statistica Sinica 21, 231253.
Choi, Y.H., Briollais, L., Green, J., Parfrey, P., and Kopciuk, K. (2014) Estimating successive cancer risks in Lynch Syndrome families using a progressive threestate model, Statistics in Medicine 33, 618638.
simfam
, penmodel
, print.penmodel
, summary.penmodel
, print.summary.penmodel
,
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20  # Family data simulated with 30% of members missing their genetic information.
fam < simfam(N.fam=100, design="pop+", base.dist="Weibull", base.parms=c(0.01,3),
vbeta=c(1.13, 2.35), agemin=20, allelefreq=0.02, mrate=0.3)
# EM algorithm for fitting family data with missing genotypes
fit < penmodelEM(parms=c(0.01, 3), vbeta=c(1.13, 2.35), data=fam, design="pop+",
base.dist="Weibull", method="mendelian", mode="dominant", q=NULL)
# Summary of the model parameter and penetrance estimates from model fit
# by penmodelEM
summary(fit)
# Generate the lifetime penetrance curves from model fit for gender and
# mutation status groups along with their nonparametric penetrance curves
# based on observed data
plot(fit)

Questions? Problems? Suggestions? Tweet to @rdrrHQ or email at ian@mutexlabs.com.
Please suggest features or report bugs with the GitHub issue tracker.
All documentation is copyright its authors; we didn't write any of that.