Note

This page is a reference documentation. It only explains the function signature, and not how to use it. Please refer to the user guide for the big picture.

3.11.1. nistats.reporting.compare_niimgs

nistats.reporting.compare_niimgs(ref_imgs, src_imgs, masker, plot_hist=True, log=True, ref_label='image set 1', src_label='image set 2', output_dir=None, axes=None)

Creates plots to compare two lists of images and measure correlation.

The first plot displays linear correlation between voxel values. The second plot superimposes histograms to compare values distribution.

Parameters
ref_imgs: nifti_like

Reference images.

src_imgs: nifti_like

Source images.

masker: NiftiMasker object

Mask to be used on data.

plot_hist: Boolean, optional (default True)

If True then histograms of each img in ref_imgs will be plotted along-side the histogram of the corresponding image in src_imgs

log: Boolean, optional (default True)

Passed to plt.hist

ref_label: str

name of reference images

src_label: str

name of source images

output_dir: string, optional (default None)

Directory where plotted figures will be stored.

axes: list of two matplotlib Axes objects, optional (default None)

Can receive a list of the form [ax1, ax2] to render the plots. By default new axes will be created

Returns
corrs: numpy.ndarray

Pearson correlation between the images

3.11.1.1. Examples using nistats.reporting.compare_niimgs