cbhattacharyya: Calculate the Bhattacharyya dissimilarities for each pair of...

In cmahalanobis: Calculate Distance Measures for DataFrames

Calculate the Bhattacharyya dissimilarities for each pair of factors or for the index.

Description

This function takes a dataframe and a variable or variables (two or more) in input, and returns a matrix or matrices (two or more) with the Bhattacharyya dissimilarities about the factors inside them. You can also select "index" to calculate the Bhattacharyya dissimilarities between each row.

Usage

cbhattacharyya(
  dataset,
  formula,
  plot = TRUE,
  plot_title = "Bhattacharyya Dissimilarity Between Groups",
  min_group_size = 3
)

Arguments

dataset	A dataframe.
formula	The index of the dataframe, otherwise a variable or variables (two or more) with factors which you want to calculate the Bhattacharyya dissimilarities matrix or matrices (two or more).
plot	Logical, if TRUE, a plot or plots (two or more) of the Bhattacharyya dissimilarities matrix or matrices about factors (two or more) are displayed.
plot_title	If plot is TRUE, the title to be used for plot or plots about factors. The default value is TRUE.
min_group_size	Minimum group size to maintain. The default value is 3, therefore groups, inside variables, with less than 3 observations will be discarded. For "index", this value is always 1.

Value

According to the option chosen in formula, with "index" the Bhattacharyya dissimilarities matrix will be printed; instead, by specifying variables, the Bhattacharyya dissimilarities matrix or matrices (two or more) between each pair of groups and, optionally, the plot or plots (two or more) will be printed.

Note

If "index" is selected with variables, only dissimilarities between rows are calculated. Therefore, this snippet: "cbhattacharyya(mtcars, ~am + carb + index)" will print dissimilarities only considering "index". Rows with NA values are omitted.

Examples

# Example with the iris dataset

data(iris)

cbhattacharyya(iris, ~Species, plot = TRUE, 
plot_title = "Bhattacharyya Dissimilarity Between Groups")

# Example with the mtcars dataset

data(mtcars)

cbhattacharyya(mtcars, ~am, plot = TRUE, 
plot_title = "Bhattacharyya Dissimilarity Between Groups")

# Calculate Bhattacharyya distance for index
res <- cbhattacharyya(mtcars, ~index)

cmahalanobis documentation built on Sept. 14, 2025, 5:09 p.m.