nimare.diagnostics.FocusFilter

class FocusFilter(mask=None)

Bases: NiMAREBase

Remove coordinates outside of the collection mask.

Added in version 0.0.13.

Parameters:

mask (str, Nifti1Image, NiftiMasker or similar, or None, optional) – Mask(er) to use. If None, uses the masker of the collection provided in transform.

Notes

This filter removes any coordinates outside of the brain mask. It does not remove studies without coordinates in the brain mask, since an input collection does not need to have coordinates for all studies (e.g., some may only have images).

Methods

get_params([deep])	Get parameters for this estimator.
load(filename[, compressed])	Load a pickled class instance from file.
save(filename[, compress])	Pickle the class instance to the provided file.
set_params(**params)	Set the parameters of this estimator.
transform(dataset)	Apply the filter to a Studyset/Dataset collection.

get_params(deep=True)

Get parameters for this estimator.

Parameters:

deep (bool, default=True) – If True, will return the parameters for this estimator and contained subobjects that are estimators.

Returns:

params – Parameter names mapped to their values.

Return type:

dict

classmethod load(filename, compressed=True)

Load a pickled class instance from file.

Parameters:

• filename (str) – Name of file containing object.

• compressed (bool, default=True) – If True, the file is assumed to be compressed and gzip will be used to load it. Otherwise, it will assume that the file is not compressed. Default = True.

Returns:

obj – Loaded class object.

Return type:

class object

save(filename, compress=True)

Pickle the class instance to the provided file.

Parameters:

• filename (str) – File to which object will be saved.

• compress (bool, optional) – If True, the file will be compressed with gzip. Otherwise, the uncompressed version will be saved. Default = True.

set_params(**params)

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.

Return type:

self

transform(dataset)

Apply the filter to a Studyset/Dataset collection.

Parameters:

dataset (Studyset, or Dataset) – The collection to filter.

Returns:

• dataset (Dataset or Studyset) – The filtered collection.

• .. warning:: – Support for Dataset inputs is deprecated and will be removed in a future release. Prefer Studyset.