xsummary {canprot}R Documentation

Summarize Compositional Differences


Make an HTML table summarizing compositional differences.


  xsummary(comptab, vars=c("ZC", "nH2O"))
  xsummary2(comptab1, comptab2, comptab3)
  xsummary3(comptab1, comptab2, comptab3)



list or data frame, summary of comparisons generated by get_comptab


character, two variables to tabulate


list, output of get_comptab


list, output of get_comptab


list, output of get_comptab


xsummary makes an HTML table (using xtable) and adds bold and underline formatting to highlight significant compositional differences. The p-value is bolded if it is less than 0.05, and the percent common language effect size (CLES) is bolded if it is <= 40 or >= 60. The mean (or median) difference is [underlined / bolded] if [only one of / both] the p-value and CLES pass these cutoffs.

The generated table is written to the console, and can be used in a vignette using the results = "asis" chunk option. The function also returns (invisibly) the data frame used to make the table; this data frame differs from comptab by having row names added (alphabetical one-letter IDs for the datasets).

xsummary2 is an updated version that is used in the current vignettes in the package. It shows negative numbers in bold (p-value and CLES are not shown). xsummary3 is a further revision that shows GRAVY and pI instead of phylostrata; it is used in the osmotic_bact and osmotic_halo vignettes.


comptab <- lapply(c("JKMF10", "WDO+15_C.N"), function(dataset) {
  pdat <- pdat_colorectal(dataset)
  get_comptab(pdat, oldstyle = TRUE)

[Package canprot version 1.1.0 Index]