total-serialism/src/database.js

A set of methods for the generation and transformation of number sequences useful in algorithmic composition

//==============================================================================
// database.js
// part of 'total-serialism' Package, used for the build process
// by Timo Hoogland (@t.mo / @tmhglnd), www.timohoogland.com
// MIT License
//
// Build the databases of notes and other values used for the library
// as JSON files
// 
// credits:
// - Using the amazing Tonal.js package by @danigb for various functions
// - Using jsonFile package for beautiful JSON files
//==============================================================================

const fs = require('fs-extra');
const fg = require('fast-glob');
const path = require('path');

const TL = require('./translate.js');
const Algo = require('./gen-complex');
const { Note } = require('@tonaljs/tonal');

// Build the databases
buildNoteSet('data/tones.json');
buildIntegerSequences('data/fibonacci.json');
buildScalaSet('data/scldb.json', 'data/scl');

// Build a database of most common Notenames and their
// corresponding relative semitone value
// 
// @param {String} -> relative file name + folder
// @return {Void}
// 
function buildNoteSet(f){
	let notes = 'c d e f g a b'.split(" ");
	notes = notes.concat('c d e f g a b'.toUpperCase().split(" "));
	let accidentals = 'bb b # ## x'.split(" ");
	
	let tones = {};
	for (let n in notes){
		tones[notes[n]] = Note.chroma(notes[n]);
		for (let a in accidentals) {
			let key = notes[n] + accidentals[a];
			tones[key] = Note.chroma(key);
		}
	}
	fs.writeJsonSync(f, tones, { spaces : 2 , EOL: '\r\n' });
	console.log('NoteSet database written succesfully');
}

// Build the integer sequences dataset for quick access of
// Fibonacci, Pell and Tribonacci numbers
// 
// @param {String} -> relative file name + folder
// @return {Void}
// 
function buildIntegerSequences(f){
	let data = { 
		"fibonacci" : [], 
		"pell" : [],
		"tribonacci" : []
	}
	data.fibonacci = Algo.fibonacci(1024);
	data.pell = Algo.pell(1024);
	data.tribonacci = Algo.threeFibonacci(1024);
	
	fs.writeJsonSync(f, data, { spaced: 2, EOL: '\r\n' })
	console.log("Integer Sequences dataset written succesfully");
}

/* WORK IN PROGRESS

const { ScaleType } = require('@tonaljs/tonal');
const { Interval } = require('@tonaljs/tonal');

// Build a database of the scales used for mapping relative
// semitone values to a value fitting in the scale
// 
function buildScaleSet(){
	let scale = ScaleType.get("whole tone");
	console.log(scale);
	
	for (let i in scale.intervals){
		let iv = Interval.get(scale.intervals[i]);
		let semitones = iv.semitones;
		let ivName = iv.name;
		let ivNum = iv.num;
		let ivQ = iv.q;
		
		console.log(ivName, ivNum, ivQ, semitones);
	}
}
*/

// Build a database of all the .scl files included in the /scl folder
// 
// @param {String} -> relative file name + folder
// @return {Void}
// 
function buildScalaSet(f, fold){
	// create instance of Scala class
	let scl = new TL.Scala();
	// get array of all .scl files
	let files = fg.sync(fold+"/**/*.scl", { extglob: true });
	
	let dataBase = {};
	files.forEach((f) => {
		let file = path.parse(f);
		scl.parse(fs.readFileSync(f, 'utf8'));
		dataBase[file.name] = scl.data;
	});

	fs.writeJsonSync(f, dataBase, { spaces: 0 });

	// let buf = Buffer.from(JSON.stringify(dataBase), 'utf8');
	// let b64 = buf.toString('base64');
	// fs.writeFileSync('data/scl.min.txt', b64);

	console.log("Scala database parsed and written succesfully");
}