R/coeff.R

In SOHPIE: Statistical Approach via Pseudo-Value Information and Estimation

#' @title coeff
#'
#' @description A function to retrieve a vector of coefficient estimates
#'    of all predictor variables in the pseudo-value regression model.
#'
#' @param SOHPIEres An object called after running SOHPIE_DNA.
#'
#' @return A table that includes coefficient estimates for all variables included in the fitted model.
#'
#' @examples
#' \donttest{
#' data(combinedamgut) # A complete data containing columns with taxa and clinical covariates.
#'
#' # Note: The line below will use a toy example with the first 30 out of 138 taxa.
#' OTUtab = combinedamgut[ , 8:37]
#' # Clinical/demographic covariates (phenotypic data):
#' # Note: All of these covariates will be included in the regression, so
#' # please make sure that phenodat includes the variables that will be analyzed only.
#' phenodat = combinedamgut[, 1:7] # first column is ID, so not using it.
#' # Obtain indices of each grouping factor
#' # In this example, a variable indicating the status of living with a dog was chosen (i.e. bin_dog).
#' # Accordingly, Groups A and B imply living without and with a dog, respectively.
#'  newindex_grpA = which(combinedamgut$bin_dog == 0)
#'  newindex_grpB = which(combinedamgut$bin_dog == 1)
#'
#' SOHPIEres <- SOHPIE_DNA(OTUdat = OTUtab, clindat = phenodat,
#' groupA = newindex_grpA, groupB = newindex_grpB, c = 0.5)
#'
#' # coeff() function will return coefficient estimates only.
#' coeff(SOHPIEres)
#' }
#' @export

coeff <- function(SOHPIEres) {
  coefftab <- SOHPIEres$beta_hat
  return(coefftab = coefftab)
}