nimare.decode.continuous
.CorrelationDistributionDecoder¶
-
class
CorrelationDistributionDecoder
(feature_group=None, features=None, frequency_threshold=0.001, target_image='z')[source]¶ Decode an unthresholded image by correlating the image with images from all studies labeled with specific features.
- Parameters
feature_group (str) – Feature group
features (list) – Features
frequency_threshold (float) – Frequency threshold
target_image ({‘z’, ‘con’}) – Name of meta-analysis results image to use for decoding
Warning
Coefficients from correlating two maps have very large degrees of freedom, so almost all results will be statistically significant. Do not attempt to evaluate results based on significance.
-
fit
(dataset)[source]¶ Fit Estimator to Dataset.
- Parameters
dataset (
nimare.dataset.Dataset
) – Dataset object to analyze.- Returns
nimare.results.MetaResult
– Results of Estimator fitting.
Notes
The
fit
method is a light wrapper that runs input validation and preprocessing before fitting the actual model. Estimators’ individual “fitting” methods are implemented as_fit
, although users should callfit
.
-
get_params
(deep=True)[source]¶ Get parameters for this estimator.
- Parameters
deep (boolean, optional) – If True, will return the parameters for this estimator and contained subobjects that are estimators.
- Returns
params (mapping of string to any) – Parameter names mapped to their values.
-
set_params
(**params)[source]¶ Set the parameters of this estimator.
The method works on simple estimators as well as on nested objects (such as pipelines). The latter have parameters of the form
<component>__<parameter>
so that it’s possible to update each component of a nested object.- Returns
self
-
transform
(img)[source]¶ Correlate target image with each map associated with each feature.
- Parameters
img (
nibabel.nifti1.Nifti1Image
) – Image to decode. Must be in same space asdataset
.- Returns
out_df (
pandas.DataFrame
) – DataFrame with one row for each feature and two columns: “feature” and “r”.