More examples and some minor fixes

examples/csound/play_with_csound.py

@@ -1,3 +1,4 @@
+"""Example of using ziffers with Csound score."""
 try:
     import ctcsound
 except (ImportError,TypeError):
@@ -5,30 +6,35 @@ except (ImportError,TypeError):
     
 from ziffers import *
 
+# Csound numeric score is very versatile so it is hard to do generic tranformer
+# See http://www.csounds.com/manual/html/ScoreTop.html and http://www.csounds.com/manual/html/ScoreStatements.html
+
+# There is a simple converter implemented that uses format:
+# i {instrument} {start time} {duration} {amplitude} {frequency}
+# See ziffers_to_csound_score in ziffers/converters.py
+
 if(csound_imported):
 
-    # Parse ziffers notation
-    parsed = zparse("w 0 1 q 0 1 2 3 r e 5 3 9 2 q r 0")
+    # Parse ziffers notation, scale in SCALA format
+    parsed = zparse("w 0 024 q 0 1 2 346 r e (5 3 9 2 -605)+(0 -3 6) q 0h24e67s9^s1^e3^5^7", key="D4", scale="100. 200. 250. 400. 560.")
 
-    # Convert to csound score
-    score = to_csound_score(parsed, 180, 1500, "Meep")
-    
-    # Outputs: i {instrument} {start time} {duration} {amplitude} {pitch}
+    score = ziffers_to_csound_score(parsed, 180, 1500, "FooBar") # 180 bpm, 1500 amplitude, FooBar instrument
+
+    print("Generated score:")
     print(score)
 
+    # Define FooBar Csound instrument
     orc = """
-    instr Meep
+    instr FooBar
         out(linen(oscili(p4,p5),0.1,p3,0.1))
     endin
     """
 
+    # Run score with Csound
     c = ctcsound.Csound()
-    c.setOption("-odac")  # Using SetOption() to configure Csound
-
+    c.setOption("-odac")
     c.compileOrc(orc)
-
     c.readScore(score)
-      
     c.start()                               
     c.perform() 
     c.stop()

examples/jupyter/test_jupylet.ipynb

@@ -0,0 +1,82 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": 10,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "Playing note: 60\n",
+      "Playing note: 67\n",
+      "Playing note: 64\n",
+      "Playing note: 69\n",
+      "Playing note: 65\n",
+      "Playing note: 76\n",
+      "Playing note: 67\n",
+      "Playing note: 64\n",
+      "Playing note: 69\n",
+      "Playing note: 65\n",
+      "Playing note: 62\n",
+      "Playing note: 71\n",
+      "Playing note: 74\n",
+      "Playing note: 65\n",
+      "Playing note: 67\n",
+      "Playing note: 69\n",
+      "Playing note: 64\n",
+      "Playing note: 62\n"
+     ]
+    },
+    {
+     "name": "stderr",
+     "output_type": "stream",
+     "text": [
+      "Stream callback called with status: <sounddevice.CallbackFlags: output underflow>.\n",
+      "Stream callback called with status: <sounddevice.CallbackFlags: output underflow>.\n"
+     ]
+    }
+   ],
+   "source": [
+    "from jupylet.audio.bundle import *\n",
+    "from clockblocks import *\n",
+    "from ziffers import *\n",
+    "\n",
+    "melody = zparse(\"q 0 4 2 5 e 3 9 4 2 s 5 3 1 6 8 3 4 5 2 1\")\n",
+    "bpm = 180\n",
+    "\n",
+    "clock = Clock(initial_tempo=bpm)\n",
+    "\n",
+    "for n in melody.evaluated_values:\n",
+    "    if(isinstance(n, Pitch)):\n",
+    "        print(\"Playing note: \" + str(n.get_note()))\n",
+    "        tb303.play(n.get_note(), n.get_beat())\n",
+    "        clock.wait(n.get_beat())\n",
+    "\n"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python 3",
+   "language": "python",
+   "name": "python3"
+  },
+  "language_info": {
+   "codemirror_mode": {
+    "name": "ipython",
+    "version": 3
+   },
+   "file_extension": ".py",
+   "mimetype": "text/x-python",
+   "name": "python",
+   "nbconvert_exporter": "python",
+   "pygments_lexer": "ipython3",
+   "version": "3.11.0b4"
+  },
+  "orig_nbformat": 4
+ },
+ "nbformat": 4,
+ "nbformat_minor": 2
+}

