sonic-weave

SonicWeave is a Domain Specific Language for manipulating musical frequencies, ratios and equal temperaments.

Not to be confused with the Sweave flexible framework for mixing text and R code for automatic document generation.

Package overview

The sonic-weave package is many things.

- The language of Scale Workshop 3
- Basic level
- Intermediate level
- Advanced level
- Built-in reference
- A command-line interface for calculating musical quantities
- A TypeScript compatible npm package
- A template language for running SonicWeave programs inside JavaScript
- An interchange format (extension .swi)

You may also be interested in the technical overview of SonicWeave as a programming language.

Appendix: tempering, commas

Highlights

Harmonic segment from the 8th harmonic to the 16th (repeating at the octave).
``ocaml
8::16
`

10-tone equal temperament
`ocaml
tet(10)
`

The major scale in Pythagorean tuning i.e. 3-limit just intonation.
`ocaml
sort(3^[-1..5] rdc 2)
`

Scale title, colors and labels.
`ocaml
"Japanese pentatonic koto scale, theoretical. Helmholz/Ellis p.519, nr.110"

9/8 white "Major 2nd"
6/5 green "Minor 3rd"
3/2 white "Perfect 5th"
8/5 green "Minor 6th"
2 gray "Root & Octave"
``

Additional resources

* Xenharmonic Wiki

Special thanks

* Arseniiv A. - Co-developer / Language feedback
* Inthar - Co-developer / Language feedback
* Akselai - Quality assurance
* Godtone - Notation adviser / Language feedback
* Joe Hildebrand - Grammar review
* Marc Sabat - Notation adviser

Acknowledgments / inspiration

SonicWeave looks like Javascript with Python semantics, has Haskell ranges and operates similar to xen-calc with some Zig sprinkled on top.

* ECMAScript - Brendan Eich et. al.
* Python - Guido van Rossum et. al.
* Haskell - Lennart Augustsson et. al.
* Zig - Andrew Kelley et. al.
* OCaml - Xavier Leroy et. al.
* NumPy - Travis Oliphant et. al.
* Scala - Manuel Op de Coul
* Scale Workshop 1 - Sean Archibald et. al.
* SQL - Donald D. Chamberlin et. al.
* FJS - "misotanni"
* NFJS - Matthew Yacavone
* Xen-calc - Matthew Yacavone
* Xenpaper - Damien Clarke
* Ups and downs notation - Kite Giedraitis
* S-expressions - "Godtone"
* Peg.js - David Majda et. al.
* Peggy - Joe Hildebrand et. al.
* Xenharmonic Wiki - (community project)
* Xenharmonic Alliance - (community Discord / Facebook)