Examples#

Every page here is a notebook you can run. They are grouped by what you are trying to do rather than by which module does it.

If you are new, start with Peaks extraction methods — almost everything else begins with a set of spectral peaks.

Start here#

Peaks extraction

Five ways to find the frequencies that matter in a signal, and how much they disagree.

Peaks extraction methods
Plotting

The visualisation API, walked through on rich synthetic signals.

Plotting and visualization with biotuner
Harmonicity metrics

How harmonic is a set of peaks? The measures, side by side.

Harmonicity metrics

Signals and spectra#

From an MNE epochs file

Harmonicity metrics computed straight off an existing MNE object.

Harmonicity Metrics Computation on MNE Epochs File
The harmonic spectrum

Harmonicity across the whole spectrum, not only at the peaks.

From Spectral Peaks to Harmonic Spectrum Analysis
Mathematical series

Which classic series — Fibonacci, primes, powers — does a signal follow?

Matching biosignals to mathematical series
Resonance cookbook

A practical tour of resonance, harmonic spectrum and connectivity.

Resonance & Connectivity Cookbook
Phase-amplitude coupling

Comodulograms: which phase drives which amplitude, and how strongly.

Phase-Amplitude Coupling

Music from signals#

Tunings from biosignals

Turning a recording’s peaks into a playable scale.

Constructing musical tunings with biosignals
Moment-of-symmetry scales — the short tour

From the piano’s white keys to fitting a scale to a biosignal, with audio. Start here for MOS.

Moment-of-symmetry scales — the short tour
Moment-of-symmetry scales — the full tour

The labyrinth in depth: modes, temperaments, just intonation, trajectories, Fourier scratching.

Moment-of-symmetry scales, and finding them in a biosignal
The MOS explorers

Ten interactive widgets. Drag a generator and watch the scale follow.

The MOS explorers, old and new
Spectral chords

Chords derived from the spectrum of a biosignal.

Deriving spectral chords from biosignals
Euclidean rhythms

Pulses distributed as evenly as a step count allows, driven by a signal.

Constructing euclidian rhythms from biotunings

Harmonic geometry#

Chords rendered as shape: closed-form curves, eigenmodes, and the metrics that compare them.

Lissajous and harmonograph

Closed-form figures and damped harmonograph traces.

Lissajous and harmonograph curves
Chladni and spherical harmonics

Eigenmodes of the wave equation on a bounded medium.

Chladni plates and spherical harmonics
Circles, polygons and cycloids

A ratio set wrapped onto a circle, once per equave.

Tuning circles, polygons, and cycloids
Fractals and L-systems

Deterministic fractal and generative layouts.

Fractal layouts and generative L-systems
Three dimensions

Harmonic knots and other 3-D generators.

3-D harmonic geometry
Metrics and transitions

Comparing geometries, and morphing one chord into another.

Geometry metrics and chord transitions
Chladni cymatics

Sand on a square plate, driven by a chord.

Chladni cymatics — chord-driven nodal patterns

Media — chord-driven response operators#

Give a physical medium a chord and see what it does.

Protocol, domains and pipelines

How a medium is defined, and how media chain together.

The media subpackage: medium protocol, domains, pipelines
Eigenmode and wave field

Standing waves on plates, spheres, crystals and pressure fields.

Eigenmode and wave-field media
Parametric and transport

Faraday instability, granular density, streamlines, streaming.

Parametric and transport media
Morphogenetic

Snowflake growth and Gray–Scott patterns shaped by a chord.

Morphogenetic media — pattern growth shaped by chords

Colour and matter#

Bio-colour

A signal’s spectrum, or a tuning’s ratios, turned into a palette.

biocolors — deriving colour from a biosignal
Bio-elements

From a biosignal to the periodic table, and on to materials.

bioelements — from biosignals to the periodic table, and to materials

The toolbox paper#

Design and implementation

The examples that accompany the paper.

Biotuner Paper Design and Implementation Examples
Result figures

The figures, reproduced end to end.

Biotuner Toolbox Paper Results Figures