Jazz Scale Patterns with Abjad and Lilypond

BackgroundJazz method books often advise students to “learn it in all keys,” yet most present examples in only one or two keys (if that, as they start from C, the easiest key, and usually stop there). For many "classically-trained" players—especially those who check fingerings, enharmonics, and voice-leading by reading—the absence of complete, notated materials is a barrier. While most scales can be internalized as <b>Whole (W) / Half (H)</b> step patterns, important exceptions (e.g., harmonic and melodic minor, octatonic, whole tone, and blues) are aided by having notated patterns in front of us.AimsTo generate clear, consistent <b>notation-first worksheets</b> for common jazz scales <b>in every key</b>; to display each scale’s <b>step pattern</b> beneath the notes; and to automate <b>transposition and engraving</b> so practice and self-checking require no manual setup.This is part of a long-term journey to become fluent in jazz improvisation by incorporating AI to automate the boring parts so I can focus on practicing (and <b>listening</b>).MethodsA generative engraving pipeline -- using GKT (my initials) the author and Chat-GPT5 -- was implemented with <b>Abjad (3.25)</b> for score construction and <b>LilyPond</b> for rendering. Scales are defined once (rooted on C) using W/H patterns, with explicit handling of exceptions (e.g., <b>W+H</b> in harmonic minor; alternating <b>H–W</b> / <b>W–H</b> for octatonic; all-whole steps for whole tone; fixed pitch sets for blues and pentatonics). The program transposes to any pitch class, selects a sensible key signature (major/minor), beams eighths, prints the scale/chord label at bar start, and inserts a system break after every second measure to yield <b>two scales per staff line</b>.EvaluationCorrectness was checked across <b>12 keys</b> by (a) verifying pitch sequences and step labels against scale definitions, (b) confirming first notes begin on beat one with complete measures, (c) inspecting enharmonic spelling under the chosen key signature, and (d) informal practice trials to assess readability and page economy.These 12-key versions are all provided as downloadable and printable scores.ResultsMy tool <b>automatically produces full worksheets per key</b> for major and modes, melodic and harmonic minor, whole tone, octatonic (half–whole and whole–half), blues, and pentatonic scales. Each chart shows two scales per system with embedded W/H patterns, enabling musicians to <b>practice and check their knowledge in every key</b>—addressing a persistent gap in jazz pedagogy where materials rarely show all keys.AcknowledgmentsThis work was inspired in part by the <b>Jamey Aebersold</b> play-along series and its long-standing emphasis on practicing in all keys. His Jazz Handbook is a genius work that should be studied by all musicians (not just those interested in jazz).

研究背景：爵士乐教材通常会建议学习者「在所有调式中练习」，但绝大多数教材仅提供1至2个调的示例——不少教材甚至仅以最简易的C调开篇便就此止步。对于许多接受过古典音乐训练的演奏者而言——尤其是那些通过识谱来核对指法、等音及声部进行的乐手——缺乏完整的记谱材料是一大阻碍。尽管多数音阶可通过<b>全音（W）/半音（H）</b>音程模式内化掌握，但部分重要的例外音阶——如和声小调、旋律小调、八声音阶、全音音阶与布鲁斯音阶——借助直观的记谱模式能更易学习。
研究目标：为所有调式下的常见爵士音阶制作清晰统一、<b>以记谱为核心的练习工作表</b>；将每条音阶的<b>音程模式</b>标注于音符下方；并实现<b>移调与乐谱排版</b>的自动化，免去练习与自我核查时的手动设置步骤。
本项目是实现爵士即兴演奏流畅性的长期规划之一：通过人工智能自动化繁琐的重复性工作，让我能专注于演奏练习（与<b>聆听</b>环节）。
研究方法：本研究搭建了一条生成式乐谱排版流水线——由笔者（缩写为GKT）与Chat-GPT5共同开发——使用<b>Abjad（3.25）</b>构建乐谱框架，<b>LilyPond</b>完成乐谱渲染。音阶以C音为根音，通过W/H音程模式一次性定义，并针对特殊音阶做显式处理：例如和声小调采用<b>W+H</b>结构；八声音阶交替使用<b>H–W</b>与<b>W–H</b>音程模式；全音音阶全部由全音构成；布鲁斯音阶与五声音阶则采用固定音高集合定义。该程序可将音阶移至任意音级，自动选择合理的调号（大调/小调），为八分音符添加连符杆，在小节起始处标注音阶/和弦标签，并每两小节插入一次系统换行，最终实现<b>每条谱行展示两条音阶</b>的排版效果。
效果验证：本研究针对<b>12个标准调式</b>开展正确性校验，具体方式包括：（a）对照音阶定义验证音高序列与音程标注的准确性；（b）确认每条音阶的首个音符均始于第一拍且小节完整；（c）在选定调号下检查等音记谱的合理性；（d）通过非正式练习测试评估乐谱的可读性与页面排版经济性。所有12个调的版本均以可下载、可打印的乐谱形式提供。
研究结果：本工具可<b>自动为每个调生成完整的练习工作表</b>，涵盖大调音阶及其调式、旋律小调、和声小调、全音音阶、八声音阶（半全音与全半音两种形式）、布鲁斯音阶与五声音阶。每张乐谱每页系统展示两条音阶，并附带内嵌的W/H音程模式，帮助乐手<b>在所有调式中练习并核查自身的音阶掌握程度</b>——填补了爵士教学领域长期以来缺乏全调式配套材料的空白。
致谢：本研究的灵感部分源自<b>Jamey Aebersold</b>的伴奏练习系列专辑，该系列长期强调全调式练习的重要性。他所著的《爵士手册》是一部极具开创性的作品，值得所有音乐学习者研读（而非仅局限于爵士爱好者）。