# alibi\_detect.utils.distance ## Functions ### `abdm` ```python abdm(X: numpy.ndarray, cat_vars: dict, cat_vars_bin: dict = {}) -> dict ``` Calculate the pair-wise distances between categories of a categorical variable using the Association-Based Distance Metric based on Le et al (2005). | Name | Type | Default | Description | | -------------- | --------------- | ------- | ------------------------------------------------------------------------------------------------------------------- | | `X` | `numpy.ndarray` | | Batch of arrays. | | `cat_vars` | `dict` | | Dict with as keys the categorical columns and as optional values the number of categories per categorical variable. | | `cat_vars_bin` | `dict` | `{}` | Dict with as keys the binned numerical columns and as optional values the number of bins per variable. | **Returns** * Type: `dict` ### `cityblock_batch` ```python cityblock_batch(X: numpy.ndarray, y: numpy.ndarray) -> numpy.ndarray ``` Calculate the L1 distances between a batch of arrays X and an array of the same shape y. | Name | Type | Default | Description | | ---- | --------------- | ------- | ----------------------------------------------- | | `X` | `numpy.ndarray` | | Batch of arrays to calculate the distances from | | `y` | `numpy.ndarray` | | Array to calculate the distance to | **Returns** * Type: `numpy.ndarray` ### `multidim_scaling` ```python multidim_scaling(d_pair: dict, n_components: int = 2, use_metric: bool = True, standardize_cat_vars: bool = True, feature_range: Optional[tuple] = None, smooth: float = 1.0, center: bool = True, update_feature_range: bool = True) -> Tuple[dict, tuple] ``` Apply multidimensional scaling to pairwise distance matrices. | Name | Type | Default | Description | | ---------------------- | ----------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `d_pair` | `dict` | | Dict with as keys the column index of the categorical variables and as values a pairwise distance matrix for the categories of the variable. | | `n_components` | `int` | `2` | Number of dimensions in which to immerse the dissimilarities. | | `use_metric` | `bool` | `True` | If True, perform metric MDS; otherwise, perform nonmetric MDS. | | `standardize_cat_vars` | `bool` | `True` | Standardize numerical values of categorical variables if True. | | `feature_range` | `Optional[tuple]` | `None` | Tuple with min and max ranges to allow for perturbed instances. Min and max ranges can be floats or numpy arrays with dimension (1 x nb of features) for feature-wise ranges. | | `smooth` | `float` | `1.0` | Smoothing exponent between 0 and 1 for the distances. Lower values of l will smooth the difference in distance metric between different features. | | `center` | `bool` | `True` | Whether to center the scaled distance measures. If False, the min distance for each feature except for the feature with the highest raw max distance will be the lower bound of the feature range, but the upper bound will be below the max feature range. | | `update_feature_range` | `bool` | `True` | Update feature range with scaled values. | **Returns** * Type: `Tuple[dict, tuple]` ### `mvdm` ```python mvdm(X: numpy.ndarray, y: numpy.ndarray, cat_vars: dict, alpha: int = 1) -> Dict[typing.Any, numpy.ndarray] ``` Calculate the pair-wise distances between categories of a categorical variable using the Modified Value Difference Measure based on Cost et al (1993). | Name | Type | Default | Description | | ---------- | --------------- | ------- | ------------------------------------------------------------------------------------------------------------------- | | `X` | `numpy.ndarray` | | Batch of arrays. | | `y` | `numpy.ndarray` | | Batch of labels or predictions. | | `cat_vars` | `dict` | | Dict with as keys the categorical columns and as optional values the number of categories per categorical variable. | | `alpha` | `int` | `1` | Power of absolute difference between conditional probabilities. | **Returns** * Type: `Dict[typing.Any, numpy.ndarray]` ### `norm` ```python norm(x: numpy.ndarray, p: int) -> numpy.ndarray ``` Compute p-norm across the features of a batch of instances. | Name | Type | Default | Description | | ---- | --------------- | ------- | ------------------------------------------- | | `x` | `numpy.ndarray` | | Batch of instances of shape \[N, features]. | | `p` | `int` | | Power of the norm. | **Returns** * Type: `numpy.ndarray` ### `pairwise_distance` ```python pairwise_distance(x: numpy.ndarray, y: numpy.ndarray, p: int = 2) -> numpy.ndarray ``` Compute pairwise distance between 2 samples. | Name | Type | Default | Description | | ---- | --------------- | ------- | ----------------------------------------------- | | `x` | `numpy.ndarray` | | Batch of instances of shape \[Nx, features]. | | `y` | `numpy.ndarray` | | Batch of instances of shape \[Ny, features]. | | `p` | `int` | `2` | Power of the norm used to compute the distance. | **Returns** * Type: `numpy.ndarray` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.seldon.ai/alibi-detect/api-reference/utils/distance.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.