Class AudioAnalysis

  • All Implemented Interfaces:
    IModelObject


    public class AudioAnalysis
    extends AbstractModelObject
    Retrieve information about Audio Analysis objects by building instances from this class.
    These objects contain a great amount of additional information to AudioFeatures objects.

    Note: Audio Analysis data is created by the Software "Analyzer" by "The Echo Nest", which has been bought by Spotify in the past. Since then, new Analyzer versions were created by Spotify but there is a lack of documentation on the side of Spotify, so it is possible that this Javadoc page (and other Audio Analysis related Javadoc pages) contains speculative information about a few of its corresponding methods.

    • Method Detail

      • getBars

        public AudioAnalysisMeasure[] getBars​()
        Get the list of bar markers, in seconds. A bar (or measure) is a segment of time defined as a given number of beats. Bar offsets also indicate downbeats, the first beat of the measure.
        Returns:
        The list of bar markers, in seconds.
      • getBeats

        public AudioAnalysisMeasure[] getBeats​()
        Get the list of beat markers, in seconds. A beat is the basic time unit of a piece of music; for example, each tick of a metronome. Beats are typically multiples of tatums.
        Returns:
        The list of beat markers, in seconds.
      • getMeta

        public AudioAnalysisMeta getMeta​()
        Get the metadata of the analyzer software for the track.
        Returns:
        Analyze, compute, and track information.
      • getSections

        public AudioAnalysisSection[] getSections​()
        Get the set of section markers, in seconds. Sections are defined by large variations in rhythm or timbre, e.g. chorus, verse, bridge, guitar solo, etc. Each section contains its own descriptions of tempo, key, mode, time_signature, and loudness
        Returns:
        The set of section markers, in seconds.
      • getSegments

        public AudioAnalysisSegment[] getSegments​()
        Get the set of sound entities (typically under a second) each relatively uniform in timbre and harmony. Segments are characterized by their perceptual onsets and duration in seconds, loudness (dB), pitch and timbral content.
        Returns:
        The set of sound entities (typically under a second) each relatively uniform in timbre and harmony.
      • getTatums

        public AudioAnalysisMeasure[] getTatums​()
        Get the list of tatum markers, in seconds. Tatums represent the lowest regular pulse train that a listener intuitively infers from the timing of perceived musical events (segments).
        Returns:
        Get the list of tatum markers, in seconds.
      • getTrack

        public AudioAnalysisTrack getTrack​()
        Get the track data of the audio analysis object.
        Returns:
        Track data of audio analysis object.
      • builder

        public AudioAnalysis.Builder builder​()
        Description copied from interface: IModelObject
        Create a builder for building an instance of a model object.
        The type of the builder and its methods depend on its corresponding implementation.
        Returns:
        A builder object.