Bases: object
This is a class to represent multiple ROI objects, where the reference to a given domain is explicit.
A mutliple ROI object is a set of ROI defined on a given domain, each having its own ‘region-level’ characteristics (ROI features).
Every voxel of the domain can have its own characteristics yet, defined at the ‘voxel-level’, but those features can only be accessed familywise (i.e. the values are grouped by ROI).
Parameters : | `k`: int, :
`label`: array of shape (domain.size), dtype=np.int, :
`features`: dict{str: list of object, length=self.k} :
`roi_features`: dict{str: array-like, shape=(self.k, roi_feature_dim) :
|
---|
Methods
copy | Generic (shallow and deep) copying operations. |
feature_to_voxel_map | |
get_coord | |
get_feature | |
get_id | |
get_local_volume | |
get_roi_feature | |
get_size | |
get_volume | |
integrate | |
plot_feature | |
recompute_labels | |
remove_feature | |
remove_roi_feature | |
representative_feature | |
select_id | |
select_roi | |
set_feature | |
set_roi_feature | |
to_image |
Initialize subdomains instance
Parameters : | domain: ROI instance :
label: array of shape (domain.size), dtype=np.int, :
id: array of shape (n_roi) :
|
---|
Returns a copy of self.
Note that self.domain is not copied.
Convert a feature to a flat voxel-mapping array.
Get coordinates of ROI’s voxels
Parameters : | id: any hashable type :
|
---|
Return a voxel-wise feature, grouped by ROI.
Parameters : | fid: str, :
id: any hashable type :
|
---|
Return ROI’s id list.
Users must access ROIs with the use of the identifiers of this list and the methods that give access to their properties/features.
Get volume of ROI’s voxels
Parameters : | id: any hashable type :
|
---|
Get ROI size (counted in terms of voxels)
Parameters : | id: any hashable type :
|
---|
Get ROI volume
Parameters : | id: any hashable type :
|
---|
Integrate certain feature on each ROI and return the k results
Parameters : | fid : str
id: any hashable type :
|
---|---|
Returns : | lsum = array of shape (self.k, self.feature[fid].shape[1]), :
|
Boxplot the distribution of features within ROIs. Note that this assumes 1-d features.
Parameters : | fid: string :
ax: axis handle, optional : |
---|
Redefine labels so that they are consecutive integers.
Labels are used as a map to associate voxels to a given ROI. It is an inner object that should not be accessed outside this class. The number of nodes is updated appropriately.
Remove a certain feature
Parameters : | fid: str, :
|
---|
Remove a certain ROI feature.
The id ROI feature cannot be removed.
Compute a ROI representative of a given feature.
Parameters : | fid: str, :
method: str, :
id: any hashable type :
assess_quality: bool :
|
---|
Convert a ROI id into an index to be used to index features safely.
Returns an instance of MROI with only the subset of chosen ROIs.
Parameters : | id_list: list of id (any hashable type) :
|
---|
Append or modify a feature
Parameters : | fid: str, :
data: list of self.k arrays of shape(self.size[k], p) or :
id: any hashable type :
override: bool, optional, :
Note that we cannot create a feature having the same name than : a ROI feature. : |
---|
Append or modify a ROI feature
Parameters : | fid: str, :
data: list of self.k features or a single feature :
id: any hashable type :
override: bool, optional, :
Note that we cannot create a ROI feature having the same name than : a feature. : Note that the `id` feature cannot be modified as an internal : component. : |
---|
Generates a label image that represents self.
Parameters : | fid: str, :
roi: bool, :
method: str, :
descrip: str, :
|
---|
Return a SubDomain from an n-d int array
Parameters : | label: np.array instance :
affine: np.array, optional :
nn: int, :
|
---|
Create discrete ROIs as a set of balls within a certain coordinate systems.
Parameters : | domain: StructuredDomain instance, :
positions: array of shape(k, dim): :
radii: array of shape(k): :
|
---|
Return a SubDomain instance from the input mask image.
Parameters : | mim: NiftiIImage instance, or string path toward such an image :
nn: int, optional :
|
---|---|
Returns : | The MultipleROI instance : |
Keep the set of labels of the image corresponding to a certain index so that their position is closest to the prescribed one.
Parameters : | mim: NiftiIImage instance, or string path toward such an image :
pos: array of shape(3) or list of length 3, :
|
---|