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.
nilearn.glm.first_level.run_glm¶
- nilearn.glm.first_level.run_glm(Y, X, noise_model='ar1', bins=100, n_jobs=1, verbose=0, random_state=None)[source]¶
GLM fit for an fMRI data matrix.
- Parameters:
- Yarray of shape (n_time_points, n_voxels)
The fMRI data.
- Xarray of shape (n_time_points, n_regressors)
The design matrix.
- noise_model{‘ar(N)’, ‘ols’}, default=’ar1’
The temporal variance model. To specify the order of an autoregressive model place the order after the characters ar, for example to specify a third order model use ar3.
- bins
int, default=100 Maximum number of discrete bins for the AR coef histogram. If an autoregressive model with order greater than one is specified then adaptive quantification is performed and the coefficients will be clustered via K-means with bins number of clusters.
- n_jobs
int, default=1 The number of CPUs to use to do the computation. -1 means ‘all CPUs’.
- verbose
int, default=0 The verbosity level.
- random_state
intor numpy.random.RandomState, default=None Random state seed to sklearn.cluster.KMeans for autoregressive models of order at least 2 (‘ar(N)’ with n >= 2).
Added in version 0.9.1.
- Returns:
- labelsarray of shape (n_voxels,),
A map of values on voxels used to identify the corresponding model.
- results
dict, Keys correspond to the different labels values values are RegressionResults instances corresponding to the voxels.