noon.lib.harmony — org.clojars.pbaille/noon 0.1.2

Harmony related utilities

->pitch-update clj

(->pitch-update x)

abstract-drops clj

(abstract-drops x & [include-inversions])

Get a list of abstract drops for x. An abstract-drop is a vec of the form [[first-octave-degree...][second-octave-degree...]...] e.g a drop 2 for a tetrad can be represented as [[0 2 3][1]] x can be either:

• a natural number indicating the number of notes.
• a sequence of numbers representing different notes.

align-contexts clj

(align-contexts)

(align-contexts layer)

(align-contexts layer mode)

align successive harmonic contexts based on the given 'layer: :tonic (:t) | :structural (:s) | :diatonic (:d) | :chromatic (:c)

can also take a second argument 'mode: :incremental | :static that stays if the alignement is done on the first chord only or incrementally.

bounds-gte clj

(bounds-gte [a b] [c d])

Check if bounds [a b] contains bounds [c d].

closed clj

Put a chord into closed position. Bring every notes within the octave following the bass note. If some notes have the same pitch class, it can produce unisons.

closed-no-unison clj

Put a chord into closed position. Starting at bass note, bring every other notes as close as possible above it.

drop clj

(drop x)

Build an update that produce a drop of the received score (that is expected to represent a chord). x is a member-pick argument that is used to pick a drop from the complete list of possible drops. refer to noon.utils.sequences/member for complete documentation

drops clj

Computes all possible drops of the given score (that is supposed to represent a chord). The :inversions option can be given to include inversions and their drops.

grid clj

(grid & xs)

Build an update that applies an harmonic grid to the received score. The harmonic grid is created by threading a fresh score through the sequence of update xs. e.g (noon.score/mk* xs). The resulting score (which represent an harmonic grid) is zipped over the received score, All harmonies are applied accordingly to their position and duration.

grid* clj

(grid* xs)

Build an update that applies an harmonic grid to the received score. The harmonic grid is created by threading a fresh score through the sequence of update xs. e.g (noon.score/mk* xs). The resulting score (which represent an harmonic grid) is zipped over the received score, All harmonies are applied accordingly to their position and duration.

grid-zipped clj

(grid-zipped & xs)

zip the current score (which should represent an harmonic grid) to the resulting of applying 'xs updates to a fresh score.

grid-zipped* clj

(grid-zipped* xs)

zip the current score (which should represent an harmonic grid) to the resulting of applying 'xs updates to a fresh score.

harmonic-zip clj

(harmonic-zip grid content)

Build an update that zip a grid score over a content score. grid score and content score are just regular scores, but they are representing different things. grid score is representing an harmonic grid, and content score represents what is happening over those harmonies.

Two arguments are expected:

• grid is an update that will be applied to the received score in order to produce the grid score.
• content is an update that will be applied to received score in order to produce the content score.

Once those two scores are built, the harmonies of the grid score will be applied to the content score accordingly to their position and duration.

in-bounds clj

(in-bounds bounds s)

Check if the score s is within given pitch bounds.

inversion clj

(inversion n)

Build an update that produce an inversion of the received chord (score). x is an integer that correspond to the index of the desired inversion.

• negative x picks the nth downward inversion
• positive x picks the nth upward inversion.

inversions clj

compute downward and upward inversion of the given chord (score). return a map containing

• :self, the received chord (score)
• :upward, the list of upward inversions
• :downward, the list of downward inversions.

lin clj

(lin & xs)

Build an update similarly to noon.score/lin but interpret keywords using noon.parse.harmony.

lin* clj

(lin* xs)

Build an update similarly to noon.score/lin but interpret keywords using noon.parse.harmony.

modal-structure clj

(modal-structure size)

Build an event update that change the harmonic structure of the received event to its N (size) most characteristic degrees. The table of degree priority for known modes is available as noon.constants/degree-priority.

pitch-values clj

(pitch-values chord)

Returns a sorted vector of all pitch-values in chord (score).

simple-chord clj

Build a structural chord on top of received event.

tup clj

(tup & xs)

Build an update similarly to noon.score/tup but interpret keywords using noon.parse.harmony.

tup* clj

(tup* xs)

Build an update similarly to noon.score/tup but interpret keywords using noon.parse.harmony.

upd clj

(upd & xs)

voice-led clj

Apply voice leading to the received score.

VOICE_LEADING_MAX_SHIFT clj

The maximal step that can occur betwwen extreme voices of a voice leading.

voicings clj

(voicings s {:as _opts :keys [bounds]})

Computes a list of possible voicings for the given chord (score s). The second argument is an option map that contain:

• :bounds, a vector of the form [lowest-pitch-value highest-pitch-value]