nimare.meta.esma.stouffers

stouffers(z_maps, inference='ffx', null='theoretical', n_iters=None, two_sided=True)[source]

Run a Stouffer’s image-based meta-analysis on z-statistic maps.

Parameters

  • z_maps ((n_contrasts, n_voxels) numpy.ndarray) – A 2D array of z-statistic maps in the same space, after masking.

  • inference ({‘ffx’, ‘rfx’}, optional) – Whether to use fixed-effects inference (default) or random-effects inference.

  • null ({‘theoretical’, ‘empirical’}, optional) – Whether to use a theoretical null T distribution or an empirically- derived null distribution determined via sign flipping. Empirical null is only possible if inference = 'rfx'.

  • n_iters (int or None, optional) – The number of iterations to run in estimating the null distribution. Only used if inference = 'rfx' and null = 'empirical'.

  • two_sided (bool, optional) – Whether to do a two- or one-sided test. Default is True.

Returns

result (dict) – Dictionary containing maps for test statistics, p-values, and negative log(p) values.

References

  • Stouffer, S. A., Suchman, E. A., DeVinney, L. C., Star, S. A., & Williams Jr, R. M. (1949). The American Soldier: Adjustment during army life. Studies in social psychology in World War II, vol. 1. https://psycnet.apa.org/record/1950-00790-000