Tune Generator

Purpose & User Intent:\nThe tool is a web-based tune generator that produces algorithmically derived tuning presets and frequency layouts for musical instruments, audio production, and educational settings. Primary users include composers, sound designers, instrument technicians, and educators who need reproducible tunings across projects or need to explore microtonal scales. Assumption: users seek scalable, exportable tuning data for downstream use in devices, synthesizers, or DAWs.\n\nCore Logic & Features:\nDomain capabilities include selecting a root frequency, a temperament, a frequency range, and the number of steps; it computes frequencies and optional note labels. Required features: root_frequency (Hz), temperament (e.g., equal, just, microtonal), range_min (Hz), range_max (Hz), steps (int). Advanced features: microstep (fractional step size), custom scales, seed for reproducible results, batch export. The tool supports 12-TET by default, just intonation ratios, and user-defined microtonal grids.\n\nInputs & Outputs:\nInputs include root_frequency (Hz, float, sample 440.0), temperament (string), range_min (Hz), range_max (Hz), steps (int). Optional: seed (int), microstep (float). Outputs: frequencies (array of Hz), optional note_labels, and scale_names. Frequencies are formatted to two decimal places; outputs can be exported as JSON or CSV.\n\nAlgorithms & Calculations:\nIf temperament is equal, f(n) = f0 * 2^(n/12). For just intonation, frequencies derive from standard ratios per the chosen scale. Microtonal grids use fractional steps; if microstep=0.5, 24-TET-like spacing is generated. Ranges prune values outside [range_min, range_max]. When seed is provided, results are reproducible.\n\nError & Edge Cases:\nInvalid or missing inputs (non-positive root_frequency, non-positive steps, inconsistent range) raise explicit domain errors. If range_min > range_max, or required fields are absent, calculation is halted. Out-of-range frequencies (below 20 Hz or above 20 kHz) are discarded with no result. External data references are optional and retried on failure.\n\nIndustry/Region & Localization:\nUnits use Hz for frequencies; note naming follows Western pitch conventions unless overridden by user scale. Support for locale-agnostic numeric formatting; export schemas are designed for cross-region integration.\n\nAssumptions & Exclusions:\nAssumes a conventional Western temperament framework as the baseline unless overridden. It does not perform audio synthesis or playback; it focuses on data generation for presets and downstream integration.