What Is a Neo-Riemannian Tonnetz, and Why Does Z-Tonnetz Show It in 3D?

Updated

A Tonnetz is a geometric map of harmonic relationships: pitches and chords are placed so that musically close connections sit close together on the grid. Z-Tonnetz (ztonnetz.com) is a browser-based, beta-stage visualization of this idea built on neo-Riemannian theory. It lets you play a MIDI file or your own keyboard and watch chords, voice leading, and key relationships unfold in real time, with 2D, 3D, and torus display modes. The 3D view exists because a flat grid compresses some relationships and hides others; adding depth makes certain voice-leading moves and key shifts easier to see as motion through space rather than as jumps across a page.

What a Tonnetz actually represents

The classic Tonnetz is a lattice of notes. Neighboring positions differ by musically small intervals, so a chord appears as a small cluster of points, and moving from one chord to another means moving across the lattice. Two properties matter in practice:

  • Distance mirrors harmonic distance. Chords that share tones or connect smoothly sit near each other.
  • The grid wraps. Because pitch classes repeat at the octave, the layout is periodic — which is why a torus (a donut shape) is a natural way to draw it without arbitrary edges.

Neo-Riemannian theory supplies the vocabulary for the moves between chords. Instead of describing harmony by roman numerals and function, it describes transformations: for example, a leading-tone exchange swaps one note of a triad to produce a neighboring triad. Z-Tonnetz exposes this directly — its interface includes a Leading Tones toggle alongside Chords, so you can view the transformations rather than only the resulting triads.

Why 3D, and what the display modes are for

The site offers 2D, 3D, and Torus views, and the choice is not cosmetic.

View Best for Trade-off
2D Reading a single progression at a glance; comparing with textbook Tonnetz diagrams Overlapping or distant relationships can be hard to distinguish
3D Seeing voice leading as movement; tracking key relationships that a flat grid separates Requires rotating the view; more visual load
Torus Understanding the wrap-around structure of pitch-class space Less intuitive on first contact

The 3D view is the site's headline feature because voice leading is fundamentally about motion — one voice stepping while others hold. In a flat diagram that motion can look like a leap; in 3D it can read as a short path. The torus option addresses the same problem from the other direction: it removes the false "edges" of a rectangular grid.

How to use it, step by step

  1. Open ztonnetz.com. The page loads in beta with a Free Mode and a sound engine that initializes on load (the page notes the SoundFont load should take under five seconds).
  2. Pick a view. Start in 2D to orient yourself, then switch to 3D once you can identify the triads.
  3. Choose what to watch. Toggle Chords and Leading Tones depending on whether you want the harmonic result or the transformation.
  4. Load music. Use Import MIDI for your own file, or pick from the built-in demo list — it spans Bach (Inventions, WTC preludes, chorales), Beethoven, Debussy, Ravel, Saint-Saëns, Vivaldi, Mozart, and popular material such as a-ha's "Take On Me," Toto's "Africa," Radiohead's "Creep," and game music by Uematsu.
  5. Play and observe. Press Play; the visualization updates in real time. Adjust Speed and Volume, and use Transpose if you want to view the same progression in another key.
  6. Try your own keyboard. Play live to see your chords appear on the lattice — useful for testing whether a progression you wrote behaves the way you expected.
  7. Change the sound. The instrument selector covers Piano, Organ, Guitar, Strings, Brass, E-Piano, Synth, Wind, and a Warm Sine tone; accidentals are entered with ♯, ♮, ♭.

Verification: after importing a MIDI file, confirm the note names shown match the score and that the highlighted chord clusters change at the expected moments. If the visualization looks static, check that playback is running and that the file contains note events rather than only tempo or program changes.

Common sticking points

  • The 3D view is disorienting at first. Learn two or three reference triads in 2D, then rotate the 3D view until those clusters are recognizable.
  • Dense music is hard to follow. Start with a slow, triad-based piece — a Bach chorale or a Prelude — before trying something chromatic like "Clair de Lune."
  • The torus is not a beginner view. Treat it as a second pass after the flat grid makes sense.
  • Beta status. The page labels the app as beta, so expect rough edges; nothing on the page indicates a paid tier or a login requirement, but that is simply what the page shows, not a guarantee about future access.

Who this is for

Z-Tonnetz suits theory students meeting neo-Riemannian concepts for the first time, composers checking voice leading in a progression, and teachers who want a live visual aid during a lesson. It is less suited to someone looking for notation playback or score editing — the tool is a harmonic map, not a sequencer. If you only need to hear a MIDI file, a standard player is simpler; the reason to use this site is to see the harmonic geometry while you listen.