examples/music21/create_midi_file.py

@@ -1,20 +1,26 @@
 from music21 import *
 from ziffers import *
 
-
 # Create melody string
 melody = "q 0 2 4 r e 1 4 3 2 s 0 1 2 6 e 2 8 2 1 h 0"
-#bass_line = "(q 0 2 4 6 e 1 4 3 2 s 0 1 2 6 e 2 8 2 1 h 0)-7"
+bass_line = "(q 0 2 4 6 e 1 4 3 2 s 0 1 2 6 e 2 8 2 1 h 0)-(7)"
 
 # Parse ziffers notation to melody from string
 parsed = zparse(melody)
-#parsed_bass = zparse(bass_line)
+parsed_bass = zparse(bass_line)
 
-# Convert to music21 object
-s2 = to_music21(parsed, time="4/4")
+# Convert to music21 objects
+part1 = to_music21(parsed, time="4/4")
+part2 = to_music21(parsed_bass, time="4/4")
 
-# Merge melody and bass line
-#s2.append(to_music21(parsed_bass, time="4/4"))
+# Add instruments
+part1.insert(instrument.Piano())
+part2.insert(instrument.Soprano())
+
+# Create score
+song = stream.Score()
+song.insert(0,part1)
+song.insert(0,part2)
 
 # Write to midi file under examples/music21/midi folder
-s2.write('midi', fp='examples/music21/output/ziffers_example.mid')
+song.write('midi', fp='examples/music21/output/ziffers_example.mid')

examples/music21/show_in_musescore.py

@@ -2,7 +2,7 @@ from music21 import *
 from ziffers import *
 
 # Parse Ziffers string to music21 object
-s = to_music21('(i v vi vii^dim)@(q0 e 2 1 q 012)', scale="Lydian", time="4/4")
+s = to_music21('(i v vi vii^dim)@(q0 e 2 1 q 012)', key="d3", scale="Minor", time="4/4", bpm=190)
 
 # See https://web.mit.edu/music21/doc/installing/installAdditional.html
 # Attempt to open / show the midi in MuseScore

examples/sonicsynth/play_with_sonicsynth.py

@@ -0,0 +1,17 @@
+'''Simple example of using SonicSynth to play Ziffers melody.'''
+from sonicsynth import *
+from ziffers import *
+import numpy as np
+
+melody = zparse("(q 0 4 2 5 e 3 9 4 2 s 5 3 1 6 8 3 4 5 2 1 q 0)+(0 3 -2 4 2)", key="E3", scale="Aerathitonic")
+
+def build_waveform(melody, bpm):
+    for item in melody.evaluated_values:
+        if isinstance(item, Pitch):
+            time_in_seconds = item.duration * 4 * 60 / bpm
+            yield generate_square_wave(frequency=item.freq, amplitude=0.25, duration=time_in_seconds)
+
+waveform = np.concatenate(list(build_waveform(melody,130)))
+
+player = Playback(44100)
+player.play(waveform)

examples/sonicsynth/test_arpeggio_effect.py

@@ -0,0 +1,23 @@
+'''Testing arpeggio effect with sonicsynth and ziffers'''
+from sonicsynth import *
+from ziffers import *
+import numpy as np
+
+melody = zparse("(q 0 024 2 246 e 4 2 6 2 q 5 0)+(0 3 1 2)", key="D4", scale="Minor")
+
+def build_waveform(melody, bpm):
+    for item in melody.evaluated_values:
+        if isinstance(item, Pitch):
+            time_in_seconds = item.duration * 4 * 60 / bpm
+            yield generate_sine_wave(frequency=item.freq, amplitude=0.5, duration=time_in_seconds)
+        elif isinstance(item, Chord):
+            time_in_seconds = item.durations[0] * 4 * 60 / bpm
+            for pitch in item.pitch_classes:
+                # Create "NES arpeggio effect"
+                for i in range(1,len(item.durations)):
+                    yield generate_sine_wave(frequency=pitch.freq, amplitude=0.5, duration=time_in_seconds/(len(item.durations)*3))
+
+waveform = np.concatenate(list(build_waveform(melody,180)))
+
+player = Playback(44100)
+player.play(waveform)