Note
Go to the end to download the full example code. or to run this example in your browser via Binder
Single-subject data (two runs) in native space¶
The example shows the analysis of an SPM dataset studying face perception. The analysis is performed in native space. Realignment parameters are provided with the input images, but those have not been resampled to a common space.
The experimental paradigm is simple, with two conditions; viewing a face image or a scrambled face image, supposedly with the same low-level statistical properties, to find face-specific responses.
For details on the data, please see Henson et al.[1].
This example takes a lot of time because the input are lists of 3D images sampled in different positions (encoded by different affine functions).
Fetch the SPM multimodal_faces data.
from nilearn.datasets import fetch_spm_multimodal_fmri
subject_data = fetch_spm_multimodal_fmri()
[fetch_spm_multimodal_fmri] Dataset created in
/home/runner/nilearn_data/spm_multimodal_fmri
[fetch_spm_multimodal_fmri] Missing 390 functional scans for session 1.
[fetch_spm_multimodal_fmri] Data absent, downloading...
[fetch_spm_multimodal_fmri] Downloading data from
https://www.fil.ion.ucl.ac.uk/spm/download/data/mmfaces/multimodal_fmri.zip ...
[fetch_spm_multimodal_fmri] Downloaded 2940928 of 134263085 bytes (2.2%%,
46.9s remaining)
[fetch_spm_multimodal_fmri] Downloaded 7356416 of 134263085 bytes (5.5%%,
35.8s remaining)
[fetch_spm_multimodal_fmri] Downloaded 11706368 of 134263085 bytes (8.7%%,
32.4s remaining)
[fetch_spm_multimodal_fmri] Downloaded 16588800 of 134263085 bytes (12.4%%,
29.5s remaining)
[fetch_spm_multimodal_fmri] Downloaded 21512192 of 134263085 bytes (16.0%%,
27.1s remaining)
[fetch_spm_multimodal_fmri] Downloaded 26099712 of 134263085 bytes (19.4%%,
25.7s remaining)
[fetch_spm_multimodal_fmri] Downloaded 31055872 of 134263085 bytes (23.1%%,
24.1s remaining)
[fetch_spm_multimodal_fmri] Downloaded 36044800 of 134263085 bytes (26.8%%,
22.7s remaining)
[fetch_spm_multimodal_fmri] Downloaded 41140224 of 134263085 bytes (30.6%%,
21.2s remaining)
[fetch_spm_multimodal_fmri] Downloaded 46424064 of 134263085 bytes (34.6%%,
19.7s remaining)
[fetch_spm_multimodal_fmri] Downloaded 51699712 of 134263085 bytes (38.5%%,
18.2s remaining)
[fetch_spm_multimodal_fmri] Downloaded 55558144 of 134263085 bytes (41.4%%,
17.6s remaining)
[fetch_spm_multimodal_fmri] Downloaded 60596224 of 134263085 bytes (45.1%%,
16.4s remaining)
[fetch_spm_multimodal_fmri] Downloaded 65667072 of 134263085 bytes (48.9%%,
15.1s remaining)
[fetch_spm_multimodal_fmri] Downloaded 71442432 of 134263085 bytes (53.2%%,
13.7s remaining)
[fetch_spm_multimodal_fmri] Downloaded 76963840 of 134263085 bytes (57.3%%,
12.3s remaining)
[fetch_spm_multimodal_fmri] Downloaded 82968576 of 134263085 bytes (61.8%%,
10.9s remaining)
[fetch_spm_multimodal_fmri] Downloaded 87719936 of 134263085 bytes (65.3%%,
9.9s remaining)
[fetch_spm_multimodal_fmri] Downloaded 92610560 of 134263085 bytes (69.0%%,
8.8s remaining)
[fetch_spm_multimodal_fmri] Downloaded 97624064 of 134263085 bytes (72.7%%,
7.7s remaining)
[fetch_spm_multimodal_fmri] Downloaded 103358464 of 134263085 bytes (77.0%%,
6.5s remaining)
[fetch_spm_multimodal_fmri] Downloaded 108838912 of 134263085 bytes (81.1%%,
5.3s remaining)
[fetch_spm_multimodal_fmri] Downloaded 114835456 of 134263085 bytes (85.5%%,
4.0s remaining)
[fetch_spm_multimodal_fmri] Downloaded 120414208 of 134263085 bytes (89.7%%,
2.8s remaining)
[fetch_spm_multimodal_fmri] Downloaded 126435328 of 134263085 bytes (94.2%%,
1.6s remaining)
[fetch_spm_multimodal_fmri] Downloaded 132030464 of 134263085 bytes (98.3%%,
0.5s remaining)
[fetch_spm_multimodal_fmri] ...done. (28 seconds, 0 min)
[fetch_spm_multimodal_fmri] Extracting data from
/home/runner/nilearn_data/spm_multimodal_fmri/sub001/multimodal_fmri.zip...
[fetch_spm_multimodal_fmri] .. done.
[fetch_spm_multimodal_fmri] Downloading data from
https://www.fil.ion.ucl.ac.uk/spm/download/data/mmfaces/multimodal_smri.zip ...
[fetch_spm_multimodal_fmri] Downloaded 2580480 of 6852766 bytes (37.7%%, 1.7s
remaining)
[fetch_spm_multimodal_fmri] Downloaded 5439488 of 6852766 bytes (79.4%%, 0.5s
remaining)
[fetch_spm_multimodal_fmri] ...done. (3 seconds, 0 min)
[fetch_spm_multimodal_fmri] Extracting data from
/home/runner/nilearn_data/spm_multimodal_fmri/sub001/multimodal_smri.zip...
[fetch_spm_multimodal_fmri] .. done.
Specify timing and design matrix parameters.
# repetition time, in seconds
t_r = 2.0
# Sample at the beginning of each acquisition.
slice_time_ref = 0.0
# We use a discrete cosine transform to model signal drifts.
drift_model = "Cosine"
# The cutoff for the drift model is 0.01 Hz.
high_pass = 0.01
# The hemodynamic response function
hrf_model = "spm + derivative"
Resample the images.
This is achieved by the concat_imgs function of Nilearn.
import warnings
from nilearn.image import concat_imgs, mean_img, resample_img
# Avoid getting too many warnings due to resampling
with warnings.catch_warnings():
warnings.simplefilter("ignore")
fmri_img = [
concat_imgs(subject_data.func1, auto_resample=True),
concat_imgs(subject_data.func2, auto_resample=True),
]
affine, shape = fmri_img[0].affine, fmri_img[0].shape
print("Resampling the second image (this takes time)...")
fmri_img[1] = resample_img(
fmri_img[1], affine, shape[:3], copy_header=True, force_resample=True
)
Resampling the second image (this takes time)...
Let’s create mean image for display purposes.
mean_image = mean_img(fmri_img, copy_header=True)
Make the design matrices.
import numpy as np
import pandas as pd
from nilearn.glm.first_level import make_first_level_design_matrix
design_matrices = []
Loop over the two runs.
for idx, img in enumerate(fmri_img, start=1):
# Build experimental paradigm
n_scans = img.shape[-1]
events = pd.read_table(subject_data[f"events{idx}"])
# Define the sampling times for the design matrix
frame_times = np.arange(n_scans) * t_r
# Build design matrix with the reviously defined parameters
design_matrix = make_first_level_design_matrix(
frame_times,
events,
hrf_model=hrf_model,
drift_model=drift_model,
high_pass=high_pass,
)
# put the design matrices in a list
design_matrices.append(design_matrix)
We can specify basic contrasts (to get beta maps). We start by specifying canonical contrast that isolate design matrix columns.
contrast_matrix = np.eye(design_matrix.shape[1])
basic_contrasts = {
column: contrast_matrix[i]
for i, column in enumerate(design_matrix.columns)
}
We actually want more interesting contrasts. The simplest contrast just makes the difference between the two main conditions. We define the two opposite versions to run one-tailed t-tests. We also define the effects of interest contrast, a 2-dimensional contrasts spanning the two conditions.
contrasts = {
"faces-scrambled": basic_contrasts["faces"] - basic_contrasts["scrambled"],
"scrambled-faces": -basic_contrasts["faces"]
+ basic_contrasts["scrambled"],
"effects_of_interest": np.vstack(
(basic_contrasts["faces"], basic_contrasts["scrambled"])
),
}
Fit the GLM for the 2 runs by specifying a FirstLevelModel and then fitting it.
from nilearn.glm.first_level import FirstLevelModel
print("Fitting a GLM")
fmri_glm = FirstLevelModel()
fmri_glm = fmri_glm.fit(fmri_img, design_matrices=design_matrices)
Fitting a GLM
Now we can compute contrast-related statistical maps (in z-scale), and plot them.
from nilearn import plotting
print("Computing contrasts")
# Iterate on contrasts
for contrast_id, contrast_val in contrasts.items():
print(f"\tcontrast id: {contrast_id}")
# compute the contrasts
z_map = fmri_glm.compute_contrast(contrast_val, output_type="z_score")
# plot the contrasts as soon as they're generated
# the display is overlaid on the mean fMRI image
# a threshold of 3.0 is used, more sophisticated choices are possible
plotting.plot_stat_map(
z_map,
bg_img=mean_image,
threshold=3.0,
display_mode="z",
cut_coords=3,
black_bg=True,
title=contrast_id,
)
plotting.show()
Computing contrasts
contrast id: faces-scrambled
/home/runner/work/nilearn/nilearn/examples/04_glm_first_level/plot_spm_multimodal_faces.py:142: UserWarning: One contrast given, assuming it for all 2 runs
z_map = fmri_glm.compute_contrast(contrast_val, output_type="z_score")
contrast id: scrambled-faces
/home/runner/work/nilearn/nilearn/examples/04_glm_first_level/plot_spm_multimodal_faces.py:142: UserWarning: One contrast given, assuming it for all 2 runs
z_map = fmri_glm.compute_contrast(contrast_val, output_type="z_score")
contrast id: effects_of_interest
/home/runner/work/nilearn/nilearn/examples/04_glm_first_level/plot_spm_multimodal_faces.py:142: UserWarning: One contrast given, assuming it for all 2 runs
z_map = fmri_glm.compute_contrast(contrast_val, output_type="z_score")
/home/runner/work/nilearn/nilearn/examples/04_glm_first_level/plot_spm_multimodal_faces.py:142: UserWarning: Running approximate fixed effects on F statistics.
z_map = fmri_glm.compute_contrast(contrast_val, output_type="z_score")
Based on the resulting maps we observe that the analysis results in wide activity for the ‘effects of interest’ contrast, showing the implications of large portions of the visual cortex in the conditions. By contrast, the differential effect between “faces” and “scrambled” involves sparser, more anterior and lateral regions. It also displays some responses in the frontal lobe.
References¶
Total running time of the script: (2 minutes 15.898 seconds)
Estimated memory usage: 975 MB