Decipher
Docs
decipher / docs
v0.1.0 — computational toolkit

Overview

  • Introduction
  • Getting started
  • Core concepts
  • Data products
  • Audio gallery

Tutorials

  • Index
  • Load and listen
  • Detect acoustic units
  • Cluster units into types
  • Build a symbol stream
  • Entropy & mutual information
  • Zipf and Menzerath

Guides

  • The round-trip invariant
  • Spectrograms
  • Tuning segmentation
  • Embeddings (AVES & autoencoder)
  • Repertoire diversity

API reference

  • Index
  • decipher.audio
  • decipher.cluster
  • decipher.stream
  • decipher.featurise
  • decipher.ssl
  • decipher.autoencoder
  • decipher.infotheory
  • decipher.sequence
  • decipher.stats
  • decipher.diversity
  • decipher.catalog

API reference

Every public function and class, organized by module. All public symbols are also re-exported at the top level (from decipher import …).

decipher.audio

Loading, writing, bandpass, resample, spectrograms, energy-based unit detection.

decipher.cluster

Standardise → PCA → HDBSCAN with noise reassignment.

decipher.stream

SymbolStream and session splitting.

decipher.featurise

Mel-patch features, frequency-adaptive FFT parameters, SSL preparation.

decipher.ssl

Frozen AVES wav2vec2 encoder + pooling.

decipher.autoencoder

Convolutional autoencoder embedder + reconstruction.

decipher.infotheory

Shannon entropy, joint/conditional entropy, mutual information, partition alignment.

decipher.sequence

Menzerath, Zipf, n-gram perplexity, transition counts, TP-ratio segmentation.

decipher.stats

KDE modes, permutation tests, RSA, linear CKA.

decipher.diversity

Hill numbers, coverage estimator, bootstrap CI.

decipher.catalog

Query a remote audio corpus and fetch clips as AudioSource objects.