JMcmprsk (version 0.9.6)

jmo_long: An integrated function for reconstructing data and do the joint modelling

Description

Reconstruct data into a regular longitudinal format as a refined dataset and do joint modelling for this refined data with ordinal outcome.

Usage

jmo_long(long_data, surv_data, out, FE, RE, NP, ID, cate = NULL,
  intcpt = 1, quad.points = 20, max.iter = 10000, quiet = TRUE,
  do.trace = FALSE)

Arguments

long_data

Data matrix for longitudinal in long format. The time variable should be labeled 'time'.

surv_data

Data matrix for competing risks data. Each subject has one row of observation (as opposed to the long_data). First and second column should be the observed event time and censoring indicator, respectively. The coding for the censoring indicator is as follows: 0 - censored events, 1 - risk 1, 2 - risk 2. Two competing risks are assumed.

out

Column name for outcome variable in long_data.

FE

Vector of column names that correspond to the fixed effects in long_data. If missing, then all columns except for the outcome and ID columns will be considered.

RE

Types/Vector of random effects in long_data. The available type are "intercept", "linear", "quadratic" (time-related random effect specification) or other covariates in the input dataset.

NP

Vector of column names that correspond to the non-proportional odds covariates. It won't run the model if NP is not specified.

ID

Column name for subject ID number in long_data.

cate

Vector of categorical variables in long_data.

intcpt

Specify either 0 or 1. Default is set as 1. 0 means no intercept in random effect.

quad.points

Number of quadrature points used in the EM procedure. Default is 20. Must be an even number. Larger values means higher accuracy but more time-consuming.

max.iter

Max iterations. Default is 10000.

quiet

Logical. Print progress of function. Default is TRUE.

do.trace

Logical. Print the parameter estimates during the iterations. Default is FALSE.

Value

Object of class JMcmprsk with elements

vcmatrix	The variance-covariance matrix for all the parameters. The parameters are in the order: \(\beta\), \(\sigma^2\), \(\gamma\), \(\nu\), and \(\Sigma\). The elements in \(\Sigma\) are output in the order along the main diagonal line, then the second main diagonal line, and so on.
betas	The point estimates of \(\beta\).
se_betas	The standard error estimate of \(\beta\).
gamma_matrix	The point estimate of \(\gamma\).
se_gamma_matrix	The standard error estimate of \(\gamma\).
v_estimate	The point estimate of \(\nu\).
se_v_estimate	The standard error estimate of \(\nu\).
sigma2_val	The point estimate of \(\sigma^2\).
se_sigma2_val	The standard error estimate of \(\sigma^2\).
sigma_matrix	The point estimate of \(\Sigma\) (only the upper triangle portion of the matrix is output).
se_sigma	The standard error estimate of \(\Sigma\).The standard errors are given in this order: main diagonal, the second main diagonal, and so on.
loglike	Log Likelihood.

See Also

jmo

Examples

# NOT RUN {
  require(tidyverse)
  yfile = system.file("extdata", "ninds_nrank_y.txt", package = "JMcmprsk")
  cfile = system.file("extdata", "ninds_nrank_c.txt", package = "JMcmprsk")
  mfile = system.file("extdata", "ninds_nrank_m.txt", package = "JMcmprsk")
  yread = read.table(yfile, header = TRUE)
  cread = read.table(cfile, header = TRUE)
  mread = read.table(mfile)
  # make a raw yread: this is a dataset like what users usually have
  yread <- yread[, -c(2:4)]
  # create an ID column for each subject and add it to yread
  ID <- vector()
  for (i in 1:nrow(mread)) {
  ID <- c(ID, replicate(mread[i, 1], i))
  }
  yread <- data.frame(ID, yread)
  ID <- c(1:nrow(cread))
  #Create two categorical variables and add them into yread
  set.seed(100)
  sex <- sample(c("Feamle", "Male"), nrow(mread), replace = T)
  race <- sample(c("White", "Black", "Asian", "Hispanic"), nrow(mread), replace = T)
  cate_var <- data.frame(ID, sex, race)
  yread <- left_join(yread, cate_var, by = "ID")
  # run jmo_long function again for yread file with two added categorical variables
  res1 <- jmo_long(yread, cread, out = "Y", 
  FE = c("group", "time3", "time6", "time12", "mrkprior", 
  "smlves", "lvORcs", "smlves.group", "lvORcs.group"), cate = c("sex", "race"), 
  RE = "intercept", NP = c("smlves", "lvORcs", "sex", "race"), ID = "ID",intcpt = 1, 
  quad.points = 12, max.iter = 1000, quiet = FALSE)
  
# }