Module: Musa::Neumas::Neuma::Parallel

Includes:
Musa::Neumas::Neuma
Defined in:
lib/musa-dsl/neumas/neumas.rb

Overview

Parallel neuma structure (polyphonic).

Represents simultaneous musical events (multiple voices, chords). Contains array of neuma series in :parallel key.

The shape it takes (a structure, not a runnable example):

{ kind: :parallel,
  parallel: [{ kind: :serie, serie: melody_neumas },
             { kind: :serie, serie: bass_neumas }] }.extend(Parallel)

It is built by #| rather than written out; see there.

Instance Method Summary collapse

Instance Method Details

#|(other) ⇒ Parallel Originally defined in module Musa::Neumas::Neuma

Creates parallel structure with another neuma.

Combines this neuma with another into parallel (polyphonic) structure. If already parallel, adds to existing parallel array.

Examples:

Create parallel from neumas

using Musa::Extension::Neumas  # refinements are per file

# The voices are parallelised as notation. The right operand has to be
# something convertible to neumas -- a String -- so an already parsed
# serie works on the left but not on the right.
harmony = "(0) (+2) (+4)" | "(-7) (-5) (-3)"

harmony[:kind]           # => :parallel
harmony[:parallel].size  # => 2

Chain multiple parallels

using Musa::Extension::Neumas

satb = "(+7) (+9)" | "(+4) (+5)" | "(0) (+2)" | "(-7) (-5)"

# Chaining adds to the existing parallel instead of nesting it.
satb[:parallel].size  # => 4

Parameters:

Returns:

  • (Parallel) —

    parallel neuma structure

Raises:

  • (ArgumentError) —

    if other cannot be converted