Skip to contents

Export tidyexposomics Results to Excel

Source: R/extract_results_excel.R
extract_results_excel.Rd

Exports selected results stored in a MultiAssayExperiment object created by the tidyexposomics pipeline to an Excel workbook. Users can select which result types to include, and optionally add placeholder sheets for missing data.

Usage

extract_results_excel(
  expom,
  file = "tidyexposomics_results.xlsx",
  result_types = c("correlation", "association", "differential_analysis",
    "multiomics_integration", "network", "enrichment", "exposure_summary", "pipeline"),
  include_empty_tabs = FALSE
)

Arguments

expom

A MultiAssayExperiment object with results stored in @metadata, typically created by the tidyexposomics pipeline.

file

Character. Path to the output Excel file (e.g., "tidyexposomics_results.xlsx").

result_types

Character vector specifying which result categories to export. Options include:

  • "correlation": Correlation results (e.g., exposure–PC, exposure–feature).

  • "association": Association results (e.g., ExWAS, omics–outcome models).

  • "differential_analysis": Differential abundance results, including sensitivity analysis if available.

  • "multiomics_integration": Common top features contributing to latent factors from multi-omics integration.

  • "network": Exposure impact metrics from network analyses.

  • "enrichment": Enrichment results by omic and exposure category.

  • "exposure_summary": Summary statistics for exposure variables.

  • "pipeline": Overview of steps completed in the pipeline.

Use "all" to export all of the above categories.

include_empty_tabs

Logical. If TRUE, adds placeholder sheets for any missing result types. Default is FALSE.

Value

An Excel file is written to the specified path. A message is printed with the file location.

Examples

if (FALSE) { # \dontrun{
extract_results_excel(expom_1, file = "tidy_results.xlsx", result_types = "all")
extract_results_excel(expom_1, file = "enrichment_only.xlsx", result_types = "enrichment")
} # }