compmus_normalise: Normalise vectors
In jaburgoyne/compmus: Support Functions for Computational Musicology

View source: R/norms.R

compmus_normalise

R Documentation

Normalise vectors

Description

We use a number of vector normalisation strategies in Computational Musicology. This function brings them together into one place, along with common alternative names.

Usage

compmus_normalise(v, method = "euclidean")

compmus_normalize(v, method = "euclidean")

Arguments

`v`	A numeric vector.
`method`	A character string indicating which normalization to use (see Details). Default is the Euclidean norm.

Details

The following methods are supported.

identity,id: No normalisation.
harmonic: Harmonic mean.
manhattan,L1: Manhattan (L1) norm.
euclidean,L2: Euclidean (L2) norm.
chebyshev,maximum: Chebyshev (maximum) norm.
aitchison,clr: Aitchison's clr transformation.
softmax: Softmax.

Functions

compmus_normalize: Normalize vectors

Examples

library(tidyverse)
get_tidy_audio_analysis("6IQILcYkN2S2eSu5IHoPEH") %>%
  select(segments) %>%
  unnest(segments) %>%
  mutate(pitches = map(pitches, compmus_normalise, "euclidean"))

jaburgoyne/compmus documentation built on Feb. 26, 2023, 3:44 a.m.