enigmatoolbox.utils.parcellation.surface_to_parcel

enigmatoolbox.utils.parcellation.surface_to_parcel(values, labels, weights=None, target_labels=None, red_op='mean', axis=0, dtype=<class 'float'>)[source]

Summarize data in values according to labels (author: @OualidBenkarim)

Parameters
  • values (1D or 2D ndarray) – Array of values.

  • labels (name of parcellation or 1D ndarray, shape = (n_lab,)) – Labels used summarize values.

  • weights (1D ndarray, shape = (n_lab,), optional) – Weights associated with labels. Only used when red_op is ‘average’, ‘mean’, ‘sum’ or ‘mode’. Weights are not normalized. Default is None.

  • target_labels (1D ndarray, optional) – Target labels. Arrange new array following the ordering of labels in the target_labels. When None, new array is arranged in ascending order of labels. Default is None.

  • red_op (str or callable, optional) – How to summarize data. If str, options are: {‘min’, ‘max’, ‘sum’, ‘mean’, ‘median’, ‘mode’, ‘average’}. If callable, it should receive a 1D array of values, array of weights (or None) and return a scalar value. Default is ‘mean’.

  • dtype (dtype, optional) – Data type of output array. Default is float.

  • axis ({0, 1}, optional) – If axis == 0, apply to each row (reduce number of columns per row). Otherwise, apply to each column (reduce number of rows per column). Default is 0.

Returns

target_values – Summarized target values.

Return type

ndarray