nimare.workflows.ibma.IBMAWorkflow

IBMAWorkflow(estimator=None, corrector=None, diagnostics=None, voxel_thresh=1.65, cluster_threshold=10, output_dir=None, n_cores=1)[source]

Compose a coordinate-based meta-analysis workflow.

Added in version 0.2.0.

This workflow performs a coordinate-based meta-analysis, multiple comparison corrections, and diagnostics analyses on corrected meta-analytic z-score maps.

Parameters:

  • estimator (IBMAEstimator, str {‘stouffers’, ‘fishers’, ‘hedges’, ‘permutedols’, ‘wleastsquares’, ‘dersimonianlaird’, ‘samplesizebl’. ‘variancebl’}, or optional) – Meta-analysis estimator. Default is ALE.

  • corrector (Corrector, str {‘montecarlo’, ‘fdr’, ‘bonferroni’} or optional) – Meta-analysis corrector. Default is FDRCorrector.

  • diagnostics (list of Diagnostics, Diagnostics, str {‘jackknife’}, or optional) – List of meta-analysis diagnostic classes. A single diagnostic class can also be passed. Default is FocusCounter.

  • voxel_thresh (float or None, optional) – An optional voxel-level threshold that may be applied to the target_image in the Diagnostics class to define clusters. This can be None or 0 if the target_image is already thresholded (e.g., a cluster-level corrected map). If diagnostics are passed as initialized objects, this parameter will be ignored. Default is 1.65, which corresponds to p-value = .05, one-tailed.

  • cluster_threshold (int or None, optional) – Cluster size threshold, in voxels. If None, then no cluster size threshold will be applied. If diagnostics are passed as initialized objects, this parameter will be ignored. Default is 10.

  • output_dir (str, optional) – Output directory in which to save results. If the directory doesn’t exist, it will be created. Default is None (the results are not saved).

  • n_cores (int, optional) – Number of cores to use for parallelization. If <=0, defaults to using all available cores. If estimator, corrector, or diagnostics are passed as initialized objects, this parameter will be ignored. Default is 1.