Module:Ups and downs notation

Module documentation[view] [edit] [history] [purge]

This module should not be invoked directly; use its corresponding template instead: Template:Ups and downs note name.

This module gets the note name of an edo interval in ups and downs notation.

Introspection summary for Module:Ups and downs notation
Functions provided (2) Line Function Params 36 get_note_names (tuning) 121 get_specific_note_name (tuning, steps)	Lua modules required (2) Variable Module Functions used et Module:ET parse approximate rat Module:Rational new

No function descriptions were provided. The Lua code may have further information.

---

-- WIP

local et = require('Module:ET')
local rat = require('Module:Rational')
local p = {}

-- Returns a nested table of note names
-- e.g. for 12edo, intended result would be something like:
-- {
--	0 = {"C"},
--	1 = {"Db"},
--	2 = {"D"},
--	3 = {"Eb"},
--	4 = {"E"},
--	5 = {"F"},
--	6 = {"F#", "Gb"},
--	7 = {"G"},
--  8 = {"Ab"},
--  9 = {"A"},
--  10 = {"Bb"},
--  11 = {"B"},
--  12 = {"C"}
-- }

local function table_contains(tbl, x)
    found = false
    for _, v in pairs(tbl) do
        if v == x then 
            found = true 
        end
    end
    return found
end


function p.get_note_names(tuning)
	tuning = et.parse(tuning)
	local note_names = {}
	local i = 0
	while i < tuning.size do
		note_names[i] = {}
	end
	
	local fifth = et.approximate(tuning, rat.new(3, 2))
	local fourth = et.approximate(tuning, rat.new(4, 3))
	local chroma = (fifth * 7) % et.size
	
	local major_note_idx = {
		0, 
		(fifth * 2) % tuning.size,
		(fifth * 4) % tuning.size,
		fourth,
		fifth,
		(fifth * 3) % tuning.size,
		(fifth * 5) % tuning.size,
		tuning.size
	}
	
	-- Add major scale notes
	table.insert(note_names[major_note_idx[1]], "C")
	table.insert(note_names[major_note_idx[2]], "D")
	table.insert(note_names[major_note_idx[3]], "E")
	table.insert(note_names[major_note_idx[4]], "F")
	table.insert(note_names[major_note_idx[5]], "G")
	table.insert(note_names[major_note_idx[6]], "A")
    table.insert(note_names[major_note_idx[7]], "B")
    table.insert(note_names[major_note_idx[8]], "C")
	
	-- temporary
	mw.logObject(note_names)
	
	-- Add sharp/up notes
	i = 0
	local last_major_note = 0
	while i < tuning.size do
		if table_contains(major_note_idx, i) then
			last_major_note = i
		else
			local num_sharps = math.floor((i - last_major_note) / chroma)
			local num_ups = (i - last_major_note) % chroma
			local name = interval_names[last_major_note]
			local j = 0
			while j < num_sharps do
				name = name + "#"
			end
			j = 0
			while j < num_ups do
				name = "^" + name
			end
			table.insert(note_names[i], name)
		end
		i = i + 1
	end

	-- Add flat/down notes
	i = tuning.size - 1
	local last_major_note = tuning.size - 1
	while i >= 0 do
		if table_contains(major_note_idx, i) then
			last_major_note = i
		else
			local num_flats = math.floor((last_major_note - i) / chroma)
			local num_downs = (last_major_note -i) % chroma
			local name = interval_names[last_major_note]
			local j = 0
			while j < num_flats do
				name = name + "b"
			end
			j = 0
			while j < num_downs do
				name = "v" + name
			end
			table.insert(note_names[i], name)
		end
		i = i - 1
	end
	
	return note_names
end

function p.get_specific_note_name(tuning, steps)
	tbl = p.get_note_names(tuning)[steps]
	result = ''
	i = 0
	while i < #tbl do
		result = result + tbl[i] + ','
	end
	result = result:slice(0, result.len() - 1)
end

return p