Package de.sonallux.spotify.api.models

Class Segment

java.lang.Object

de.sonallux.spotify.api.models.Segment

public class Segment
extends Object

SegmentObject

Field Summary

Fields

Modifier and Type	Field	Description
float	confidence	The confidence, from 0.0 to 1.0, of the reliability of the segmentation.
float	duration	The duration (in seconds) of the segment.
float	loudnessEnd	The offset loudness of the segment in decibels (dB).
float	loudnessMax	The peak loudness of the segment in decibels (dB).
float	loudnessMaxTime	The segment-relative offset of the segment peak loudness in seconds.
float	loudnessStart	The onset loudness of the segment in decibels (dB).
List<Float>	pitches	Pitch content is given by a “chroma” vector, corresponding to the 12 pitch classes C, C#, D to B, with values ranging from 0 to 1 that describe the relative dominance of every pitch in the chromatic scale.
float	start	The starting point (in seconds) of the segment.
List<Float>	timbre	Timbre is the quality of a musical note or sound that distinguishes different types of musical instruments, or voices.

Constructor Summary

Constructors

Constructor	Description
Segment()

Method Summary

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

confidence

public float confidence

The confidence, from 0.0 to 1.0, of the reliability of the segmentation. Segments of the song which are difficult to logically segment (e.g: noise) may correspond to low values in this field.

duration

public float duration

The duration (in seconds) of the segment.

loudnessEnd

public float loudnessEnd

The offset loudness of the segment in decibels (dB). This value should be equivalent to the loudness_start of the following segment.

loudnessMax

public float loudnessMax

The peak loudness of the segment in decibels (dB). Combined with loudness_start and loudness_max_time, these components can be used to describe the "attack" of the segment.

loudnessMaxTime

public float loudnessMaxTime

The segment-relative offset of the segment peak loudness in seconds. Combined with loudness_start and loudness_max, these components can be used to desctibe the "attack" of the segment.

loudnessStart

public float loudnessStart

The onset loudness of the segment in decibels (dB). Combined with loudness_max and loudness_max_time, these components can be used to describe the "attack" of the segment.

pitches

public List<Float> pitches

Pitch content is given by a “chroma” vector, corresponding to the 12 pitch classes C, C#, D to B, with values ranging from 0 to 1 that describe the relative dominance of every pitch in the chromatic scale. For example a C Major chord would likely be represented by large values of C, E and G (i.e. classes 0, 4, and 7).

Vectors are normalized to 1 by their strongest dimension, therefore noisy sounds are likely represented by values that are all close to 1, while pure tones are described by one value at 1 (the pitch) and others near 0. As can be seen below, the 12 vector indices are a combination of low-power spectrum values at their respective pitch frequencies.

start

public float start

The starting point (in seconds) of the segment.

timbre

public List<Float> timbre

Timbre is the quality of a musical note or sound that distinguishes different types of musical instruments, or voices. It is a complex notion also referred to as sound color, texture, or tone quality, and is derived from the shape of a segment’s spectro-temporal surface, independently of pitch and loudness. The timbre feature is a vector that includes 12 unbounded values roughly centered around 0. Those values are high level abstractions of the spectral surface, ordered by degree of importance.

For completeness however, the first dimension represents the average loudness of the segment; second emphasizes brightness; third is more closely correlated to the flatness of a sound; fourth to sounds with a stronger attack; etc. See an image below representing the 12 basis functions (i.e. template segments).

The actual timbre of the segment is best described as a linear combination of these 12 basis functions weighted by the coefficient values: timbre = c1 x b1 + c2 x b2 + ... + c12 x b12, where c1 to c12 represent the 12 coefficients and b1 to b12 the 12 basis functions as displayed below. Timbre vectors are best used in comparison with each other.

Constructor Details

Segment

public Segment()