DJLoopAnalyzer

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:24

Complete DJ Loop Analyzer Class Provides intelligent loop analysis, similarity matching, and organization

Constructors

Constructor

new DJLoopAnalyzer(): DJLoopAnalyzer

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:25

Returns

DJLoopAnalyzer

Properties

analysisCache

analysisCache: Map<any, any>

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:29

clusters

clusters: any

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:28

loops

loops: Map<any, any>

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:26

similarityMatrix

similarityMatrix: any[]

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:27

Methods

analyzeClusterCharacteristics()

analyzeClusterCharacteristics(members): any

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:418

Analyze cluster characteristics — every value is measured from the member loops (no fabricated defaults).

Parameters

members

any[]

Cluster member loop objects

Returns

any

Cluster characteristics

analyzeLoop()

analyzeLoop(audioBuffer, metadata?): Promise<any>

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:38

Analyze a loop and extract all features

Parameters

audioBuffer

AudioBuffer

Audio buffer to analyze

metadata?

any = {}

Additional metadata

Returns

Promise<any>

Complete loop analysis

analyzeStructure()

analyzeStructure(onsetEnv, beatTimes): object

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:763

Parameters

onsetEnv

any

beatTimes

any

Returns

object

beatCount

beatCount: any = beatTimes.length

hasBreakdown

hasBreakdown: any

hasDrop

hasDrop: any

structuralComplexity

structuralComplexity: number

calculateChromaSimilarity()

calculateChromaSimilarity(loop1, loop2): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:229

Calculate chroma similarity using DTW

Parameters

loop1

any

First loop

loop2

any

Second loop

Returns

number

Similarity score (0-1)

calculateComplexity()

calculateComplexity(features): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:617

Parameters

features

any

Returns

number

calculateEnergySimilarity()

calculateEnergySimilarity(loop1, loop2): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:306

Calculate energy similarity

Parameters

loop1

any

First loop

loop2

any

Second loop

Returns

number

Similarity score (0-1)

calculateKeyCompatibility()

calculateKeyCompatibility(key1, key2): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:320

Calculate key compatibility using Camelot Wheel

Parameters

key1

any

First key

key2

any

Second key

Returns

number

Compatibility score (0-1)

calculateOverallEnergy()

calculateOverallEnergy(features): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:605

Parameters

features

any

Returns

number

calculateTempoSimilarity()

calculateTempoSimilarity(loop1, loop2, tolerance): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:276

Calculate tempo similarity

Parameters

loop1

any

First loop

loop2

any

Second loop

tolerance

number

BPM tolerance

Returns

number

Similarity score (0-1)

clusterLoops()

clusterLoops(nClusters?): any[]

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:379

Cluster loops into similar groups

Parameters

nClusters?

number = 5

Number of clusters

Returns

any[]

Cluster results

computeChromaMean()

computeChromaMean(chroma): Float32Array<ArrayBuffer>

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:590

Parameters

chroma

any

Returns

Float32Array<ArrayBuffer>

computeStructuralComplexity()

computeStructuralComplexity(onsetEnv): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:799

Structural complexity measured from the onset envelope. The envelope is split into up to 16 equal segments; the coefficient of variation of the per-segment mean energy is soft-squashed to [0, 1) via cv / (1 + cv). A steady loop has near-uniform segment energy (low value); breakdowns, drops and build-ups raise the segment-to-segment variance (high value). Measured from the signal — never a fabricated constant, never NaN.

Parameters

onsetEnv

ArrayLike<number>

Onset strength envelope

Returns

number

Complexity in [0, 1)

estimateKey()

estimateKey(chroma): object

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:635

Krumhansl-Schmuckler key estimation: Pearson correlation between the mean chroma vector and each rotated key profile. Confidence is the best correlation clamped to [0, 1] — a normalized figure, not the raw (scale-dependent) profile dot product.

Parameters

chroma

any

Returns

object

confidence

confidence: number

key

key: string = bestKey

mode

mode: string

tonic

tonic: string

extractAllFeatures()

extractAllFeatures(audioData, sampleRate): Promise<any>

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:90

Extract comprehensive audio features

Parameters

audioData

Float32Array<ArrayBufferLike>

Audio time series

sampleRate

number

Sample rate

Returns

Promise<any>

Extracted features

extractEnergyFeatures()

extractEnergyFeatures(audioData, onsetEnv): object

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:741

Parameters

audioData

any

onsetEnv

any

Returns

object

crest_factor

crest_factor: number = crestFactor

dynamic_range

dynamic_range: number = crestFactor

onset_density

onset_density: number

peak

peak: number

rms

rms: number

extractTimbralFeatures()

extractTimbralFeatures(audioData, sampleRate): object

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:724

Timbral descriptors, measured from the signal (documented proxies):

brightness: mean spectral centroid normalized by Nyquist (0..1)
roughness: mean spectral flatness (0 tonal .. 1 noisy)
warmth: 1 − mean spectral rolloff (85%) / Nyquist (0..1)

Parameters

audioData

Float32Array<ArrayBufferLike>

sampleRate

number

Returns

object

brightness

brightness: number

roughness

roughness: number

warmth

warmth: number

fallbackChromaSimilarity()

fallbackChromaSimilarity(loop1, loop2): number

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:251

Fallback chroma similarity using mean vectors

Parameters

loop1

any

First loop

loop2

any

Second loop

Returns

number

Similarity score

fallbackClustering()

fallbackClustering(nClusters): any[]

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:462

Fallback clustering by tempo

Parameters

nClusters

number

Number of clusters

Returns

any[]

Tempo-based clusters

findSimilarLoops()

findSimilarLoops(loopId, options?): any[]

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:155

Find similar loops using DTW and multiple feature comparison

Parameters

loopId

string

Target loop ID

options?

any = {}

Search options

Returns

any[]

Similar loops ranked by similarity

generateCacheKey()

generateCacheKey(audioData): string

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:581

Helper methods

Parameters

audioData

any

Returns

string

generateTags()

generateTags(features): any[]

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:545

Generate automatic tags based on features

Parameters

features

any

Extracted features

Returns

any[]

Generated tags

getHarmonicMixingOptions()

getHarmonicMixingOptions(currentLoopId): any[]

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:499

Get harmonic mixing suggestions

Parameters

currentLoopId

string

Currently playing loop

Returns

any[]

Harmonically compatible loops

updateSimilarityMatrix()

updateSimilarityMatrix(): void

Defined in: packages/pleco-xa/src/scripts/dj-loop-analyzer.js:826

Returns

void