Skip to content

Usage Examples

David Garfinkle edited this page Dec 11, 2019 · 31 revisions

Entering a query

Music queries are submitted in **kern format using the text editor. To understand how to write **kern, check out their guide.

When you first load a page, the text editor will load with a default **kern template.

You can start typing your notes below the template, and they will show up interactively on-screen:

Note: queries must be at least four notes long.

Using filters

There are three filters currently implemented that can expand or reduce your search results

Transpositions

By default, only occurrences of the same chromatic pitch will match our query. We can expand the transposition filter to find occurrences that are chromatically transposed.

For example, consider:

The occurrence seen above corresponds to the exact chromatic pitches of our query.

If we bump up the transposition filter, we can find a new occurrence transposed upwards by 5 semitones:

Intervening Notes

Sometimes, we do find all of our query, but there are some extra notes in the score obscuring what we're looking for.

An "intervening note" filter will ignore occurrences with too noise obscuring our query.

For example, here's an occurrence with one intervening note, namely the passing B in the alto voice:

For a second example, consider a query of three parallel fifths over the bach chorales. Notice there are no occurrences with a filter of 0 intervening notes.

However, if we relax our constraint and allow a bit of polyphonic texture, we'll get to see some parallel fifths:

Inexact Matches

Sometimes, we find only a partial match of the query; some of the pitch content is there, but not all of it. This filter controls for how many notes we want to find.

Clone this wiki locally