writeSCL: Create a Scala tuning file from a given scale

In musicMCT: Analyze the Structure of Musical Scales

Create a Scala tuning file from a given scale

Description

You mean you don't want to play around in R forever? This function lets you export any scale you've defined in R as a .scl tuning file for use in Scala or by any synth that can read .scl files. Will write to your working directory.

In addition to saving the necessary tuning data, the function will attempt to add as comments extra information that can be derived from MCT functions, like the color number, degrees of freedom, number of sign-vector zeroes, etc.

Usage

writeSCL(x, path, filename, period = 2, ineqmat = NULL, edo = 12, rounder = 10)

Arguments

x	Numeric vector: the scale to export
path	String specifying path where Scala file should be saved. No default and cannot be missing.
filename	String (in quotation marks): what to name your Scala file. Defaults to using the name of x as the file name if you enter nothing.
period	The frequency ratio at which your scale repeats; defaults to 2 which indicates an octave-repeating scale.
ineqmat	Specifies which hyperplane arrangement to consider. By default (or by explicitly entering "mct") it supplies the standard "Modal Color Theory" arrangements of getineqmat(), but can be set to strings "white," "black", "gray", "roth", "infrared", "pastel", "rosy", "infrared", or "anaglyph", giving the ineqmats of make_white_ineqmat(), make_black_ineqmat(), make_gray_ineqmat(), make_roth_ineqmat(), make_infrared_ineqmat(), make_pastel_ineqmat(), make_rosy_ineqmat(), make_infrared_ineqmat(), or make_anaglyph_ineqmat(). For other arrangements, this parameter accepts explicit matrices.
edo	Number of unit steps in an octave. Defaults to 12.
rounder	Numeric (expected integer), defaults to 10: number of decimal places to round to when testing for equality.

Value

Invisible NULL

Examples

neat_pentachord <- convert(c(0, 1, 4, 9, 11), 15, 12)

writeSCL(neat_pentachord, path=tempdir(), "neat_pentachord.scl")

musicMCT documentation built on June 21, 2026, 9:06 a.m.