nimare.workflows.cbma.CBMAWorkflow

CBMAWorkflow(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.

Changed in version 0.1.2:

  • cbma_workflow function was converted to CBMAWorkflow class.

Added in version 0.0.14.

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

Parameters:

  • estimator (CBMAEstimator, str {‘ale’, ‘scale’, ‘mkdadensity’, ‘kda’}, optional) – Meta-analysis estimator. Default is ALE.

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

  • diagnostics (list of Diagnostics, Diagnostics, str {‘jackknife’, ‘focuscounter’}, 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 is applied only to those that left the corresponding parameter at its default. 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 is applied only to those that left the corresponding parameter at its default. 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 is applied only to those that left n_cores at its default. Default is 1.