Skip to contents

Create Group Dataset for Meta-Analysis

Source: R/group_data.R
group_data.Rd

Generic constructor that creates a group dataset from various input formats for use in group-level meta-analysis with fmri_meta.

Usage

group_data(data, format = c("auto", "h5", "nifti", "csv", "fmrilm"), ...)

Arguments

data

Input data. Format depends on the format argument:

  • For "h5": Character vector of HDF5 file paths

  • For "nifti": List or data frame with beta/SE/variance paths

  • For "csv": Path to CSV file or data frame

  • For "fmrilm": List of fmri_lm objects

format

Character string specifying the input format. One of "auto" (default), "h5", "nifti", "csv", or "fmrilm". If "auto", attempts to detect format.

...

Additional arguments passed to format-specific constructors

Value

A group_data object suitable for meta-analysis

Examples

if (FALSE) { # \dontrun{
# From HDF5 files created by write_results.fmri_lm
gd <- group_data(
  h5_paths,
  format = "h5",
  subjects = subject_ids,
  covariates = covariates_df,
  contrast = "FaceVsPlace"
)

# From NIfTI files
gd <- group_data(
  list(beta = beta_paths, se = se_paths),
  format = "nifti",
  subjects = subject_ids,
  mask = "group_mask.nii.gz"
)
} # }