Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

はじめに

English version

Conchordalは、生成的な作曲のための心理音響楽器です。Rhaiは、この楽器にシナリオを 与えるための言語であり、音符を順番に並べるためのものではありません。音から Consonance Fieldをつくり、複数のVoiceがその中を移動し、生き残り、世代を重ねながら Populationを再編成します。

シナリオでは、まずPopulationSpecを定義します。それをplace()で配置すると、 世代交代を通じて同一性を保つPopulationになります。Populationを構成する一個の 生きた要素がVoiceです。同じLandscapeを共有するすべてのPopulationを合わせたものを Communityと呼びます。和声は心理音響的なroughnessとharmonicityから生まれ、 リズムはCommunity自身が駆動する共有拍の上で創発します。スクリプトの役割は、音符を並べる シーケンサーではなく、全体の条件と流れを整える演出者です。

Conchordal v0.5.0は、こうしたコンセプトを直接検討したい研究者と開発者のための Alpha版です。機能は未完成で、不安定な場合があります。作曲家や制作者は Beta版を待ってください。一般的な音楽制作の語彙で覆い隠さず、このモデル固有の 言葉で説明します。

本書の構成

本書のすべてのrhaiコードブロックは、テストスイートによって実際の スクリプトengine上で実行されます。これにより、現在のengineでcompile・実行 できることを確認します。ただし、説明文の意味まで自動的に証明するものではありません。

クイックスタート

リアルタイムinstrumentでシナリオを実行します。DSP性能のためrelease modeを推奨します。

cargo run --release -- samples/01_a_single_voice.rhai

最小の音

place(sine().amp(0.08).sustain(), at(440.0));
wait(2.0);

place(population_spec, placement)は、現在のスクリプト時刻にPopulationをただちに配置します。 返されたPopulationへの参照を使うと、実行中のPopulationを更新したり終了したりできます。

基本オブジェクト

  • PopulationSpecは、初代として生成されるVoiceとPopulation全体の方針を記述します。 sine()、harmonic()、modal()、saw()、square()、noise()から始めます。
  • Variantはpopulation_specでspecificationを複製します。
  • PlacementはPopulationをどこへ配置するかを決めます。協和、不協和、その境界、空いた音域を consonance()、dissonance()、edge()、gap()で選べます。既定では候補を確率分布として 扱い、.peak()を付けると最も強い一点を選びます。ほかにrandom()、at()、line()があります。
  • Populationはplace()が返す安定した参照です。この時点で初代のVoiceが 存在し始め、実行中に使えるメソッドは現在のVoiceを更新します。
  • SectionはPopulationの有効範囲を定め、終了時に自動で解放します。

Populationは、配置後も同一性を保つ一つの安定した参照です。.count(6)を指定したPlacementでは、 そのPopulationに6つの初代のVoiceが生まれます。後でVoiceが死亡して再生成されても、構成員と世代が 変わるだけでPopulationの同一性は保たれます。詳しいオブジェクト構造と生存過程は Population — Voiceをまとめる持続単位を参照してください。

let population_spec = harmonic()
    .amp(0.08)
    .sustain()
    .brightness(0.35);

section("plain entry", || {
    place(population_spec, line(220.0, 440.0).count(3));
    wait(4.0);
});

Consonance Fieldへ配置する

consonance(root_hz).peak()は、基準周波数の周辺で協和の評価が高い位置へVoiceを 配置します。Fieldはsystemが知覚したものによって形づくられるため、anchorが入ると peakの位置も変わります。

let anchor = harmonic()
    .brain("drone")
    .amp(0.06)
    .sustain()
    .anchor();

let voice = harmonic()
    .amp(0.04)
    .sustain();

section("field placement", || {
    place(anchor, at(110.0));
    wait(1.0);

    place(voice, consonance(110.0).peak().range(1.0, 4.0).count(6).spacing(0.9));
    wait(6.0);
});

Consonance Fieldの働きと、その中でVoiceが移動し、生き残り、再生成される仕組みは Consonance Field — 音高を評価する地形で説明します。

実行中のPopulationを更新する

発音体、振る舞い、生存過程、再生成の方針は、place()より前にPopulationSpecへ設定します。 返されたPopulationには、配置後に意味を持つ操作、つまり実行中の更新と終了だけが 公開されます。APIリファレンスには、両者のメソッドが区別して 表示されます。

let spec = harmonic().amp(0.04).sustain();
let population = place(
    spec,
    consonance(220.0).peak().count(3)
);
population.amp(0.02); // live patch on running voices
population.glide(0.8);
wait(3.0);
release(population);

完成した小品

seed(7);

let anchor = harmonic()
    .brain("drone")
    .amp(0.05)
    .sustain();

let colony = harmonic()
    .amp(0.035)
    .sustain()
    .seek_consonance()
    .glide(0.4)
    .avoid_neighbors(0.6);

section("emergence", || {
    place(anchor, at(110.0));
    wait(2.0);

    place(colony, consonance(90.0, 900.0).count(8).spacing(0.8));
    wait(8.0);
});

次に読む章

演奏前にスクリプトを確認する

cargo run --release -- samples/01_a_single_voice.rhai --compile-only

--compile-onlyはRhaiスクリプトを評価し、シナリオを検査します。音声とGUIは起動しません。 ループ、クロージャ、スクリプト中の出力は実行します。末尾のWarnings: Nが警告の件数です。 警告には入力位置と無視された設定の理由が出ます。組み合わせを修正するか、効かない指定を 外してください。不正な選択肢はエラーで停止します。選択肢は小文字の正規名を使い、 大文字、別名、前後の空白は受け付けません。

エディタ設定(LSP)

Conchordalには、名前を持つ呼び出し可能なスクリプティングAPIとhover documentationを 記述したRhai LSP定義ファイルが付属します。対応するclientへ接続すると、place、 harmonic、.brain()、.send(habitat_bus)などでcompletion、hover、定義への移動、 diagnosticsを利用できます。busを結合する| overloadは名前付き宣言ではなくoperatorなので、 定義ファイルには出力されません。

repository rootにある次の2ファイルが設定の中心です。

  • Rhai.toml — rhai-lspが読むworkspace設定
  • rhai-defs/conchordal.d.rhai — doc comment付きの自動生成type/function宣言

upstreamのrhai-lspは、自らをexperimentalかつ incompleteとし、一般利用を推奨していません。保証されたproduction toolingではなく、 任意の開発補助として扱ってください。それでも使う場合は、crates.ioにはないため git repositoryから直接installします。

cargo install --git https://github.com/rhaiscript/lsp rhai-cli

これにより、lsp subcommandを持つrhai binaryが生成されます。

VS Code

公式Rhai extension が現在提供するのはsyntax highlightだけで、rhai-lspは起動しません。LSP機能には、 Conchordal workspaceから次のcommandを起動できるLSP client/extensionを使います。

rhai lsp stdio --config Rhai.toml

Neovim 0.11以降

vim.lsp.config("rhai", {
  cmd = { "rhai", "lsp", "stdio", "--config", "Rhai.toml" },
  filetypes = { "rhai" },
  root_markers = { "Rhai.toml", ".git" },
})
vim.lsp.enable("rhai")

Helix

~/.config/helix/languages.tomlへ追加します。

[[language]]
name = "rhai"
scope = "source.rhai"
file-types = ["rhai"]
language-servers = ["rhai-lsp"]

[language-server.rhai-lsp]
command = "rhai"
args = ["lsp", "stdio", "--config", "Rhai.toml"]

Emacs(eglot)

(add-to-list 'eglot-server-programs
             '(rhai-mode . ("rhai" "lsp" "stdio" "--config" "Rhai.toml")))
(add-hook 'rhai-mode-hook #'eglot-ensure)

定義ファイルを再生成する

定義ファイル、英語版API Reference、日本語版 APIリファレンスは、engineのregister_fn surfaceと documentation registry(src/scripting/docs.rs)を結合して生成されます。 新しいConchordal versionを取得した後にdiagnosticsが欠ける場合は、すべてを再生成します。

cargo run --bin gen_rhai_defs

commit済みartifactが古いとCI testが失敗します。これは登録signatureと生成textを検査しますが、 editor上の挙動はexperimentalなupstream serverとclient設定にも依存します。

演奏

クイックスタートでは、最小のscenarioを書いて実行するところまでを 説明しました。本章では、リアルタイムinstrumentを起動して演奏を始める、終了する、 GUIなしで演奏する、その結果を記録・再現する、という一連の手順を説明します。

GUIで演奏する

リアルタイムinstrumentでscenarioを起動します。

cargo run --release -- samples/10_generations.rhai

scenarioをcompileした後にGUIが開き、初期設定では自動的に演奏が始まります。scriptが 大まかな時間構造を与えます。place()がPopulationを導入し、wait()がscript上の時刻を進め、 section()とplay()は内部で作ったPopulationを有効範囲の終了時にreleaseします。その間も、 Voiceの振る舞い、Landscape、それらのfeedbackはリアルタイムに変化し続けます。

進行バーはscenario上の時刻を表示します。演奏中は、その右側にあるボタンを押すと 演奏を終了します。ウィンドウを閉じるかCtrl-Cを押しても終了します。このボタンは一時停止では なく、GUI上でscriptを実行中に書き換えることもできません。scenarioを変更するときは、演奏を終了し、 Rhai fileを編集して、もう一度起動します。

GUIを先に用意し、合図に合わせて開始するには--wait-user-startを付けます。準備ができたら Spaceを押すか、開始ボタンをクリックします。

cargo run --release -- samples/10_generations.rhai --wait-user-start

scenarioが終わっても、初期設定では最終状態を確認できるようにGUIが残ります。進行バー 右端のボタンまたはウィンドウの閉じるボタンで終了します。scenarioの終了と同時に閉じるには --wait-user-exit=falseを付けます。

GUIなしで演奏する

--noguiを付けると、すぐに演奏を始め、scenarioの終了時にプログラムも終了します。GUIは 表示しませんが、初期設定では既定の音声出力先から音を出します。

cargo run --release -- samples/10_generations.rhai --nogui

音を出さず、simulationやreport作成だけを行う場合に限り--play=falseを使います。

cargo run --release -- samples/10_generations.rhai --nogui --play=false --report run.jsonl

--noguiでは、開始待ちと終了待ちの両方が無効になります。offline WAV出力は別の操作で、 conchordal-renderが担当します。リアルタイムinstrumentであるconchordalはaudioを 記録しません。

聴く・確かめる・修正する

scenarioは、どのPopulationをいつ配置し、どのような方針で振る舞わせるかを指定します。 ただし、演奏中の正確な音高、リズム同期、生存、respawnの結果までは事前に決まりません。 それらは、変化し続けるLandscapeとの相互作用から生まれます。scenarioを実行して聴き、 実際に起きたことを確かめ、scriptを修正して、もう一度実行します。

instrumentであるconchordalは、どのbuild profileでもaudioをdiskへ書きません。 演奏は、音が鳴り終わるとinstrument内には残らない一過的な出来事(ephemeral)として 設計されています。

演奏を再現する

各runはseedをlogへ出します。

scenario seed: 3821650944810716341 (replay with --seed 3821650944810716341)

最上位のサンプルは毎回新しいseedから始まり、一つの固定結果ではなくsystemのvariationを 示します。残したいrunが得られたら、表示された値で正確に再現します。

cargo run --release -- samples/10_generations.rhai --seed 3821650944810716341

conchordal-renderでも同じ--seedを使い、保存した演奏をWAVにできます。 script内のseed(...)は実行中に初期seedを上書きするため、常にcommand-line flagより優先します。 呼び出し方に関係なくscript自体を再現可能にする必要がある場合だけ使ってください。

レポート

--reportへ書き込み先を指定して実行します。

cargo run --release -- samples/10_generations.rhai --report run.jsonl

--reportはconchordal instrumentのflagで、--noguiでも動作します。 audioを描画するconchordal-renderにはありません。

fileはJSON Linesで、1行が1 record、type fieldで種類を示します。

  • meta — 最初に記録される有効なscenario seed。
  • scene_marker — 各section("name", || { ... })の開始位置。以後のrecordを直前の markerごとにまとめられます。
  • spawn / respawn / death — Voiceごとの世代交代。出現周波数、親となるVoice、 設定寿命、energy枯渇時刻、envelope tailを含む観測寿命、初期consonance、死亡時PLV。
  • onset — Voiceごとの発音開始時刻、強度、周波数、位相同期、足場の状態。
  • population_step — 再生成待ちのalive_count: 0も含むPopulation size、 平均周波数、Consonance Field score/level、周波数entropy。
  • listener_state — ListenerTwinの4つの知覚level、beat/subdivision/measure追跡、解析遅延。
  • rhythm_observation — Community全体の瞬間的なKuramoto orderと環境rhythm state。 rhythm_summary — Community全体およびPopulationごとのonset density、IOI規則性、 burstiness。Kuramoto summaryはCommunity全体にだけ付きます。
  • listener_confidence_summary — beat confidenceのpeakと終盤window。
  • dcc_pressure — listener由来のtension pressureとDCCが加えたpitch temperature bonus。
  • phonation_gate_open — phonation gateが開いた時刻と、その時点のconsonance値。

未加工のJSONLは「Population 3の構成員が実際に入れ替わったのはいつか」「anchorが入った直後、 tension_levelはどう変化したか」といった狭い問いに直接答えます。

レポートを読む

streamはplain JSONLなので、任意のJSON toolでfilterできます。次は全deathについて寿命と 初期consonanceを取り出します。

jq -c 'select(.type == "death")
       | {time_sec, population_id, configured_endurance_sec,
          energy_depletion_sec, lifetime_sec, first_k_mean}' run.jsonl

scene_markerの時刻でbucketに分ければ、「第IV sectionでcolonyは飢えたか、その時の consonanceはいくつか」を直接読めます。専用digest toolはありません。重要なsummaryは 作品ごとに異なるため、問いに合わせた一度限りのfilterやscriptの方が固定formatより有効です。

GUI

GUIは実行中のLandscapeとListenerTwinの状態をリアルタイムに表示します。レポートは、聴いて気づいたが すべての数値を同時には覚えられなかった瞬間を、演奏後に読むためのものです。

機構の根拠と作曲者の選択

Conchordalの語には、APIリファレンスとエディタの説明表示で、根拠の札が付きます。札は、その機構が何に基づくかを示します。配置、初期の身体、大きな形を指定する語なら、機構には該当しないと示します。設定項目が増えるわけではありません。まず既定の動きで作り、作品に必要な操作を選べます。

札を読む

札意味
原理一次資料の根拠と同定された機構があり、公表モデルを原典どおりに採用し、新たな人間のデータ収集を必要としない機構です。入力の機能に付く札は、周囲の実装の全ての式や定数を認定するものではありません。
候補(出典)公表された形式モデルはあるものの、対応する脳の機構が未同定、またはパラメータが特定の課題に合わせた値である仮説です。原典にない補足には、作者規則の札を別に付けます。
候補(照合未了)公表モデルに対応する部分を特定した段階で、原典との一致は未確認です。受入済みの候補を意味しません。
作者規則対応する公表形式モデルを持たず、作者が形や閾値、値を選んだ機構です。感覚の情報を使う行為則も、それだけで原理にはなりません。
該当なし(種類)配置、初期の身体、大きな形、経路、運転、データです。入力や行為の根拠は、参照先の語の札で確認します。

一つの語にも、部分ごとに違う札が付きます。metric()では、入力となる拍の知覚機能は原理です。Largeの神経共鳴振動子の形とLarge & Jones(1999)の利得は、原典との照合が未了の候補として記します。参加の規則や結合の既定値は作者規則です。また、consonance()は配置の操作です。H/Rと作者が定めた協和の評価を読み、選択規則を適用します。操作全体を感覚の原理と呼ぶわけではありません。

follow_own_sequence(w)では、PPM-Decay(Harrisonほか、2020)の候補モデルと、作者が定めた音程の符号化・生成への接続を分けています。既存の原典fixtureで照合するのは分布、情報量、学習状態であり、R APIや乱数生成器の同値性ではありません。重みの既定値は0で、明示して使う語です。対応する実行経路と資源の制限はリズムを参照してください。

phrase_boundary(w)では、LBDM(Cambouropoulos、2001)の候補モデルと、作者が定めた有限列の完備化、6 Onのオンライン接続、出生時に固定する上限、境界判明後の合法なSine On一件へのgainを分けています。実装の検査は原著プログラムやcorpus成績の再現ではありません。重みの既定値は0で、任意選択のtonal型に含めますが、既定のsensory型では無効のままです。対応範囲と反応の期限はリズムを参照してください。

根拠の段は、公開用途の Core / Experimental / Tuning / Research とは独立です。Experimentalだから候補、Coreだから原理、とは読めません。

既定で働く機構

原理は既定で働きます。同時に、楽器の基本動作を作ってきた作者規則も維持されます。移動費用、tessituraへの引力、協和の評価、馴化の定数、参加、代謝、生存過程の規則が該当します。例えば移動費用は0.5、解決後のtessituraへの引力は0.1のままです。これらの値は作者の選択であり、感覚の原理から導かれた定数ではありません。札の追加で音、値、経路、操作は変わりません。

現在の方針では、新しく加える候補と作者規則の軸は、既定で中立にします。既存の基本動作を止める指示ではありません。dwell、rest_on_habituation、respond_to_onsets、follow_own_sequence、phrase_boundaryは、既定の重みが0の任意の操作です。既定の動き、まとめられた設定、個別の操作の順に選びます。簡単な作品を作るために、多くの値を積み重ねる必要はありません。

聴き手の型

場面の動作や play、section を始める前に listener_profile("tonal"); と書くと、候補の機構をまとめて選べます。listener_profile("sensory"); は型から継承する重みを外します。語を省いた場合も、引き続き sensory です。既存の音を保ち、既定の変更は作者が試聴で採用した後の別変更とします。

機構tonal の重み根拠の段
follow_own_sequence0.05候補:Harrisonほか(2020)のPPM-Decay。音程の符号化と採点は作者規則
melodic_continuity0.00076066292候補:von Hippel(2000)の本文に整合するAR(1)。有限列の推定、採点、旧項の置換は作者規則
phrase_boundary1候補:Cambouropoulos(2001)のLBDM。オンラインの境界とgainへの接続は作者規則
最後の区間のarch / ritard1 / 1候補:Todd(1992)、Friberg–Sundberg(1999)。区間への割当て、gainの床、時計への接続は作者規則

値はSQ-1、ME-1i、PX-1i、PE-1iの試聴用の値です。機構の差を聴くための材料であり、作者の採用値ではありません。採用後に更新します。listener_profile 自体の札は「該当なし(型の選択)」です。中身の各語の札は維持します。

MEの重みは、置き換える旧二項と平均の絶対寄与を揃えた値です。follow_tonal_contextは、約1 GB・作成約80秒の表の費用と、近似の受入範囲を理由に含めません。受入範囲[0.25,1]は0.25、0.5、1の測定に基づきます。語の値域を制限するものではなく、範囲外の受入は未検証のまま、追加の警告も出しません。

Populationの語で明示した重みは、0も含めて型より優先します。型は配置時の最終形を機構ごとに調べ、対象外のVoiceには警告せず何もしません。個別の軸の既定値は0のままです。既存の作者規則による基本動作は残ります。ただし、有効なMEの予測が既知の裁定では、移動費用と固定中心への重力を置き換えます。

区間の表情は、場面のscore cursorで終わる最後に完了した section に適用します。PE-1の既存の支持条件を場面全体が満たす必要があり、対応する区間がなければ何もしません。Floraや持続参加などを含む非対応の場面では、表情全体を警告なしで省きます。PE-1の対象を広げる変更ではありません。明示した expressive_section は重み0/0も含めて型の表情より優先し、実行時の配送hopと時間長の検査も維持します。機構ごとの範囲はリズムを参照してください。

作曲者が選ぶ範囲

作曲者は、認知を表す層3の座標で、仮説を使うか、その重み、作風に依存する事前分布を選びます。初期条件と大きな形も作曲者の選択です。一方、記憶の統合や学習の内部動態は層4に属します。札を付けても、これらを操作項目として公開したり、層1の感覚入力、粗さ、調和性を変えたりはしません。

APIリファレンスの設定一覧には、位置づけを明示するため研究用の設定も含めています。それらを作曲の操作に昇格させる一覧ではありません。協和の評価係数も、引き続きRhaiへ直接公開しません。

受入で確かめる範囲

原理と候補の受入では、原典との数値的一致、登録した因果的な差、宣言した負荷でのリアルタイム動作を確かめます。候補について確かめるのは、仮説どおりに実装できたかです。仮説そのものの正しさを証明する手続きではありません。 原理の受入に主観評価の条件はありません。

作者規則では、既定の一致、因果的な差、リアルタイム動作の実装確認に加え、作者の試聴を要します。既定の聴き手の型は、まとめた構成を一度試聴して採用します。試聴で個々の値を順位づける方針ではありません。作曲の操作量の上限は、計算費用ではなく破綻や効果の飽和で定めます。エディタに札が表示されても、これらの受入条件は変わりません。

melodic_continuity は von Hippel (2000) の候補と、推定・自己行為の入力・生成への結合という作者規則を分けて表示します。既定は0です。

Population — Voiceをまとめる持続単位

Conchordalを理解するための最も簡単な捉え方は、音符の次に別の音符が来るというものでは ありません。PopulationSpecが、生きたVoiceからなる持続的なPopulationへ変わります。

PopulationSpec + Placement --place()--> Population --> Voice(s)
                                                |
                                                `-- later generations

Community = runtime terrainを共有するすべてのPopulation

PopulationSpecは再利用可能な配置前の定義です。初代のVoiceの初期値と、 生存過程、生存可能性、respawnなど、Population全体に属する方針を組み合わせます。 Placementは初代のVoiceがどこへ何体入るかを指定します。place()は両者を結合し、 ただちにPopulationを返します。これはVoiceごとの参照ではなく、配置されたPopulationを 表す一つの安定した参照です。実行時のCommunityは、Landscapeを共有するすべての Populationを集約したものです。

let population_spec = harmonic()
    .amp(0.035)
    .sustain()
    .respawn_capacity(6);

let population = place(
    population_spec,
    consonance(90.0, 900.0).count(6)
);
wait(3.0);
release(population);

ここでpopulationは6つの初代のVoiceをまとめて制御します。レポートでは共有する population_idと、各々のVoiceのvoice_idを区別します。Voiceが死亡して代わりのVoiceに 置き換わるとvoice_idとgenerationは変わりますが、Populationとpopulation_idは 変わりません。

配置境界

place()だけが定義から実行時への遷移です。初期設定専用の属性は、先に PopulationSpecへすべて設定します。配置後のPopulationが公開するのは実行中の更新と releaseだけで、specificationへ戻したりfounder policyを書き換えたりはできません。

let spec = harmonic()
    .brightness(0.4)
    .brain("entrain")
    .endurance(8.0);

let population = place(spec, consonance(220.0).count(3));
population.amp(0.03); // Live patch at the current script time.
flush();              // Emit pending live patches without advancing time.
wait(2.0);
release(population);

wait(seconds)も保留中の更新を発行してからスクリプト上の時刻を進めます。 wait()もflush()も、未配置のPopulationを作りません。初代のVoiceは place()そのものによってschedule済みです。APIリファレンスでは、 PopulationSpecのメソッドを初期設定専用、Populationのメソッドを実行中に更新可能と表示します。

独立した五つの問い

PopulationSpecは、複数の独立した問いに答えます。分けて考えることで、ある音楽的判断を 別の判断と取り違えずに済みます。

問い主なcontrol意味
何が鳴るかsine, harmonic, modal, brightness, modes, attack_noise初代のVoiceの発音体と周波数成分。
どんな生を送るかbrain(name): entrain, seq, dronearticulationが生態系に参加するか、書かれた生を進むか、Landscapeのanchorとして持続するか。
いつ鳴るかsustain, repeat, metric, entrained, steady, flowphonationとonset timing。
音高はどこへ行くかPlacement、anchor, seek_consonance, temperature初代のVoiceが入る位置と、その後の移動。
Populationはどう持続するかendurance, recovery, viability, respawnVoiceのエネルギー、死、Populationの世代交代。

別の行に属するcallは合成できます。同じ軸では通常、最後の指定が優先されます。正確な 構築時に各メソッドがどう働くかはAPIリファレンスに記載されています。

配置時に harmonic().attack_noise(-18) と書くと、打ち直しを含む各打撃に短い雑音が加わります。強さ 1 の打撃で、初期 RMS は発音振幅より 18 dB 下です。発音包絡の立ち上がりを遅くしても雑音は打撃の瞬間から鳴り、15 ms で約 8.7 dB 減衰します。省略時または −80 dB では無音です。

Articulation life:brain

brain(name)は、鳴っている間にVoiceがどのような生を送るかを選びます。

  • brain("entrain")は既定の、生きた発音様式です。代謝と生存過程の設定を 通じてconsonanceとrhythmic fitに応答できます。
  • brain("seq")は固定された生を持つauthored eventです。Field viabilityとmetabolismを 無視します。
  • brain("drone")は明示的にreleaseされるまで死にません。terrain anchorなど、 持続するmaterialに適します。

これはphonation timingとは別です。

brain("entrain")は生の種類を選び、.entrained()は反復onsetを共有meterへ 中程度に結合します。

似た名前ですが別の軸なので、同時に使用できます。

let colony = harmonic()
    .brain("entrain")
    .entrained()
    .cycles(2)
    .seek_consonance()
    .endurance(8.0)
    .recovery(4.0)
    .consonance_viability(0.30, 0.80);

place(colony, consonance(90.0, 900.0).count(5));
wait(8.0);

brain()は発音体、Placement、音高の方針を選びません。droneは聴取可能にもhabitat-onlyにも でき、生きたVoiceは固定も移動もできます。同じ共鳴発音体に任意のarticulation lifeを 組み合わせられます。

Phonationとduration

Phonationは、onsetがいつ起きるか、そのonsetがどれだけ開いたままかに答えます。

  • sustain()はVoiceが生きている間、音を保持します。
  • repeat()は初期値が設定された反復発音を選びます。
  • metric()は共有拍への同期、entrained()・steady()・flow()は音響参加を選びます。 steadyは自分の予定時刻を保ち、聴いた文脈で鳴らすか見送るかだけを選びます。 発音の機会で打ち直すほか、明示の持続と併せてToneを保てます。リズムを参照してください。
  • cycles(n)はdurationをrhythmic cycle数で表します。

まずプリセットから始めます。発音の時機を直接指定したいときはonce()か pulse(rate_hz)、音長を場の状態に応じて決めたいときはadaptive_duration()を使います。

Releaseはdeathではない

release(population)はスクリプトによる終端判断です。以後そのPopulationへの更新は無視され、 現在のVoiceはrelease envelopeへ入り、Populationは閉じます。生態学的な死は実行時の 結果です。一つのVoiceがenergyを使い果たした後、Populationの再生成方針が代わりのVoiceを 作る場合があります。sectionやplayの有効範囲も、終了時に内部で作ったPopulationをreleaseします。

次章では、VoiceとLandscape — 音と環境のフィードバックを説明します。

明示のsustain()とmetric()を併用すると、持続音と音から確認した拍への同期を同じVoiceで扱えます。自由音高のGateSnap/Rearticulateは、既定では採用先を保留した拍で発音し、ほかの拍では伸ばします。毎拍打つにはtie(0)。固定音高とGlideは拍ごとに打ち、持続+entrained/steady/flowの省略値は0のままです。リズムを参照してください。

Flora — スペクトルの成長

Floraは、指定した周波数範囲にスペクトルの重みを成長させる。成長は周波数帯域の 資源を消費し、資源はゆっくり回復する。成長を維持するには、一定以上の密度が必要になる。 聞こえた音の倍音性が高く、資源の残る場所で新しい成長が生じる。鳴らなくなる状態も この規則に含まれる。これらは作曲のための規則であり、聴覚認知についての主張でも、 音の交代が続くという約束でもない。

PopulationとFloraが互いに作用する経路は音だけであり、内部状態を直接受け渡さない。 habitat busの音からLandscapeが作られ、Floraは慣れが作用する前の評価水準と倍音性を読む。 Floraでは資源の消費と回復が帯域の疲労を既に表す。VoiceとListenerTwinは引き続き慣れが 作用した地形を読む。既定ではFloraは成長と種まきに使う協和性と倍音性からも、 自分が実際に出したhabitat PCMを引く。他のFloraの音は残る。 臨界帯域内の競合は、音にならない質量にも作用する資源消費のkernelが担う。 send(presentation_bus)なら自分の音が環境に入らないので、混合したC/Hをそのまま読み、 H/Rのobserverは作らない。send(habitat_bus)なら環境に作用するが直接は聞こえない。 共有の拍観測には引き続きすべてのhabitat音が入る。

配置前にflora().leave_self_out(false)を指定すると、自分の音を含む混合したC/Hを読み、 H/Rのobserverは作らない。資源の外部消費では引き続き自分のPCMを除く。 Voiceの既定値はfalse、Floraはtrueであり、違いはFloraの一個体が多くの部分音を持ち、 自分の倍音格子で成長と種の位置を支えられるためである。undergrowth-v2の観察では、 地のドローンを外してもこの格子が続いた。その自己支持を残したい場合はfalseを選べるが、 すべての場面で音高が固定される保証ではない。presentationだけに送るFloraは、 どちらの設定でも混合したC/Hを読む。

資源を消費するのは、音にならない部分も含むFlora自身の質量と、ほかのhabitat音の powerである。後者も、混合したhabitat音から自分のhabitat PCMを引いて測る。 powerの基準は振幅0.03の正弦波の平均二乗(0.03²/2 = 0.00045)に 固定し、Floraの振幅を変えても動かさない。観測がない状態を無音とはみなさない。 初回の有効な観測までは資源の初期状態を保ち、その後の欠落では最後に観測した 外音消費を保持する。成長のobserverは配置前の混合した解析履歴を写して始まる。 解析の欠落で観測が無効になった場合、演奏の処理は従来の混合解析と同じく終了する。 自己を除いたC/Hの代わりに混合したC/Hを使わない。周波数の座標系が変われば、古い成長と 種のscanを破棄して新しい観測を待つ。reportには実際に使った成長と種の値を出す。

flora()で再利用可能なFloraSpecを作り、place(spec, placement)で配置するとFloraを 参照できる。配置後も振幅と生態の速さの倍率を変更できる。次の例では、Populationの Voiceが作る音とFloraが同じ環境に作用する。

let sun = place(harmonic().brain("drone").sustain().amp(0.04), at(110));
let moss = flora().amp(0.03).fade(0.5)
    .tone("sine").residual(false).send(habitat_bus | presentation_bus);
let m = place(moss, consonance(110).range(1, 16));
wait(2);
m.amp(0.015);
release(m);
wait(1);
release(sun);

配置時には自分の音がまだ無いため、種の初期分布には混合した地形の値を使う。

consonance(lo, hi)では、その範囲の、慣れが作用する前の協和度の正規化前の重みから初期分布を作る。 重みの合計がゼロなら一様分布を使う。random(lo, hi)は最初から一様分布を使う。 どちらも密度による選択、個数1、緊張度0、既定の間隔を必要とする。間隔の既定値は consonanceが1 ERB、randomが0。同じ値を明示した指定も受け付ける。 その他の配置先、at、line、.peak()、既定値と異なる指定はスクリプトエラーになる。 範囲の両端は1〜20000 Hzの内側に置き、幅は初期Log2Spaceの1ビンに当たる1/96 octave 以上とする。後で周波数空間が変わり、範囲内のビンがなくなるとFloraは休止する。 範囲内にビンが戻れば再開する。

メソッド指定できる値既定値配置後の変更
pace1/64以上の有限値1可能
amp0〜10.03可能
fade0〜60秒2配置前のみ
tone"sine"、"resonant""sine"配置前のみ
residual真偽値。拡散した重みを帯域雑音として鳴らすfalse配置前のみ
leave_self_out真偽値。成長と種のC/Hから自分の音を除くtrue配置前のみ
sendBusまたはBusSet両方の出力先配置前のみ

配置前にresidual(true)を指定すると、帯域雑音の層を有効にできる。

ampは目標振幅の基準となる倍率であり、上限を表す。一定の音量を保証する値ではない。 フェード、振幅の追従、消えつつある音によって、一時的な出力は変わる。

ampとfadeはf32への変換前後で有限でなければならない。範囲外の値や無限大などは スクリプト評価時のエラーになる。paceには計算費用を理由とする上限を置かない。 1/64未満、NaN、負の無限大は警告して1/64へ戻す。正の無限大とf32への変換で あふれる正値は警告してf32::MAXとし、内部の飽和に達する。下限は48 kHz・hop 512、 拍0.5 Hzで退場の尾が有限時間で終わる条件から残した。

配置後の変更は保留され、次のwait、flush、または有効範囲の終了時にUpdateFlora として発行される。release(m)も解放を保留し、同じイベント内で更新の後に ReleaseFloraを発行する。解放時のフェードにはFloraSpecのfadeを使う。 解放を指定した後の変更や重複した解放は、警告とともに無視する。

有効範囲を作る動詞は、そこで配置したFloraを終了時に解放する。入れ子なら内側の Floraを先に解放する。明示した解放のフェードが残る場合は、スクリプトの終了時刻を 延ばす。終了時まで解放されなかったFloraは、Finishの後にフェードアウトする。

Flora の API は Experimental である。力学は作曲上の規則であり、この API の安定性の分類は聴覚認知についての根拠の分類とは別である。

拍に合わせた部分音の交代

すべてのFloraは、新しく確認された拍の観測がある間、部分音の出生と通常の交代を、 各Floraの局所時計が通過する機会まで保留する。biomassと資源の変化は止めない。 支持された既存のtonalとresidualの音量目標と共通の正規化は、毎hopのbiomassに追従し、 既存の振幅・powerのslewを通す。拍が来ただけで、変わらないcarrierの強さをまとめて更新しない。拍を聴かない方式を選ぶ設定はなく、flora().metric()は削除した。

時計の追従はPopulationのmetric()と同じCouplingClockを使う。確信度に応じて 速さと位相を拍へ寄せ、結合の強さは0.95、初期位相は個体ごとに異なる。 初期の速さには場面のtempo basinの中心を使い、指定がなければ2 Hzとする。 ただしFloraが読む拍は、habitatの実音だけから得た共有の観測である。 fluxと選択中の音響recurrence経路、同じ文化的事前分布を使い、Voiceの内部onset指令や Floraのlane指令は入力しない。共有の観測はFloraの配置前から進み、Flora自身の 実際のhabitat音も含む。その音によって拍が確認され、維持される循環も許す。

保留中の音は、最後に持っていたtonal windowに今残る超過質量だけを使う。 その質量はresidualから一度だけ引く。windowが空になった場合、範囲外への移動、 最小分離の違反、releaseでは拍を待たずに退場を始める。 出生と通常の交代はhop内のsample時刻で適用する。出生時の振幅slewは維持し、 退場する音には次節の代謝tailを使う。 すべての終端や、実音から検出したonsetが拍と一致する規則ではない。

生態の入れ替わりが私的な拍の周期より短くなるとき(k > 20)、meterの細分の確信度が正で、 比率2・3・4のいずれかが既知なら、私的な位相にその比率を掛けた交差も機会にする。 それ以外は拍の交差だけを使う。層を切り替えても位相は戻さない。休みへの移行と復帰は 引き続き拍の交差を使う。

拍が未確認、観測が未知、または古い間は、音量目標と正規化も含めてhopごとの連続した割当に戻る。保留候補を捨てて現在のbiomassから 選び直す。時計をresetしたり、古い候補をまとめて鳴らしたりはしない。

歩調と消え方

すべてのFloraは、temporal_basin(lo, hi)を拍の速さの事前設定として使う。 初期の速さは中心の周波数(未指定なら2 Hz)である。 すべてのFloraは、確かめられた新しい拍に確信度と結合強度0.95に従って近づき、 拍が未確認、または観測が古い間は中心へ戻る。flora().pace(k)は、この拍に対する 生態の速さの倍率を身体の性質として指定する。既定値は1で、配置後もm.pace(k)で変更できる。 拍の周波数をfとすると、飽和までは生態の時間がk*f/2倍で進む。成長は毎秒4kf、資源回復は 20/(kf)秒、消費は0.6/(kf)秒となり、拡散と種まきも一緒に速くなる。位相の補正は拍の機会だけを動かす。この規則は句の長さを認知する模型ではない。

退場する部分音は、代謝に基づく有限の尾を残す。全体のfadeは 解放時間の上限であり、fade(0)なら直ちに終わる。尾が固定数の音の枠を占める間、 新しい音の出生が待たされる場合がある。独立したrateとrenewalは削除した。 pace(k)はこれらの共通の時間を倍率化し、飽和までは拍の速さが一定なら退場尾を1/k倍にする。 出生の振幅slewと全体のfadeは実時間のまま維持し、私的な拍の時計は保ち、行為の層は前節の条件で選ぶ。

sample 17は持続音の場面で、temporal_basin(2, 4)を使う。中心3 Hzは中立の2 Hzの 1.5倍である。拍を運ぶ声部を明示していなくても、実音から拍が確認されれば歩調は変わる。 このbasinは作曲上の選択であり、新しい既定値や最適値ではない。

pace(k)は、行為の機会から次の機会までに生態がどれだけ進むかを決める。 生態の速さは、一つの公称機会あたり資源回復の時定数10秒で飽和する。 dt_eco = (f / (2 Hz)) * min{k, 20*r} * dt_hop とし、rは拍と連続fallbackでは1、 細分を使う場合は確認された比率とする。飽和は拍ならk=20、比率2・3・4なら40・60・80で始まり、 それ以上kを増やしても余分な生態時間を進めない。退場にも同じ速さを使う。 位相補正は交差を動かすが、この公称速度の規則は変えない。substepの規則も維持する。 従来の一hop基準の飽和とその費用見積もりは、この規則で置き換えた。新しい実時間測定は行っていない。 Voiceの自己除外と同じく、実時間の費用は場面全体で決まり、作曲者の責任である。

Floraが最も大きな持続の層であるとき、聴き手が聴く和声の文脈はほぼFloraの音で決まる。 拍の速さがf、pace(k)のとき、生態は実時間でおよそ10 s / (k * f / 2 Hz)ごとに入れ替わる。 k=16、2 Hzなら約0.6秒である。これが聴き手の短期の音高の文脈より短いと (follow_tonal_contextが使う周期性の像の大域の記憶は半減1.5秒)、文脈は保たれる前に入れ替わり、 それに重ねて聴く他の声部は安定した拠り所を失う。ある試作の場面では、pace 16で混ざった音の 8秒離れた文脈の相関が0.44、pace 1では0.78だった(Floraの層を聴かせない場合は0.89)。 これはこの量の効き方の説明であり、paceの上限ではない。

部分音の動き方

flora().pitch_apply_mode("glide") は既定の追従を保ちます。 "rearticulate" は各tonal laneの出生時の周波数を退場の尾まで保ちます。 山が50 centの追従半径を超えると、そのlaneは退場し、山の位置で生え直します。 生え直しは既存の拍の機会、出生のslew、空きlaneの条件に従います。 配置後のFloraからも変更でき、鳴っているlaneを維持して次の割り当てから適用します。 glideからの切替では、その時点の音高を保ちます。residual noiseの重心移動は従来どおりです。 "gate_snap" など未対応の名前は警告し、設定を維持します(初期値はglide)。

区間と休み

flora().rest_on_habituation(0.25) を指定すると、Floraは聴いた発音への慣れに応じて 鳴る区間と休みを交代します。配置前だけ指定でき、既定値は0です。 f32で表せる有限の非負値を受け付け、音楽上の上限は置きません。 負値、非有限値、f32への変換であふれる値は警告して0に戻します。 0では区間を管理する私的な状態も乱数列も作りません。

VoiceかFloraがこの機構を使う場合、habitatの共有観測器は演奏の最初から動きます。 Floraは、鳴っている部分音の周波数での慣れを、各laneの目標powerで重み付けして読みます。 鳴っているtonal laneが無ければ出口の積分は進みません。 積分が私的な乱数で決めた目標に達すると、私的な拍の交差でtonalとresidualの全laneを退場させます。 休みの間もbiomass、資源の回復、消費、種は進み、新しいlaneの出生だけを止めます。

全ての尾が終わると、実際のlaneの出生だけに駆動される私的な慣れから、戻りの積分を始めます。 戻れる状態になった後の拍の交差で、現在のbiomassから通常の規則で生まれるのを許します。 出生を強制する規則ではありません。音響の観測が不明なら出口と戻りの積分は止まり、 拍が未確認でも私的な時計は従来の速さで交差を供給します。releaseとfadeが全てに優先します。 記録は span_gap に flora_id を付け、慣れと周波数は部分音の重み付き平均として示します。 これは作者規則であり、句や終止を知覚したという主張ではありません。

聴こえた発音に応える

flora().respond_to_onsets(w) を指定すると、Floraは自分の外から新しい発音が聴こえた後に、 生態の時間を速めます。配置前だけ指定でき、既定値は0です。f32で表せる有限の非負値を受け付けます。 負値、非有限値、f32への変換であふれる値は警告して0に戻します。 0では状態を作らず、何も読みません。

地点を指定した曲では、自己音を除く Flora はその地点の外音の発音履歴に応答し、自己音を含む設定ではその地点の全混合に応答します。休止を決める rest_on_habituation は常に自己音を含む履歴を読みます。地点を省いた曲では両者とも共有の発音履歴を読みます。 この観測器は演奏の最初から動きます。Floraは自分の範囲の中で、鳴っている自分のlane (退場中の尾を含む)から1.5 ERB以内のbinを除き、前の観測から履歴がどれだけ上がったかを読みます。 履歴が上がるのは、まだ慣れていない帯に発音が来た時だけなので、聞き慣れた発音ほど効きません。 τ = satiation_sec / ln 10(既定で約2.17秒)とすると、上がりρはw·τ·ρ秒の余分な生態の時間になり、 1秒あたり最大w秒ずつ使われます。慣れていない外の発音が聴こえている間、時計は最大で1+w倍で進みます。 paceの飽和はそのまま効き、k·(1+w)が20·rに達すると、それ以上重みを上げても変わりません。

成長、広がり、種、資源の回復、消費、退場は、この速い時間を共有します。 出生と入れ替えは、これまでどおりFlora自身の拍の交差でだけ起き、どこに生えるかは場が決めます。 発音、音高、機会、乱数を足しません。不明な観測と格子の変更は何も足さず、 次の既知の観測は比較の取り直しだけをします。すでに貯まった時間は使い続けます。 [psychoacoustics.habituation] enabled = false では履歴が動かず、一度だけ警告します。 記録は、正の重みの時だけ respond(重み、上がりと余分な秒数の累計、残りの秒数、読んだbinの数)を足します。 これは作者規則であり、聴き手に応答が聴こえるという主張ではありません。

VoiceとLandscape — 音と環境のフィードバック

habitat busへ送られたVoiceはLandscapeを変え、変化したLandscapeはplacement、movement、 viabilityへ影響します。この章では、その実行時feedbackと、そこから生じるenergy、death、 respawnの過程を追います。

Voice bodies
    |-- presentation bus --> listener / ListenerTwin
    |
    `-- habitat bus --> Landscape --> placement, movement, viability
                              ^                         |
                              `------ new sound <------'

初期状態ではすべてのVoiceが両方のバスへ送られ、聴衆と生態系は同じ物理的な出来事を共有します。 意図的に分離する方法はルーティングとListenerTwinを参照してください。

音からLandscapeへ

Landscapeはhabitat busをlog-frequency spaceで解析し、次を計算します。

  • roughness potential — critical band内の干渉とbeating。
  • harmonicity potential — periodicityとvirtual rootへのsupport。
  • Consonance Field — candidate frequencyの評価に使う合成地形。

Voiceがhabitat bus上の周波数成分を変えると、これらの走査結果も変わります。そのため consonance(...).peak()は固定scale degreeを返しません。現在鳴っているものによって 答えが変わります。

Score、level、mass、density

同じLandscapeから複数の表現が導かれます。関連はありますが交換可能ではありません。

表現範囲用途
potentialkernel依存raw roughness/harmonicity output。
field score非有界の実数位置比較、hill-climb、placement tension。
field level0..1振る舞いと生存可能性に使う有界な信号。
density mass非負stochastic placementの正規化前weight。
density / PMF選択範囲内で総和1密度分布からの標本抽出。

.peak()は極値を選びます。既定の密度配置はPMFから標本を取るため、複数のVoiceは 一つの周波数区間へ重ならず、支えられた領域の周囲に分布します。 tension(degree)は最大peakより一定のfield-score stepだけ下を狙います。 生存可能性の範囲は、有界または環境相対の適合度を読みます。レポートの接尾辞も同じ区別を 保ち、mean_c_field_scoreとmean_c_field_levelは別の量です。

配置と移動は別の判断

配置はVoiceがどこへ入るか、音高の振る舞いは入った後に何が起きるかに答えます。

let fixed_strain = harmonic()
    .amp(0.035)
    .sustain()
    .anchor();

let resolving_strain = harmonic()
    .amp(0.035)
    .sustain()
    .seek_consonance()
    .glide(0.4);

section("two responses to dissonance", || {
    place(fixed_strain, dissonance(140.0, 900.0).count(3));
    place(resolving_strain, dissonance(140.0, 900.0).count(3));
    wait(6.0);
});

両方のPopulationが不協和な領域へ入ります。一方はその状態を保ち、もう一方は解決へ向かう 出発点として扱います。

自分ではなく環境を評価する

Voiceは、後で自ら評価するConsonance Fieldへ自身のエネルギーも加えます。そのままでは、強いVoiceは自分の footprintを聴くことでviableに見えるかもしれません。そこでconsonance_viability()は 既定で環境相対評価を有効にし、Voiceが実際にhabitatへ出したPCMを除き、残った音を解析して適合度を判断します。

これは生存規則であり、音の送り先を決める規則ではありません。Voiceはhabitat busへ寄与し、ほかの すべてのVoiceが読むConsonance Fieldを変え続けます。自分も含むConsonance Field全体への適合度を問いたい場合だけ viability_scope("total")を使います。

音高移動では、別の設定leave_self_out(true)を使います。Voiceの既定値はfalse、 Floraはtrueであり、違いはFloraの一個体が多くの部分音を持ち、自分の倍音格子で 成長と種の位置を支えられるためです。両者は、混合habitat PCMから そのVoice自身のhabitat PCMを引いた音の観測を共有します。減算後も、混合場と同じ聴覚フィルタ群、 hopごとの統計、周波数の再配置、臨界帯域の圧縮、密度の平滑、H・R・Cの計算を使います。 habitatへ送られたFloraは、residualを含めて残ります。身体によらず同じ方式を使い、mode選択はありません。

既定のtail_roughness_aversion(0)では、従来どおりH/Rの両方から自己を除きます。 自分の余韻との粗さを避けて音高を選びたい場合は、Populationに .tail_roughness_aversion(w)を指定します。初期設定と実行中の更新に対応します。 これは感覚の変更ではなく、作曲者が選ぶ性向(DCC §5)に属する作者規則です。 速いパッセージでは重なりを無視する、遅いドローンでは避ける、ペダルのように重なりを使う、 といった選択を残します。作者はUndergrowthのB(VR-1)を「クリアで濁りがすくない」と評価しました。

leave_self_out(true)で実際に旧ToneをOff・新ToneをOnする候補だけ、同じ観測・格子の 自己除外Rと混合Rを1-wとwで混ぜます。Hは自己除外のまま、既存の場の係数とsigmoidを使います。 0は元の既定経路、1は採択したVR-1の読み方です。有限の[0,1]を指定してください。 範囲外・非有限は警告し、有限値は範囲内へ制限、正の無限大は1、負の無限大とNaNは0にします。 leave_self_out(false)で正の重みは効かず、Populationごとに一度だけ警告します。 Lock、rearticulate_above、最終音高範囲、発音の可否で候補を判定し、保持、Glide、GateSnap、 独立した参加機会へ持ち越す提案には効きません。共有の和声機会でも同じ規則を使います。 environmentの継続回復、共有観測、Flora、releaseは変えません。On直前の実音を使うため、 未来のreleaseや新しい身体の音の予測ではありません。

対象Populationは、後からleave_self_out(true)を指定する場合も含めて出生時から観測します。 出生前の解析状態は混合streamから引き継ぎ、VoiceのIDと世代で観測を対応づけます。 解析処理は、音声データの欠落を検出すると、混合音と自己除外後の音の履歴をリセットします。 後続のPCMが届けば、共通の解析窓が再び埋まった時点から有効な観測の公表を再開します。 一方、Consonance Fieldを利用する実行時の処理は、観測経路の切断・無効化により、 1 hop以内の遅れで有効な観測を得られない場合、現在の方針では実行を終了します。 解析窓を埋めるための音声生成を続ける自動復旧は行いません。

生存選択は動かないVoiceにも適用され、現在の音高で継続的なエネルギー回復の得点を求めます。基礎消耗と統計記録が使う混合場のlevelは変更しません。

Energy、death、replacement

生態学的lifecycleはbrain("entrain")に属し、energyは0..1へ正規化されます。

  1. endurance(seconds)がzero-fit時の基準寿命を定める。
  2. attackごとにattack_cost_fractionを消費する。
  3. consonantなattackは最大attack_recharge_fractionまで回復できる。
  4. recovery(seconds)が連続回復を有効にし、viability windowが現在位置での回復量を決める。
  5. energyがゼロになるとVoiceは死亡し、音の減衰へ入る。
  6. 再生成の方針があれば、Populationは代わりのVoiceを生み出せる。
let settlement = consonance(70.0, 1100.0).spacing(0.8);

let ecology = harmonic()
    .brain("entrain")
    .entrained()
    .cycles(2)
    .seek_consonance()
    .endurance(8.0)
    .recovery(4.0)
    .attack_cost_fraction(0.017)
    .attack_recharge_fraction(0.70)
    .consonance_viability(0.32, 0.82)
    .respawn_consonance()
    .respawn_capacity(8)
    .respawn_settle(settlement);

place(ecology, consonance(70.0, 1100.0).count(8));
wait(20.0);

respawn policyは異なる作曲上の問いに答えます。

  • respawn_random() — parentの系譜を作りません。Populationを最初に配置したPlacementから candidateを作り、現在のscene scoreで重み付けして選びます。一様random配置ではありません。
  • respawn_hereditary(sigma_oct) — living parentをenergyで重み付けして選び、その近くへ offspring候補を作り、現在のField levelが最も高いcandidateを採用します。
  • respawn_consonance() — living parentをenergyで重み付けして選び、そのparentの周辺へ 偏らせながらfield scoreの高いpeakから選びます。
  • respawn_capacity(n) — Populationが維持する生存個体数の上限。未指定時は初代の個体数で、 明示値をfounder数より小さくはできない。
  • respawn_settle(placement) — そのPlacementからcandidateを追加します。respawn policy本来の baseline candidateも一つ残ります。

respawn後もPopulationとpopulation_idは維持され、voice_idとgenerationが変わります。 レポートの記録により、この世代交代を観測できます。

実行時のfeedbackと人間による修正

  • 実行時のfeedbackは自動です。音がLandscapeを変え、LandscapeがVoiceの振る舞いと 生存を変えます。
  • 人間による修正はrunの間に行います。実行し、聴き、reportを調べ、scenarioを修正して 再実行します。

実行して結果を確かめ、修正する具体的な手順は演奏で説明します。

Consonance Field — 音高を評価する地形

Conchordalの知覚coreであるLandscapeはhabitat busを聴き、log-frequency spaceへ 変換して二つのpotentialを計算します。roughnessはcritical band内の振幅変動による 感覚的不協和、harmonicityはperiodicityとtemplate matchingです。この二つを 組み合わせたConsonance Fieldは、placement、movement、prediction、survivalが 読む、周波数上の評価地形です。

Consonance Fieldはhabitat busから計算されるため、そのbusへ送られたVoiceが ほかのVoiceの読むConsonance Fieldを変形します。presentation busだけへ送られたVoiceは 変形しません。和声はchord chartではなく、このfeedback loopから生まれます。 potential、score、level、mass、densityの関係は VoiceとLandscape — 音と環境のフィードバックを参照してください。

Consonance Fieldへの配置:consonance、dissonance、edge、gap

Consonance Fieldに応じたPlacementでは、Field内の対象領域を指定します。既定では確率分布から位置を選び、 .peak()を付けると決定的な極値を選びます。

  • consonance — consonanceが高い位置(harmonic center、fusion)。
  • dissonance — consonanceが低い位置(tension、cluster、color)。
  • edge — consonance/dissonanceの境界(metastableな中間)。
  • gap — 空いたregister(空間を埋め、maskingを避ける)。

consonance(root)はroot周辺のharmonic windowを取り、range()で倍音範囲を指定します。 どの配置先にも、絶対周波数の(min_hz, max_hz)範囲を渡せます。

範囲の両端には、音源が扱える1〜20000 Hz内の有限値を指定します。大小が逆でも使えます。 初期配置は微小な揺らぎ(jitter)を加える場合も、重みがすべてゼロ、または全域が占有済みで 代替の抽選を行う場合も、指定範囲を守ります。Consonance Fieldに基づくPlacementは Voiceの自律的な音高範囲(約29.989〜8000 Hz)との共通部分を使います。 聴こえる範囲はこれと独立しており、32/44.1/48 kHzでは約20.015 Hz〜12.5 kHzへ 暫定的に広げています。低いsample rateではfilterbankがNyquist周波数を越えないように 上端を下げます。Floraはこの広い解析範囲を使います。

Voiceの要求範囲と自律的な音高範囲が重ならない場合は、元の要求範囲内の対数一様分布へ 切り替わります。random()は要求範囲を直接使い、at()とline()は明示した音高を保ちます。 初期配置の範囲は、その後のseek_consonance()による移動を同じ範囲へ制限する指定では ありません。自律的な候補と目標には、独立したVoiceの境界を使います。 Hereditaryのrespawnは元の要求範囲を使い、明示した親の音高へ新たな8000 Hzの制限を 加えません。

let anchor = harmonic()
    .brain("drone")
    .amp(0.06)
    .sustain()
    .anchor();

let voice = harmonic()
    .amp(0.04)
    .sustain();

section("field placement", || {
    place(anchor, at(110.0));
    wait(1.0);

    place(voice, consonance(110.0).peak().range(1.0, 4.0).count(6).spacing(0.9));
    wait(6.0);
});

追加指定のない配置先は密度分布として扱われます。「無作為だが調和的」なのではなく、 協和のモデルから導かれ、指定範囲内で正規化された分布です。配置は配置後の振る舞いから 独立しています。dissonanceへ入りanchor()でclusterを保持することも、 seek_consonance()で解決へ向かわせることもできます。

let cloud = harmonic().amp(0.035).sustain();

place(cloud, consonance(90.0, 1200.0).count(10).spacing(0.8));
wait(8.0);

配置時の緊張度:tension(τ)

tensionを指定しないConsonance Placementは、通常の方法で実現されます。.peak()なら 最も強いpeakを選び、既定のdensityなら通常のConsonance密度分布を作ります。 tension(τ)は、最大値より一段下のfield-scoreへ配置を偏らせます。 τ ∈ [0, 1]がtension degreeで、0は通常の配置を変えず、大きい値ほど弱く metastableなstepを対象にします。指定範囲内の評価値で target = L_max − τ·(L_max − L_min)です。movementにおけるsearch temperatureと 対になる、spawnをどれだけ解決した位置に置くかのdialです。.peak()なら最も近いstepへ 最寄りの段へ固定し、確率分布なら対象値の周辺へ重みを集中させます。

let tense = harmonic().amp(0.035).sustain();

// A metastable step below the strongest peak — placed, not resolved.
place(tense, consonance(110.0, 1200.0).peak().tension(0.4).count(6).spacing(0.8));
wait(6.0);

Consonance Fieldに依存しないPlacementには、対数周波数上で一様なrandom(min_hz, max_hz)と、幾何的な at(hz)、line(start_hz, end_hz)があります。

周波数をroot比で名づける

at(hz)とline(start_hz, end_hz)は絶対周波数を取ります。標準的な書き方は、 鳴っている一つのrootをHzで名づけ、他のpitchをその比として導くことです。完全5度なら root_hz * 1.5、完全4度ならroot_hz * 4.0/3.0、registerを上げるなら root_hz * 2.0です。比はField自身が読む物理量なので、周波数関係として考えられます。

平均律のdecimal、たとえばD3を表す146.83も動作しますが、12音のsymbol gridを裏口から 持ち込みます。sceneで実際に鳴っているrootの比を優先してください。

let root_hz = 110.0;
let voice = harmonic().amp(0.04).sustain();

place(voice, at(root_hz * 1.5));
wait(2.0);

Consonance movement:seek_consonance

VoiceがConsonance Field上のより良い位置を能動的に探すときはseek_consonance()を使います。 自由な山登り探索と音高推移の初期値を設定します。同じ移動を遅く、または速く 動かしたいときはglide(tau_sec)を使います。

let mover = harmonic()
    .amp(0.045)
    .sustain()
    .seek_consonance()
    .glide(0.35)
    .avoid_neighbors(0.6)
    .global_peaks(8, 70.0)
    .ratio_candidates(5);

place(mover, consonance(80.0, 900.0).count(8));
wait(12.0);

avoid_neighbors(strength)は混雑を避ける反発を加え、移動するVoiceがすべて同じ山へ重なるのを防ぎます。 移動の反対はanchor()です。固定されたVoiceは音高を保ち、ほかのVoiceが読むConsonance Fieldだけを 変形します。freq()は音高を固定し、anchor()は配置で選ばれた音高を保ちます。

at(hz)も通常は音高を固定します。ただし、配置するPopulationSpecに明示の seek_consonance()の意図が残り、音高が自由のままなら、初期位置だけを指定します。 この場合はline(hz, hz)と同じ配置となり、指定した人数も保ちます。たとえば、 上のmoverをplace(mover, at(220.0))で置くと、移動や滑りの指定を保って220 Hzから 始めます。指定するのは身体の初期音高で、最初に聴こえる音高や、その後の移動を保証する 指定ではありません。

音高の方策を変えるときは、書く順で最終の指定が決まります。

最後に書いた指定の順at(hz)の意味
seek_consonance() → freq()固定音高
freq() → seek_consonance()初期位置
seek_consonance() → anchor()固定音高
anchor() → seek_consonance()初期位置

動く指定を明示しなければ、at()は音高を固定します。演奏中のPopulationのfreq()も、 従来どおり音高を固定します。

移動の反映方法は発音様式から決まります。持続するVoiceは滑らかに移り、再発音するVoice (pulse()、metric()、entrained()、steady()、flow())は発音開始ごとに新しい音高へ 移ります。pitch_apply_mode("gate_snap")とpitch_apply_mode("glide")で、 この反映方法を明示的に選べます。

持続するVoiceで、新しい音高の行き先を採用するたびに発音し直したい場合は、 参加の時計を付けず、pitch_apply_mode("rearticulate")を指定します。移動の始まりで旧いToneをreleaseし、 新しいToneは頭から新しい音高でattackします。棄却した提案、同じ行き先、 glideの途中の更新では発音し直しません。提案の間隔は行き先を選ぶ機会の間隔であって、 一定の音符を刻む時計ではありません。発音を拍に合わせて遅らせる処理もありません。

let moving = harmonic().sustain().seek_consonance()
    .pitch_apply_mode("rearticulate");
let voices = place(moving, line(220.0, 440.0).count(3));
wait(12.0);
voices.pitch_apply_mode("glide");
wait(12.0);

演奏中にglideとrearticulateを切り替えても、鳴っているToneを止めたり、 切り替えだけで新しい発音を起こしたりしません。まだ出力していない再発音の要求を取り消し、 次の採用から新しいmodeを使います。再出生するVoiceにもPopulationのtemplateから 同じmodeが渡ります。glide(tau)はGlideと、打ち直しの境界以下で滑る時の移動の時定数です。 anchor()などで固定されたVoiceにrearticulateは作用しません。

対象は音高が自由なHoldのVoiceです。自由音高のGated発音とrearticulateの組み合わせは、 builderの呼び出し順にかかわらず、配置時の最終specでscript errorになります。 演奏中の対象外の指定も、状態を書き換える前に拒否します。sustain()でHoldにするか、 Gatedではgate_snapまたはglideを選んでください。参加の時計がないHoldには、同音高の 発音だけを求める指定はありません。持続+参加では機会による現在音高の打ち直しも できます。Voice自身が一音ごとに方策を選ぶ機能は含まれません。

音高の移動と発音の結びつきを選ぶ

行き先を採用する時と、参加の機会で鳴らすと選ぶ時は別です。次の表で、移動を音の区切りに どう結びつけるかを選べます。境界は創始のVoiceに置く発音の気質で、作曲者が選ぶ量です。 50や100 centは使い方の例であり、聴覚の原理から決まる値や推奨値ではありません。

書きたい形明示する指定発音の区切り
レガートsustain().pitch_apply_mode("glide")初回に発音し、その後の移動は滑る
採用ごとに打ち直すsustain().pitch_apply_mode("rearticulate")境界を省略するか0にすると、採用ごとに打ち直す
小さく動く時は滑るsustain().pitch_apply_mode("rearticulate").rearticulate_above(50)最後の発音音高から行き先までが50 centを超えた採用で打ち直す
持続しながら参加し、音高は滑るsustain().entrained().pitch_apply_mode("glide")鳴らすと選んだ機会で、その時点の身体音高を打ち直す
持続しながら参加し、発音時に跳ぶsustain().flow().pitch_apply_mode("gate_snap")鳴らすと選んだ機会で、最後に保留した行き先へ跳んで打ち直す
持続しながら参加し、移動の大きさで分けるsustain().entrained().pitch_apply_mode("rearticulate").rearticulate_above(50)小さい採用は滑り、大きい採用は鳴らす機会まで保留する

参加の各行では、entrained・steady・flowをそれぞれ選べます。steadyはGlideでも dueの機会だけを残します。時計の違いは リズムの章で説明します。

参加の各行にintrinsic_rate(hz)を添えると、音高の適用方法とは独立に身体の初期の尺度を 置けます。発音間隔の命令や共通拍の指定にはなりません。proposal_interval(seconds)は 引き続き音高の提案の間隔です。身体の固有の速さを置くを 参照してください。

参加の時計がない場合、正の境界を指定したrearticulate_above(cents)は、最後に実際に発音した音高からの正味の変位を測ります。 経路の距離を足し合わせる量ではなく、元の音高へ戻れば相殺されます。境界以下なら同じToneで glide(tau)に従って滑り、境界を超えれば新しいToneを立ち上げます。選択は次の採用まで 保持します。両端がLog2Spaceの正確なbin中心ならbin差をcentへ換算し、それ以外は連続した log2座標の差を使います。行き先の丸め直しやepsilonは加えません。同じ未出力hopに先行する 合法な発音があれば、その音高を基準にします。取り消した要求を実発音の記憶へ残しません。

参加の時計がない場合、省略値0は採用ごとに打ち直す従来の形です。負値と有限でない値は0にし、上限は置きません。 演奏中に境界を変えても、それだけでは発音せず、次の採用から使います。Rearticulate以外への 指定は警告して無視します。配置前の書く順に依存しません。再生成したVoiceは境界を継ぎますが、 親が最後に発音した音高は継ぎません。

let moving = harmonic().sustain().seek_consonance()
    .pitch_apply_mode("rearticulate").rearticulate_above(50).glide(0.03);
let voices = place(moving, consonance(220.0, 660.0).count(2));
wait(3.0);
voices.rearticulate_above(100);
wait(3.0);
release(voices);

参加の時計を持つRearticulateでは、同じ距離の測り方を使い、打ち直しの時刻は時計に 委ねます。正の境界以下の採用は、その時刻から滑り始め、発音せず、旧い保留を取り消します。 境界を超える採用は進行中の滑りを止め、身体の音高を保ち、最新の行き先を一つ保留します。 鳴らすと選んだ機会で保留を消費し、そこへ跳んで打ち直します。保留がなければ、その時点の 身体音高で打ち直します(tieの省略または0)。滑っている途中なら、前の発音と音高が違う場合もあります。 どちらの打ち直しでも最後の実発音音高を更新します。待つ・見送るなら音と保留を保ち、 既に始まった滑りは続きます。同じsampleでは採用を先に処理し、採用時刻の発音候補を 追加しません。境界で時計の発音を間引きません。境界の省略と0はGateSnapと同じ形で、 距離0の採用も保留します。演奏中の切り替えはリズムの章で説明します。

正の境界を持つこの形では、配置前のarticulation_persistence(p)でBase/Connectを 既存の出来事にまたがって保てます。移動の境界やつなぐ割合を変える指定ではありません。 発音の方針を保つを参照してください。

gate_snap/rearticulateの参加では、tie(p)で保留がないToneを打ち直さず伸ばす確率を 置けます。gate_snapの小さい採用を含む、保留ありの発音は通します。 行き先がない機会では音を伸ばすを参照してください。

持続+同期も同じ保留の規則を使いますが、自由音高のGateSnap/Rearticulateでは、 省略時はtie(1)と同じく保留の無い拍で伸ばします。毎拍打つにはtie(0)と書きます。 固定音高とGlideは従来どおり、entrained/steady/flowの参加は省略時0のままです。 持続音を拍へ同期させるを参照してください。

音を切って間を置く

持続音と参加の機会を併せ持つVoiceにrest()を指定すると、発音ごとに有限の音長で 音を離し、鳴り終わってから能動的な間を置きます。音長はcycles(n)、または adaptive_duration()で指定します。音長、明示のsustain()、 entrained()・steady()・flow()、rest()は、書く順によらず独立に保持します。 配置には有限の音長を明示する必要があります。

予定したOffで通常のreleaseを始め、余韻は切りません。rendererが同じsource IDと generationに属する全Toneの終了を確認してから、間を数えます。rest()は確認時の 固有周期一つ分、rest(periods)は作曲者が置いた倍数のあいだ発音を禁止します。 周期が既知ならrest(0)は余韻の終了だけを待ちます。周期が未知の場合も、音が 鳴り終わっていない場合も、代わりの値や期限を置かず待ちます。負値と有限でない値は 0にし、有限の非負値に上限は置きません。

音長と間には同じ身体の固有周期を使います。intrinsic_rate(hz)で速さを変えると、音長と rest(periods)の指定が同じでも、秒単位の音長と間が一緒に変わります。 entrainedが音響の反復に合わせて更新する参加周期とは独立です。

間が終わると、既存の参加の判断で鳴らす・待つ・見送るを選べます。間の終わりだけで 発音を強制しません。GateSnapは発音中、余韻待ち、間のあいだも最新の行き先を保留し、 次に鳴らすと選んだ機会で消費します。Rearticulateも余韻待ちや間のあいだに採用を扱い、 小さい採用は旧保留を取り消し、大きい採用は保留します。次の実発音まで、最後の発音音高を 基準にします。Off後も身体の滑りは続きますが、離した余韻は動かしません。Glideでも Off後の余韻に音高更新を渡しません。 release、死亡、removeが優先します。再生成したVoiceは設定を継ぎ、演奏の状態は 新たに始めます。

let notes = harmonic().sustain().entrained()
    .adaptive_duration().rest(2);
let voices = place(notes, at(330.0));
wait(3.0);
release(voices);

この例は余韻が終わってから、身体の固有周期二つ分の間を置きます。restは音長の 語と同じく配置前の指定です。明示の持続+entrained/steady/flowと有限の音長が必要で、 Glide、GateSnap、Rearticulateを選べます。対象外の配置は状態を書き換える前に拒否します。 restがなければ既存の規則を保ちます。この形では全ての音が有限長で終わり、Voiceが 一音ごとに伸ばすか切るかを選ぶ機能は含まれません。

研究scriptにはpitch_core()など機構水準のcontrolもありますが、作品では seek_consonance()を入口にし、発音し直すか滑らかに移るかを選んでください。

Consonance viabilityとrespawn

consonance_viability(low, high)はconsonance window、recovery(seconds)は最大回復に 要する時間を定義します。適合度の高いVoiceは支えられ、低いVoiceは基準 endurance(seconds)へ近づきます。既定では自分の音響的な痕跡を近似的に除く 環境相対評価です。Consonance Field全体への適合度を問う場合だけviability_scope("total")を使います。

再生成は循環を生態系として閉じます。Voiceが死亡すると、再生成の方針に従って代わりのVoiceが 現れます。respawn_consonance()は、energyで重み付けして選んだliving parentの周辺へ 偏らせながら、field scoreの高いpeakから選びます。respawn_capacity(count)はliving membership上限です。respawn_settle(placement)はpolicy本来のcandidateを置き換えず、 replacementのcandidate poolへそのPlacementを追加します。

let settle = consonance(70.0, 1100.0).spacing(0.8);

let ecology = harmonic()
    .amp(0.04)
    .repeat()
    .pulse(1.5)
    .cycles(3)
    .seek_consonance()
    .glide(0.45)
    .endurance(8.0)
    .recovery(4.0)
    .attack_cost_fraction(0.017)
    .attack_recharge_fraction(0.70)
    .consonance_viability(0.32, 0.82)
    .respawn_consonance()
    .respawn_capacity(14)
    .respawn_settle(settle);

place(ecology, consonance(70.0, 1100.0).count(14));
wait(30.0);

完全なlifecycle/respawn surfaceはAPIリファレンス、articulation、 発音、音高の振る舞い、生存の区別はPopulation — Voiceをまとめる持続単位、 エネルギーと再生成のcycleは VoiceとLandscape — 音と環境のフィードバックを参照してください。

Landscape-awareな音色

Fieldはpitchだけでなく音色も形づくれます。modal() bodyはmode patternを取ります。 landscape_density_modes()はdensity massの強い位置を間隔を空けて決定的に選び、 landscape_peaks_modes()はField levelの強いlocal peakを間隔を空けて選びます。 そのため、bellのpartialをConsonance Fieldがすでにsupportする位置へ置けます。

let shimmer_modes = landscape_density_modes()
    .count(10)
    .range(1.0, 5.5)
    .gamma(1.6)
    .spacing(0.7);

let shimmer = modal()
    .amp(0.025)
    .sustain()
    .seek_consonance()
    .modes(shimmer_modes)
    .brightness(0.7);

place(shimmer, consonance(200.0, 1600.0).count(4));
wait(8.0);

mode patternの生成関数にはharmonic_modes()、odd_modes()、power_modes(beta)、 stiff_string_modes(stiffness)、custom_modes([ratios])、modal_table(name)、 landscape_density_modes()、landscape_peaks_modes()があります。

聴いた周期性を音高選択へ戻す

remember_pitch_set(weight)は、場面全体に適用する実験的な作者規則です。 場面の動作や設定範囲の指定より前に呼び出します。省略とremember_pitch_set(0)は従来の動作を 保ちます。正の有限値を指定すると、自分自身を含むhabitatの実音から周期性の分布を 累積し、音高の選択へ戻します。IPEMによる観測部分は候補、連続化、時間平均、 山の候補化と加点は作者規則です。人の長期的な音高学習の機構が確立したという意味では ありません。

自由音高のseek_consonance()を使うVoiceは、合法な音域内で最も強い山と現在目標に 最も近い山を候補に加えます。記憶による加点は候補と現在目標の双方に適用します。 提案する時刻、発音の規則、慣れ、現在の場に対する自己除外は既存の経路を使います。 Floraの音も入力に含まれますが、Flora自身のlane選択にはこの記憶を使いません。

入力は48 kHz、記憶を問い合わせる範囲は約15.84〜1378.13 Hzです。範囲外の既存候補は 消さず、記憶による加点だけを0とします。音名、調律の格子、オクターブの折り畳み、 音階の音数、根音の進行、忘却時間の指定はありません。山には部分調波も含まれ、 複数の観測を平均すると位置が動く場合もあります。発音した基音の台帳とは異なります。 欠測では経験を保持して観測を再開し、TCの無効化規則は変えません。累積時間が長くなるほど 新しい入力への変化は遅くなります。listener profileには自動追加されず、正の重みを使う だけで音楽的な改善や作者の採用が保証されるわけではありません。

リズム:時間の知覚と個体の参加

拍は、音から推定する反復的な時間の基準です。同じ音を参照するVoiceが、同じ拍位置で 発音する必要はありません。

プリセットが保つ時間関係

プリセットは、時刻を決める方策が保つ関係を選びます。発音の機会と実際の打ち直しは 別です。生存過程、発音ゲート、有限音長、休止、発音の方針によって、発音を控えたり 生きたToneを伸ばしたりする場合があります。

プリセット保つもの変わってよいもの保証しないものentrainment(x)の意味
entrained()Voiceの生存中に固定された身体の固有の速さ身体の尺度への近さで重み付けし、支持された反復へ参加周期を寄せます。費用によって予定近傍の発音、参加の一周期までの待ち、見送りを選びます等間隔の発音列、Voice間で違う発音の速さを保ち続けること、共有拍との位相一致周期の適応と発音時刻の費用に対する音響文脈の影響。省略値0.5
flow()不規則な間隔を抽選する身体の固有の尺度。反復周期への適応はしません上下限のある間隔を更新し、音響費用に応じて時刻の変更、待ち、見送りを選びます規則的な発音列、拍、固有周期と実発音の平均間隔の厳密な一致発音時刻の音響費用への影響。抽選の尺度を反復へ適応させる量ではありません。省略値0.05
steady()固有周期と、その後の自分の発音予定の格子。時刻はsampleへ丸めます文脈は予定時刻で鳴らすか見送るかを選び、実行上の制約でも発音が抜けます発音数、音高の結果、相手の時刻への追従鳴らすか見送るかの音響費用への影響。周期と予定時刻は動かしません。省略値0.5
metric()音から確認された生成側の拍への引力と、指定した拍位相のずれ。確認前は独立した初期位相から始めます拍とその確信度に応じて実効的な速さと位相が変わります。確認前は自走し、実行上の制約や発音方針でも打ち直しを控えます拍そのものの確認、厳密な位相一致、独立した非整数比のテンポ関係拍の確信度に応じた速さと位相への引力。省略値0.95

entrained・steady・flowは音を参照する局所的な参加、metricは拍への同期です。 entrainment(0)なら、表に示した音響文脈による時刻への作用をなくします。 flowの不規則な間隔の抽選は残ります。生成側のmeterが持つのは一つの拍と整数比の 分割・小節であり、独立した非整数比のテンポを結ぶネットワークはありません。

entrainedの参加周期を更新するときは、まだ確定していない将来の予定までの残り時間を、 新旧周期の比で写します。確定した予定を新しい音響文脈で動かしません。

entrainedとflowは、過去のhabitat音声から得た短い未来の予期を使います。Voice自身が 合成した音も記録し、自分の反復を競合相手として扱わないようにします。発音予定の近傍で 鳴る、参加の1周期まで待つ、今回は見送る、を比較します。重なりは予定する保持時間と ADSRのreleaseを含む範囲で評価します。自分で見送った回数が増すほど次の見送りの 費用は増え、実際の発音指令で回数をリセットします。発音したときだけ周囲との関係の 記憶更新を予約し、対応する実音の観測が届いてから更新します。待ち、見送り、未実行の 予定を発音した経験にはしません。保持時間と重なり予測の音長は固有周期から求めるので、 参加周期の適応によって各音を引き延ばしません。三つの帯域のエネルギーを使う評価は 工学的な近似であり、聴覚上のマスキングや協和・融合のモデルではありません。

連続する音から反復を読む

TOMLの最上位にtemporal_meter_t2 = trueを置くと、production meterはhabitatの連続音から 反復を読みます。どのセクションよりも前に指定します。既定値のfalseでは発行された 発音イベントを使います。群のアクセントや到着予測を設定する[temporal_t2]とは独立です。

音から反復間隔の候補を得て、その後の音で支持を確かめます。周波数成分の変化と実際の 発音が位相と強度の手掛かりです。確信度は0から始まり、反復の証拠を表します。 拍の位相が正しい確率ではありません。欠けた観測は証拠を加えません。 metric()は、この確信度を伴う共有拍に追従します。ListenerTwinは提示側の発音から 独立した拍を読みます。オフライン描画は決定的な観測の締切を使い、演奏時は更新時点で 届いている観測を使います。

自分の発音予定を保つ:steady()

steadyで過ぎた機会や合法でない機会を進めるときも、固有周期の整数倍で進め、格子を ずらしません。持続音の初回のHold発音は、後続の格子とは別に従来どおり即時です。 費用の項や重みは変えません。いまの到来費用は鳴らすか見送るかを変えません。候補が 予定時刻一つで、見送りの比較から到来費用を除くためです。

let voices = place(harmonic().steady().sustain().intrinsic_rate(2.0)
    .seek_consonance().pitch_apply_mode("gate_snap"), line(220.0, 330.0).count(2));
wait(6.0);
release(voices);

timingのプリセットは後の指定が優先されます。flow().steady()はsteady、 steady().flow()はflowを選びます。音長は別軸の既存規則に従います。配置前の指定であり、 演奏中に呼ぶ語ではありません。明示のsustain()との順は問わず、見送った機会では 現在のToneを保ちます。Glide、GateSnap、Rearticulateとその境界、tie(省略時0)、 articulation_persistence、有限音長とrestの併用と優先順はままです。 Glideでも音高を採用した時刻の発音候補を足しません。音高の適用方法を演奏中に替えても Toneを保ち、その変更だけでは発音しません。再生成では保存した方策と速さを継ぎ、 初期位相、due、予定、演奏状態は新しく始めます。

Director水準の地形

演出者は次の操作で、metricが参照する生成側の拍の地形を調整します。 entrained・steady・flowの身体の速さや、反復予測の周期候補を直接指定する操作ではありません。

  • meter_stability(value) — 拍を引き込む深さ(attractor depth)を[0,1]で指定します。 既定値は0で、中立の状態です。拍が形成されやすい度合いに加え、好みのテンポに 寄せて拍を読む強さも、同じ深さで決まります。好みの中心はtemporal_basinの中心、 帯域を置かなければ2 Hzです。これは作曲者が置く、モデル化した聴き手の文化層の 事前分布です。実際の周期性への引き込みを強める操作であり、非周期の入力から 拍を作り出しません。
  • temporal_basin(min_hz, max_hz) — 拍が適応できるテンポの帯域を指定します。 拍はその中心から始まり、適応も帯域内に限られます。stabilityが0なら、中心を 好む重みも、中心へ戻す力も足しません。深くするほど、中心に寄せた拍の読みと、 確信度に依存する中心への復元が強まります。consonance(min, max)の時間軸版であり、 拍を配置したり、小節を強制したりはしません。同じ整形済みの中心を、metric()の Voiceが自走を始める速さにも使います。この初期値はstabilityに依存しません。 basinを置かなければ、metricの初期値は従来どおり2 Hzです。

basinはscene全体の初期条件です。scriptで最後に指定した値を、place()で 作る全てのmetricのPopulationに使います。Populationの配置後やwait()の後で指定しても、 同じsceneの初期値を上書きします。演奏途中で切り替える指定にはなりません。

身体が最初に刻む周期と、音から確認された拍は区別します。metricの各Voiceは別々の 初期位相を持ちます。音から拍を確認するまでは確信度と共有拍への結合は0で、確認後に 聴こえた拍へ近づきます。再生成したVoiceはPopulationに保存した初期設定から始まり、 親が演奏中に得た周期を継ぎません。entrained・steady・flowの固有ペース、pulse(rate_hz)で 明示した速さは、この初期化の対象外です。

既定の帯域で4 Hzの等間隔の入力を最初から観測する対照では、stabilityが0なら 4 Hzの拍、1なら2 Hzの拍の二分割として読みます。深さは駆動の強さと証拠を読む 速さにも従来どおり作用し、テンポの好みだけを独立に動かす操作ではありません。 間隔の仮説を初めて確認するまでは確信度を0に保ちます。ただし、確認後の不規則な 入力が偶然まとまり、一時的に確信度が上がる場合は残ります。

Floraにも場面全体のtemporal_basinが作用する。すべてのFloraは新しく確認された 実音の拍へ近づき、観測が未知、古い、または拍が未確認の間は中心の歩調を使う。 Floraにmetric()の切替はない。

Voiceごとのプリセットと調整

metric()、entrained()、steady()、flow()は速さの引数を取りません。place()より前に PopulationSpecへ設定します。時間関係と結合の省略値は上の表のとおりです。 参加の身体の尺度はintrinsic_rate(hz)で指定できます。

.entrained()とbrain("entrain")を混同しないでください。前者はonset timing、後者は Voiceの発音上の生と代謝を選びます。独立しており併用できます。

Voiceごとの設定で、参加の仕方を調整できます。

  • entrainment(strength) — [0,1]の影響の強さです。方式ごとの意味と省略値は上の表を参照してください。選んだプリセットの中で作用の強さを変えます。
  • rhythm_role("beat"|"subdivision"|"accent"|"texture") — metrical role。 accentは共有meterを強く駆動するonsetを出し、反復downbeatからmeasureを創発できる。
  • microtiming(amount) — metricの目標位置を拍位相でずらします。範囲は[-0.5, 0.5]、0.5は半拍です。entrained・steady・flowへ固定された発音位置を割り当てる設定ではありません。
  • measure_accent(amount) — 検出したmeasureに沿って、発音ごとの強弱を弱く変える設定です。 範囲は[0,1]、既定値は0。強度の倍率は1 + 0.35 * amount * confidence * cos(phase)です。 位相の原点は観測した強拍に合わせ、measureが未検出なら強度を変えません。 発音時刻は指定せず、rhythm_roleとは独立して働きます。
meter_stability(0.85);     // attractor depth: how readily a pulse forms
temporal_basin(1.8, 2.2);   // tempo region the emergent beat gravitates toward

let beat = harmonic()
    .metric()
    .rhythm_role("accent")  // a strong onset that drives the shared beat
    .cycles(2);

let entrained = harmonic()
    .entrained()
    .cycles(2);

let drift = harmonic()
    .flow()
    .cycles(1);

let offbeat = harmonic()
    .metric()
    .microtiming(0.5)       // a half-beat offset reads as syncopation
    .cycles(2);

place(beat, at(110.0));
place(entrained, consonance(110.0).peak().count(3));
place(drift, consonance(300.0, 1200.0).count(4));
place(offbeat, at(220.0));
wait(12.0);

下で説明する明示の持続と参加の併用を除き、同じ軸では最後の指定が優先されます。調整値は記憶され、対応するプリセットを選んだ時に適用されるため、 entrainment(0.8).metric()とmetric().entrainment(0.8)は同等です。

身体の固有の速さを置く

intrinsic_rate(hz)は、entrained()・steady()・flow()で初代として生成されるVoiceの 身体の尺度をHzで置きます。固有周期は1/hzです。発音の間隔を命じたり、共通の拍を 置いたりする語ではありません。entrainedは聴こえた反復へ参加の周期を寄せますが、 固有の値は生存中ずっと保ちます。steadyは発音予定の周期も動かしません。flowはこの尺度から不規則な更新間隔を作ります。 どの形も機会を見送れ、entrainedとflowは待つ判断もするため、身体の速さを違えても、実際の発音の 二つの速さが永久に保たれる保証はありません。

place()より前にPopulationSpecへ指定します。参加のプリセットとの 前後は問いません。演奏中の変更には使えません。再生成ではPopulationのtemplateの値を 読み、新しい初期dueと演奏状態から始めます。親が適応した参加周期、発音予定、発音の 方針は継ぎません。

同じ固有周期を、有限音長のcycles(n)とadaptive_duration()、rest(periods)、重なり予測の 代表的な保持長にも使います。速さを変えると、音の長さと間の秒数も一緒に変わります。 flowの音長には3倍係数が残り、ADSRのreleaseは秒指定のままです。有限音長を 指定しない持続音を、固有周期ごとに自動で切る働きはありません。

let slow = harmonic().sustain().entrained().intrinsic_rate(0.5)
    .seek_consonance().pitch_apply_mode("gate_snap");
let quick = harmonic().intrinsic_rate(2.0).sustain().flow()
    .seek_consonance().pitch_apply_mode("gate_snap");
let a = place(slow, at(220.0));
let b = place(quick, at(330.0));
wait(6.0);
release(a);
release(b);

ここでの速さは使い方の例で、推奨値ではありません。最終の指定がentrained・steady・flowなら、 有限の0.01〜200 Hzだけを受け入れます。範囲の外と有限でない値は、配置前のscript errorに なります。この範囲は実行を保護する値で、音楽的な推奨範囲ではありません。flowの更新間隔には 別の制限0.035〜4秒もあるため、極端な速さでは実際の間隔はrateに比例しません。 最終の形がmetric、pulse、repeat、onceなど対象外なら、値が不正でも警告して無視します。 省略時は2 Hzの経路を使い、metricのbasinの規約も変えません。

rhythm_freq(hz)はEntrainのアーティキュレーション内部の振動子を設定し、この参加の 尺度は変えません。proposal_interval(seconds)は音高を提案する機会の間隔であり、 発音を命じたり、身体の固有の速さを変えたりする語ではありません。

持続音を保ちながら参加する

sustain()とentrained()・steady()・flow()のいずれかを明示すると、Voiceは音を保ちながら、 参加の機会ごとに鳴らすか見送るかを判断します。entrainedとflowは時刻を待つ判断もします。書く順には依存しません。 sustain().entrained()とentrained().sustain()は同じ形です。 鳴らすと選んだ時は、旧いToneを離し、そのsampleの身体の音高で新しいToneを立ち上げます。 待つ・見送ると選んだ時は、鳴っているToneを保ちます。見送りを無音の間隙には変えません。 音高が同じでも、参加の機会で打ち直す場合があります。

let p = place(
    harmonic().sustain().entrained().seek_consonance().glide(0.03),
    consonance(220.0, 660.0).count(1)
);
wait(3.0);
release(p);

entrainedとflowの既定の"glide"では、新しい音高目標を採用した時に、そのsampleでの発音も、まだ決めていない合法な参加の機会へ 候補として渡します。時刻、音響の文脈、重なりの費用で比較し、同じ費用なら 候補を残します。既に決めた発音の予定は動かしません。採用時の発音が選ばれなければ、 音高は滑らかに移ります。採用と時計の発音が同じsampleに重なった時は、一回だけ発音します。 移動中に時計が発音を選んだ時も、その時点の身体の音高を使い、移動先へ先に跳びません。 release、死亡、removeは保留中の要求を取り消します。発行した発音は、通常のenergyと 音響の経路へ一回だけ渡ります。

参加の予測には、有限長の代表的な音のfootprintを使います。音を続ける案と、 旧音を離して打ち直す案の波形を、その場で厳密に描いて比べる仕組みではありません。 フレーズの境界の検出や、音程による打ち直しの閾値も追加しません。

この併用で音高の適用方法を省略すると"glide"になります。音高が自由なVoiceへ "gate_snap"を明示すると、採用した行き先を一つ保留し、参加の機会で鳴らすと選ぶまで 現在の音高を保ちます。鳴らすと選んだ時に旧いToneを離し、保留した音高で新しいToneを 立ち上げます。保留中に別の行き先を採用すれば置き換えます。待つ・見送る間は音も保留も 保ち、滑りません。tieを省略するか0なら、保留がない機会でも現在の音高を打ち直します。

GateSnapは採用時刻の発音候補を追加せず、参加の費用と見送りの規則をそのまま使います。 同じsampleでは採用を先に処理し、その後の機会で使います。未来の採用を先の発音に 使いません。release、死亡、removeは保留を取り消します。

let p = place(
    harmonic().sustain().flow().seek_consonance().pitch_apply_mode("gate_snap"),
    consonance(220.0, 660.0).count(1)
);
wait(3.0);
p.pitch_apply_mode("glide");
wait(3.0);
release(p);

演奏中のGlide、GateSnap、Rearticulateの切り替えでは、鳴っているToneを保ち、余分な発音を起こしません。 未出力の要求と、保留していた発音用の行き先は取り消します。Glideへ戻すと、音高の判断側に 残っている目標へ、次の制御更新から滑り始めます。GateSnapやRearticulateへ替えた後は、その後の採用を 保留します。同じmodeをもう一度指定した場合は保留を保ちます。再生成したVoiceはmodeを 継ぎますが、親の演奏中の保留は継ぎません。参加のプリセット自体は配置前の指定です。

この形にpitch_apply_mode("rearticulate")を添えると、rearticulate_above(cents)で 滑りと保留を組み合わせられます。最後の実発音音高から測り、正の境界以下の採用は 旧い保留を取り消して滑り、超える採用は滑りを止め、次に鳴らす機会まで行き先を保留します。 保留のない機会は、その時点の身体音高で打ち直します。待つ・見送る時も既に始まった滑りは 続きます。どの打ち直しでも最後の実発音音高を更新し、境界は時計の発音を間引きません。 境界の省略と0はGateSnapと同じです。参加の時計がないHoldのRearticulateは採用時に 発音し、この形では鳴らすと選んだ機会で発音します。

演奏中の境界変更は、それまで選んだ挙動を次の採用まで保ちます。mode変更では未出力の 要求、保留、選んだ滑りを取り消し、Toneと判断側の目標を保ちます。配置前の書く順に 依存しません。再生成したVoiceは設定を継ぎ、親の保留、滑りの選択、最後の発音音高は 継ぎません。

この発音方式を選ぶには、sustain()と参加のプリセットを組み合わせます。pulse()、repeat()と sustain()の併用は、従来どおり後の指定が優先されます。明示のsustain()とmetric()は、 下の持続+同期を選びます。rest()がない場合は、後に cycles()やadaptive_duration()で有限の音長を指定すると、持続する形を置き換えます。 rest()があれば音長と持続+参加を独立に保ち、音を離し、実際の余韻の終了から間を 数えます。音を切って間を置くを参照してください。

rest_on_habituation(w)は、明示のsustain()とentrained()、steady()、 flow()の組合せに、発音を続ける区間と休みを加えます。語の順序は問いません。 出生時に指定する重みは有限の非負値、既定は0です。1を超える値は、同じ式のまま出口の率を比例して大きくします。habitatの音から今の音高の近くで 繰り返し聴いたattackへの慣れが、区間を終える確率を高めます。次の合法な機会で Toneを離し、全ての余韻の終了を待ちます。その後は、このVoiceが実行したattackに 駆動される私的な状態で戻りを決めます。戻りは発音の許可であり、強制ではありません。 tieや形などのvetoは引き続き働きます。休みの間も時計と音高の提案は進み、保留した 音高は実際のOnで初めて消費します。これは作者規則であり、句や終止の知覚ではありません。

rest(periods)と異なり、休みの長さは固定の周期数ではありません。併用すると、 固定の休みの間は区間の退出と戻りの積分が止まり、私的な状態の回復だけが続きます。 configのhabituationの有効性、慣れと回復の時間を共有します。無効なら区間を終えません。 範囲外の重みや対象外の時間の指定はwarningとともに0として扱います。再出生は重みを 継ぎ、私的な状態は初期値から始めます。

発音の方針を保つ

自由音高の持続+参加にarticulation_persistence(p)を添えると、Voiceが音高の採用や 参加の機会をまたいで、発音の方針を保ちます。対象は、 sustain()とmetric()/entrained()/steady()/flow()を明示し、pitch_apply_mode("rearticulate")と 正のrearticulate_above(cents)を指定した形です。配置前の指定で、演奏中の Populationには呼べません。

let p = place(
    harmonic().sustain().entrained().seek_consonance()
        .pitch_apply_mode("rearticulate").rearticulate_above(50)
        .articulation_persistence(0.75),
    consonance(220.0, 660.0).count(1)
);
wait(3.0);
release(p);

この例の境界と保持確率は比較用の値で、推奨値ではありません。Voiceは、境界と 参加の規則に従うBaseから始まります。もう一つのConnectでは、Toneが生きている間、 大小どちらの採用でも滑り、参加が鳴らすと選んだ機会の発音を控えて、現在の音を伸ばします。 これは費用による見送りとは別の意図による抑止です。新しいTone、発音による回復、 発音由来の参加文脈の学習は起こしません。

小さい採用と費用による見送りはConnect、大きい採用と新しく鳴らすと選んだ機会はBaseを 提案します。0 < p < 1では、現在と反対の提案だけで専用の乱数を一回引き、確率pで 方針を保ち、1-pで替えます。同じ提案や待ちのhopでは引き直しません。既に決めた 将来の機会は、実行まで同じ判断を使います。Connectへ替わる時は旧保留を取り消し、 最後の実発音音高を保ちます。取り消した採用を後で再演しません。

pはつなぐ割合ではなく、方針の続きやすさです。保持はBaseにも働くため、pを 上げてもConnectの時間や発音数は単調には動きません。長さは出来事の回数で決まり、 秒や拍の数を指定しません。この保持は惰性であり、聴こえた終止、輪郭、間とは結び付かず、 フレーズの境界を推定する働きもありません。

既定の0と端の1は、私有状態や追加の乱数を通らず経路を使います。1では出生時の Baseのまま替わりません。有限値は0〜1へ丸め、正の無限大は1、負の無限大とNaNは0に します。対象外の最終指定は警告して無視します。書く順には依存しません。再生成では templateのpだけを継ぎ、方針、乱数の途中、保留、最後の発音音高を継がずBaseから 始まります。演奏中のmode変更はBaseへ戻します。同じmodeの再指定と境界だけの変更は 保持を続け、境界0の間は私有経路を休止します。

有限音のOff、rest()、余韻終了、間、release、死亡、removeは保持より優先します。 Toneが無ければ、Connectも合法な初回発音や休止後の復帰を塞ぎません。方針は個々の 発音や休止をまたぎますが、一音ごとに伸ばすか切るかを選ぶ働きではありません。

行き先がない機会では音を伸ばす

持続音を参加の機会で打ち直す形に、配置前のtie(p)を添えられます。pは、行き先の保留が ない時、いまのToneを打ち直さずに伸ばす確率です。自由音高のsustain()とmetric()/entrained()/steady()/ flow()に、明示のgate_snapまたはrearticulateを組み合わせる形が対象です。境界0も含みます。 省略時は、持続+同期では1、持続+entrained/steady/flowの参加では0になります。参加のVoiceは 費用によって機会を見送れます。明示のtie(0)は保留の無い機会でも打ち直し、tie(1)は 対象のToneを必ず伸ばします。中間では機会ごとに両方が混ざります。固定音高とGlideは tieの対象外で、metricの交差ごとに打ち直します。音楽的な最適値を決めたものではありません。

保留があれば、その行き先へ跳んで発音します。正の境界以下の採用は既に滑っており、 保留を作らないので、そのToneも伸ばす対象です。厳密に同じ音高だけに限りません。 gate_snapでは小さい採用や距離0の採用も保留するため、その機会は打ち直します。 発音は減り、機会から発音が抜けた列になります。機会の時刻、音高の提案、費用、 見送りの式は変えません。すべての音をつなぐレガートの量や、フレーズ単位の切り替えではなく、 聴こえた区切りとも結び付きません。

let voices = place(harmonic().sustain().entrained()
    .pitch_apply_mode("rearticulate").rearticulate_above(50).tie(0.5),
    line(220.0, 330.0).count(2));
wait(3.0);
release(voices);

この境界と中間の確率は使い方の例で、推奨値ではありません。伸ばした機会では新しいTone、 発音の代謝、発音由来の文脈学習を生じず、費用の見送りとしても学習しません。機会は消費し、 後で再演しません。articulation_persistenceを併せると、Connectの抑止を先に使い、tieの 乱数は引きません。Baseの保留ありは発音し、保留なしだけにtieを使います。tieで伸ばしても Base/Connectの提案や保持は変えません。大きい移動も滑らせ、発音を控えるConnectの 「つなぐ」方針とは別の量です。

Toneが無い時の合法な初回や、有限Off・余韻終了・rest()の後の発音は塞ぎません。 release、死亡、remove、休止の合法性が優先します。演奏中にpを変える指定はありません。 modeがGlideになっている間は休止し、対象に戻れば再び働きます。placeとcreateで 書く順に依存せず、再生成はtemplateの値だけを継ぎ、途中の乱数や保留、最後の発音音高は 継ぎません。有限値は0〜1へ制限し、正の無限大は1、負の無限大とNaNは0にします。 対象外の最終指定は警告して無視します。0ではtieの状態も乱数も使わず、1では乱数を引きません。 中間だけが個体別の専用系列を、機会の実行時に一度使います。

明示的なwhen/duration(Tier 2)

発音の時機を直接指定するにはonce()かpulse(rate_hz)、有限の音長を指定するには cycles(n)かadaptive_duration()を使います。

リズムを生存へ結びつける

rhythm_freq(hz)はEntrainのアーティキュレーション振動子を設定します。 rhythm_coupling_vitality(lambda_v, v_floor)は、その影響を活力に応じて変えます。 rhythm_reward(rho_t, "attack_phase_match")が効くのは、brain("entrain")の連続持続音で 自律的な発音が起きる場合だけです。有限のGated発音や、持続音と結合した発音機会では 協和度による通常の回復を使います。そこで報酬を明示すると、警告を出して無視します。

let living = harmonic().brain("entrain").sustain()
    .endurance(8.0).recovery(4.0)
    .rhythm_freq(2.0)
    .rhythm_coupling_vitality(0.8, 0.4)
    .rhythm_reward(0.4, "attack_phase_match");
place(living, at(165.0));
wait(8.0);

身体の固有周期は有限の音長と休止時間の基準です。参加の間隔が周囲の反復へ追従しても、 固有周期に基づく保持時間は引き延ばしません。flowの有限保持時間には3倍の係数を使います。 rhythm_freq()が設定する振動子と、intrinsic_rate()が設定する参加の身体的な尺度は別です。

Scaffold(research control)

scaffold functionは比較assay用の外部pulseを強制します。

scaffold_off();
scaffold_shared(2.0);
scaffold_scrambled(2.0, 17);

同期が比較や実演に不可欠な場合だけ使います。entrained・steady・flowの参加を成立させる補助として 専用の拍打ちを追加しません。

持続音を拍へ同期させる

sustain()とmetric()を両方明示すると、生きたToneを保ちながら、同期時計の 整数交差を発音の機会に使います。書く順は問いません。共有の拍は音から確認された拍です。 確認される前は、tempo basinの中心と独立した初期位相から自走します。外から拍を置く語ではありません。

初回はHoldと同じ即時の発音です。その後は拍の交差ごとに機会があります。自由音高の GateSnap/Rearticulateでは、既定は行き先の採用を保留した拍で発音し、ほかの拍では 生きたToneを伸ばします。tie(1)と同じです。毎拍打つにはtie(0)と書きます。 固定音高とGlideは、交差ごとにその時の身体音高で打ち直します。Glideは発音の間も滑ります。 GateSnapは最新の採用先を次の合法な交差まで保留します。境界0のRearticulateも同じです。 正の境界では小さい採用が旧保留を取り消して滑り、大きい採用は保留されます。 同じsampleの採用は、交差の発音より先に扱います。

let wire = harmonic().brain("drone").sustain().metric().seek_consonance()
    .pitch_apply_mode("rearticulate");
let voices = place(wire, at(660.0));
wait(4.0);
release(voices);
wait(2.0);

自由音高のGateSnap/Rearticulateにtie(p)を明示すれば、その値を使います。省略値は 配置前に解決し、演奏中のmode切替で対象に入っている間も同じ規則が働きます。 持続+entrained/steady/flowの参加は省略時0のままで、費用による見送りがあります。 tieの演奏中のsetterは追加しません。articulation_persistenceはBase/Connectを 保ちますが、同期には費用による見送りも、決めた予定を待つ状態もありません。方針の提案は 採用と発音の交差から来ます。rest()は明示の有限音長、実際の余韻の終了、間を組み合わせます。 その間も時計は進み、控えた交差を後で再演しません。

役割、確認された小節の強調、microtimingの意味は同じです。固定音高も持続+参加と同様に 扱えますが、tieとpersistenceは自由音高だけの量です。entrainmentや役割だけを指定した Coupledには、持続+同期の意味を広げません。

明示のsustain().metric()にも同じrest_on_habituation(w)を使えます。 既存の拍の交差で離し、戻りも合法な交差に限ります。通常のvetoは全て残ります。

評価の高い場所で再探索を遅くする

自由音高で seek_consonance() を指定した Voice に dwell(w) を加えると、 今鳴っている音高での環境評価が高い間、次の音高提案を遅くする。評価が低い間は 速くする。これは作者規則であり、調性の安定、型の形成、句の終止を実装するものではない。

let pluck = modal().sustain().metric().seek_consonance()
    .pitch_apply_mode("rearticulate").rearticulate_above(50)
    .proposal_interval(1.0).dwell(1.0);
place(pluck, consonance(196.0, 784.0).count(3));
wait(12.0);

提案の位相は実秒あたり max{0, 1+w*(1-2*L)} で進む。L は現在音高で 環境の score を補間し、共有の慣れを適用してから level に変換した値である。 音高の自己除外が有効で、ID と generation の一致した観測があればそれを使い、 無ければ混合の場へ戻る。生存選択のためだけの observer は音高の自己除外を有効にしない。 私的な適応、混雑、移動費用は含めず、有限でない評価は中立の 0.5 とする。

既定の重みは 0。初期設定だけの語で、有限の非負f32値には上限を置かない。負値は警告して0へ戻し、 f32への変換前または変換後に有限でない値も警告して0にする。対象外の Voice に正値を指定しても warning を出して 0 にする。 再出生・置き換えは重みを変異させずに継承し、位相は 0 から始める。 w>1 では L >= (1+1/w)/2 で止まり、L=0 では最大 1+w 倍の速さになる。 w=1, L=1 では提案が止まり、評価が下がると再開する。慣れは評価を中立の 0.5 へ 引き寄せるため、必ずその場所を離れるとは限らない。一定の評価なら周期的な結果にもなる。

変えるのは提案の時刻であり、打音そのものの減衰時間ではない。実際の On は採用、 再打音の閾値、保留先の上書き、合法な拍、veto に従う。rest_on_habituation の Gap 中も時計は進み、復帰時には戻さない。適応、glide、私的な attack の回復は実秒で進み、 移動費用の時間尺度も変わらない。

聴こえた発音に応えて選び直しを早める

respond_to_onsets(w) を指定すると、自由音高の Voice は、自分の音の外から新しい発音が 聴こえた後に、次の音高の選び直しを早めます。配置前だけ指定できる作者規則で、既定の重みは0です。 0では状態を作らず、何も読みません。

let line = harmonic().sustain().seek_consonance()
    .pitch_apply_mode("rearticulate").leave_self_out(true)
    .respond_to_onsets(2.0);
place(line, at(196.0));
place(flora().pace(1.0), random(98.0, 1568.0));
wait(12.0);

正の重みでは、Voice の自己除外の observer に、共有の発音検出器の写しを持たせます。 写しは Voice が生まれる前の混合の履歴から始まり、その後は habitat から自分の PCM を 引いた音を聴きます。自分の発音は履歴に入らず、ほかの音源を名指しすることもありません。 Voice の音高範囲の中でこの履歴が ρ だけ上がると、選び直しの時計に w·τ·ρ 秒を貸します。 τ = satiation_sec / ln 10 で、1秒あたり最大 w 秒ずつ使います。 まだ慣れていない新しい発音一つが貸すのは最大で w·τ·(1−e^(−period/τ)) 秒です。 period は発音が履歴を駆動する長さで、中心 2 Hz の basin では 0.5 秒、約 0.45·w 秒になります。 w が 4.6 ほどで、発音一つがふつうの約2秒の一周期ぶんを貸します。

高さを変えた後は、ふつうの選び直しの閾に当たる実時間が過ぎるまで、何も貸さず、何も使いません。 新しい音はふつうの一周期を保ち、新しい音どうしの最短の間隔は変わりません。 応答が縮めるのは、留まった選び直しの後の待ちだけです。早く来た選び直しも、 動くかどうか、どこへ動くかを、同じ場、同じ費用、同じ乱数の列で決めます。発音を強制しません。

貸した秒数で選び直しの時計は早く閾に届きますが、選び直しはふつうの機会を待ちます。 proposal_interval(seconds) を指定していない場合、生成側の meter の拍の確信度が正のあいだは、 その機会は閾に届いた後の、meter の分割の層の次の交差です。閾に届いた時刻そのものではありません。 選び直しのたびに時計は0から始まるので、閾を越えた分の貸した秒数は次の周期へ持ち越しません。 proposal_interval(seconds) を指定した場合は、間隔を越えた分が時計に残ります。

対応するのは、自由音高の seek_consonance() に sustain()、pitch_apply_mode("rearticulate")、 rearticulate_above(0) を組み、follow_own_sequence() と melodic_continuity() を使わない形です。 それ以外では警告して0にします。leave_self_out(true) が無い場合は一度だけ警告し、効きません。 自分の発音を含む共有の履歴へは戻りません。dwell(w) とは併用でき、その速さもそのまま効きます。 不明、未来、格子の変わった観測は何も足さず、比較の取り直しだけをします。 [psychoacoustics.habituation] enabled = false では履歴が動かず、一度だけ警告します。 記録は、正の重みの時だけ respond(使った一歩と選び直し。選び直しには、その周期で 余分に進めた秒数と、高さを変えたかを付けます)を足します。 これは作者規則であり、聴き手に応答が聴こえるという主張ではありません。

自分が鳴らした音程の列に沿う

follow_own_sequence(w) は、Voice が自分で実行した音程の列を学び、予測に沿う 次の音高を選びやすくする初期指定である。既定の重みは0で、機構は働かない。

let voice = modal().sustain().metric().seek_consonance()
    .pitch_apply_mode("rearticulate").rearticulate_above(0)
    .follow_own_sequence(0.05);
place(voice, consonance(220.0, 880.0));
wait(12.0);

候補のモデルは PPM-Decay(Harrison, Bianco, Chait, Pearce 2020) である。 記号への写し方と生成への結合は 作者規則 として区別する。最初の達成目標は、 自分が鳴らした音高の順序によって次の選択が変わることに限る。旋律の良さを保証せず、 音価、発音間隔、休み、和声の文脈、句や終止は学習しない。

初期版の対象は、自由音高の seek_consonance() と、明示的な sustain() および metric()、entrained()、steady()、flow() のいずれかを組み合わせた形である。 音高適用は gate_snap または rearticulate、rearticulate_above(0) とし、 articulation_persistence() は併用しない。既存の tie() の扱いは維持する。 metric() の省略値1も同様である。正の再打音閾値では小さな音高変更が滑らかに 適用されるため対象外であり、pitch_apply_mode("glide") も対象外となる。 呼出順ではなく最終形を判定し、対象外なら警告して語を無効にする。演奏中に条件を 外れると学習区間を閉じ、再び適合した最初の発音を新しい基準音とする。 休止や発音終了だけでは学習を消さない。

最初の発音で基準音を定め、二音目から直前の実行音との符号付き音程を学ぶ。 100 centへの丸めは学習と候補の評価だけに使い、出力音高を格子へ固定しない。 一回の裁定では予測分布を一度だけ取得する。従来の候補生成を終えた後に、 w * (log₂ p_candidate - log₂ p_current) を加える。二つの確率は、候補音高と現在の 目標音高が直前の実行音から作る音程の確率である。重みを大きくすれば和声の場より 系列が優勢になり、偶然の反復が強まる場合もある。停留や変奏は保証しない。 例の0.05は評価値/bitで測る小さな初期値であり、最適値や実験への適合値ではない。

有限の非負の重みに上限は設けない。負値と非有限値は警告して0にする。 替わりのVoiceは重みだけを受け継ぎ、学習と専用乱数列は新しく始める。 重み0では系列の学習、予測、乱数取得を実行しない。初期の対応範囲は常駐16状態、 一演奏600秒、各Voiceの音程4,800件、裁定38,400回、一裁定64候補、 20–20,000 Hz内の宣言音域である。資源上限を越えた系列の加算は替わりのVoiceまで 無効となり、減衰して小さくなった記憶を黙って捨てることはしない。 確率や評価値が非有限になった裁定も系列項を無効とし、数値異常として記録する。 実行・学習・裁定の記録では、実際の発音と未実行の目標音高を区別する。

局所的な句境界への反応

phrase_boundary(w) は、Voice自身が実行した音列に局所的な境界が見つかった後、一つの新しいSine Toneを弱める初期設定の語である。重みは有限の非負値で、既定は0。sine() に明示的な sustain() と metric()・entrained()・steady()・flow() のいずれかを組み合わせ、音高の適用を gate_snap または rearticulate にする。対象外の最終形は警告して無視する。

let voice = sine().sustain().steady().seek_consonance()
    .pitch_apply_mode("rearticulate").rearticulate_above(0)
    .phrase_boundary(1.0);
place(voice, consonance(220.0, 880.0));
wait(12.0);

候補のモデル:LBDM(Cambouropoulos 2001)。オンラインの写し方と境界の後の反応は作者規則。 原典の間隔の切り詰め、変化と近接の式、音高・IOI・休みの重み .25/.50/.25 を使う。上限は1 octaveと、出生時の身体周期4回分のIOI・休みで固定する。身体周期1回を四分音符に対応させるのは、原典の全音符の例を使う作者の約束であり、心理的な普遍定数ではない。

連続する6回の実行Onと、先頭5音の実効Offが揃ってから解析する。休みは記号的なOffから次Onまでの間隔であり、無音長ではない。release tailの重なりは許す。gateの重なり、同時On、pitch Update、記録の欠落、世代の変更では支持が切れ、未完の履歴と保留中の反応を捨てる。末尾のToneがまだ保持中でも、それ以前の間隔が完成していれば解析できる。各成分を中央3点の最大値で正規化し、正で両隣より厳密に大きい中央点だけを final-local として一度公開する。同値の山や比較できない列端を境界にしない。完成した全曲で正規化する版とは結果が異なる。

境界の位置と判明時刻を分ける。PX-1はrendererが実行した結果をhop完了後に公開し、次hopから読む。SQ-1は従来の発行段階の記録と同hop内の学習を維持する。共通なのは識別子と記録の表現であり、同じ確定済み自己列を共有するわけではない。

公開後の最初の既存候補機会で反応を使い切る。rest、lifecycle、Connect、tie等が新規Onを許さなければ、次の機会に持ち越さない。期限は公開時刻から、最後に観測した切り詰め前のIOI一つ分。合法な新規Onも期限内に実行され、identityが一致し、その間に別Onや支持切れがない場合だけ g = 1/(1+w*B) をToneの最終PCMに一度掛ける。予約の取消は別Toneへの転送にならない。

gainはtailまで保持し、habitat、presentation、自己除外用PCMに同じ音を渡す。strength、直接の代謝更新、候補時刻、releaseは変えない。Updateでもgainを保持する。予約中の自己予測はunsupportedとし、実行後の対応予測にはgainを反映する。音が変わった結果として後の知覚や選択が変わることはある。reportの phrase_boundary と phrase_execution で境界と実行結果を確認できる。将来の句末の計画やToddの強弱弧ではなく、反応が疎になる場合もある。原典corpusの再現、実装の一致、作者の音楽的な採用は別の判断である。

自分の音高履歴から次の音を選ぶ

melodic_continuity(w) は、Voice が確定した自己の On の音高列から、次の音の 分布を予測して選択に使う語です。重みは有限の非負値、単位は score/bit で、 初期設定専用です。既定の0では専用状態を作りません。たとえば、sustain() と seek_consonance() を使う自由音高の Voice に、metric()、entrained()、 steady()、flow() のいずれかと、pitch_apply_mode("rearticulate")、 rearticulate_above(0) を指定し、.melodic_continuity(0.1) を加えます。 0.1は書式例であり、試聴で採用した値ではありません。gate snap も対応します。 glide、正の再発音閾値、articulation persistence は対象外です。最終構成が 対象外の場合や重みが不正な場合は、警告して無効にします。

候補は von Hippel (2000) の音域と移動性による AR(1) です。半音座標で 平均は mu = m + r*(last-m)、分散は v = s²*(1-r²) とします。 原典 p.324 の印刷式に欠ける平均の加算と音域の尺度を、式(1)と本文に整合する 形で補っています。著者公認の訂正ではありません。全 prefix の標本分散、 隣接系列間の Pearson 相関、自己 On の入力、連続音高の対数密度差による 採点は 作者規則 です。入力は確定した命令であり、聴こえた PCM ではありません。

予測が既知の裁定では、移動費用と固定中心への tessitura gravity を、候補の peak 抽出から取り除きます。その候補を合法音域へ写し、同じ位置の重複を除いて、 現在位置との対数密度差を採点に加えます。予測平均の全域探索はしません。 follow_own_sequence は音程の順序を学ぶ別の候補なので併用できます。 SQ-1だけが失敗した場合はその項だけを除き、MEが失敗した場合は旧二項を含む 候補生成に戻します。正の重みを使うと旧項を置換するため、0からの連続的な 弱化にはなりません。

最低4音が必要で、分散が正と数値上確定できない場合は履歴を保持したまま unknown とし、現在の旧二項を使います。分散の下限、相関の clip、忘却窓は 加えません。中心・音域・対応可否の変更では保留制御を処理してから epoch を 切り替えます。休止や section の出入りだけでは、別の生存中の Voice の履歴を 消しません。replacement は重みだけを継承し、統計を空から始めます。 音高変化が後続の発音時刻に間接的に影響する場合はありますが、独自の時計、 休止、句境界、和声のモデルは加えていません。

実行範囲は退役中を含む常駐16 ME状態、Voiceごとに一意な On 4,801件と 裁定38,400回、1裁定64候補、Scenario開始から600秒、20–20,000 Hzです。 出生からの600秒ではありません。上限超過は replacement までMEを停止し、 旧二項へ戻します。併用時にはMEとPPMを別に数え、producerだけを共有します。 reportの melodic_continuity は予測値、未知の理由、旧経路との選択差を記録します。 tonalの型では試聴用の重みを継承します。既定のsensoryでは無効です。

聴いた和声の文脈に沿う

follow_tonal_context(w) は、直近に聴いた響きに適合する音高を選びやすくする 初期指定である。重みの既定値は0で、機構は働かない。

let voice = modal().sustain().metric().seek_consonance()
    .pitch_apply_mode("rearticulate").rearticulate_above(0)
    .dwell(0.75).follow_tonal_context(0.25);
place(voice, consonance(196.0, 784.0));
wait(12.0);

観測は候補である。公開IPEMへ照合した感覚的短期記憶モデルを使い、40帯域のANI、 periodicity pitch、局所/大域の半減時間0.1/1.5秒を保つ。仮説の実装を確かめるもので、 仮説自体の正しさや人の実験全体の再現を意味しない。標準の正弦試験音、表による近似、 相関の読み出し、音高の選好、dwellへの接続は作者規則である。

初版の対象は、自由音高の seek_consonance() と段階的な持続参加である。 sustain() に metric()、entrained()、steady()、flow() のいずれかを使い、 gate_snap または rearticulate、rearticulate_above(0)、articulation_persistence() なしとする。 対象外の最終形は警告して無視する。負値・非有限値は警告して0にする。 有限非負の重みには費用による上限を設けない。極端な加算結果は有限のf32 評価値範囲で 飽和する。実行中に対象外の形へ変更した場合は、この項を無効にする。

48 kHzで受け取ったhabitat PCMの全hopを一度ずつ処理する。leave_self_out に従い、 混合音の文脈または実PCMの mix - own を読む。出生時には自音混入前の解析器の全状態を複製する。 実行中の音を聴く範囲の変更は新しい観測区間を始め、PCMの欠測は、その演奏の文脈を未知として無効にする。 欠測を無音で補わない。ListenerTwinが有効な場合は、聴き手へ送るPCMを別に観測する。 H/R、habituation、生成用RNGは変えない。48 kHz以外では問い合わせは未知を返す。

既存の候補生成を終えてから、実行可能な音域に収めた候補と現在の目標音高の評価値へ w*qを加える。qは600 msの正弦試験音を仮想入力し、200–600 msの局所/大域相関を平均する。 候補または基準の音高が一つでも未知なら、その選択回の再採点を全部外す。 dwellは現在鳴っている音高を読み、既存sigmoidの前に同じ項を加える。 候補の問い合わせが未知でも、現在音の問い合わせが有効ならdwellは利用できる。 報告には観測状態の標本時刻、観測区間、問い合わせの既知/未知、選んだ目標音高を残す。

将来の最初の既定の聴き手の型では 0 <= dwell < 1 を条件とする。 1以上の上級設定は残すが、提案時計が停止し得る。時計が進んでも音高変更、離脱、転調を 保証しない。この語は既定の聴き手の型へまだ採用していない。

試験音表は約29.99–8000 Hzを1 centの対数周波数格子で覆い、周波数と時刻を線形補間する。 9,673点、PP値約1.05 GBの表を有効時だけ起動時に一度作り、枝間で共有する。 測定した機械では作成に約80秒かかる。これらは費用の目安であって上限ではない。 この費用のため、既定の聴き手の型PRE-1にはまだ含めない。 TCの自己除外枝はVoiceごとに観測の費用を加える。余韻を鳴らして退場中のVoice、ListenerTwin、既存の H/R・Flora、観測状態の配信と問い合わせを含む負荷で実時間性を確認する必要があり、問い合わせ単体の 速度を場面全体の対応負荷とは呼ばない。

近似の受入範囲は [0.25, 1] とする。全場面の362裁定で重み0.25、0.5、1を 調べ、近似によるargmaxの入れ替わりは4〜6件(約1〜2%)で、TCの効果の1/10以下 だった。dwell増分の0/正の入れ替わりは、調べた全設定で0件だった。重み0.125と2は 基準を満たさず、この範囲の外では近似の受入は未検証とする。この区間は3つの測定値に 基づいて採用した使用範囲であり、連続する全ての重みを走査した結果ではない。 語の値域は有限非負のまま、受入範囲の外でも警告を出さない。費用による上限ではない。

背景の変わり目を共有する

harmonic_rhythm(N)を指定すると、背景の通常の変化をN拍ごとの共通の機会に まとめられる。これは場面全体の初期前提であり、wait()の後に書いても途中からの 変更にはならない。最後の有効な指定が場面全体に適用されるので、配置より前に書く。 Nは非負整数で、省略と0は従来の動作を保ち、1は毎拍の機会を表す。Nは作曲者が 置く量であり、聴き手が推定した小節長ではない。この機構の根拠の札は作者規則である。

対象はすべてのFloraと、出生時にOnce/WhileAlive、自由な音高移動、再発音、 再発音閾値0を持つVoiceである。音高は各個体が選び、準備が整わなければ機会を見送る。 Voiceの最初の音は配置時刻を保つ。Floraの初回発音と、一時的に合法音域を外れたVoiceの 再開は共有機会を待つ。対象外のVoiceは従来どおり動く。この区分は音を聴いて前景と背景を 分ける処理ではない。参加中のVoiceをglideなどへ変更する競合設定はwarningとともに 拒否し、直前の設定を保つ。同時に指定した合法な音量変更などは適用する。

Floraは機会の間、振幅・位置・帯域幅・可聴windowの目標を保つ。生態、noise、slew、 消え際の音は進み続け、休止への移行と生態速度には従来の個体時計を使う。解放や支持喪失は 機会を待たず退出させる。休止から準備済みへ戻っても、それだけでは発音を再開しない。 共有時計は直前までのhabitat音の拍を読み、拍が未知ならテンポの前提で進む。 再捕捉しても位相や拍の残数をリセットしない。

調や和音の表、人が書いた進行は使わない。Nの実行中変更、小節頭への再整列、和声変化を 拍節の手がかりへ加える処理もない。揃えるのは新しい目標の確定時刻であり、知覚上の完全な 同時性や、和声のつながりの改善まで保証するものではない。

ルーティングとListenerTwin

二つのbus

各々のVoiceは、独立した二つのモノラルバスへ寄与します。

  • presentation bus → cpal出力 / offline render / UI metering(提示される作品)
  • habitat bus → 聴覚解析 → Landscape(ALife生態系が応答するもの)

初期状態では両方へ送られます。一方だけに送るにはsend()、両方を明示するには|で 結合します。

// Reference anchor: sensed by the ecology, absent from the presented sound.
let anchor = harmonic().brain("drone").send(habitat_bus);

// Presented decor that does not influence the ecology.
let decor = sine().send(presentation_bus);

// Explicitly both (the default).
let normal = harmonic().send(habitat_bus | presentation_bus);

place(anchor, at(110.0));
place(decor, at(880.0));
place(normal, consonance(110.0).peak().count(3));
wait(4.0);

バスの分離は作曲の道具です。send(habitat_bus)の隠れたanchorは聞こえずにPopulationの 組織化を変え、send(presentation_bus)のdecorは生態系を乱さずに聞こえます。

初期状態ですべてのVoiceを両方のバスへ送るのは、それがDirect Cognitive Couplingだからです。 聴き手が聴くものと生態系が知覚するものが同じ物理eventになります。分離は意図的な逸脱です。 send(habitat_bus)は聞こえずにFieldを形づくるterrain、send(presentation_bus)は 聞こえるが生態系の世界の外にあるdecorです。音高の基準を作るanchorと、専用の同期補助は 区別します。拍を打つ専用Voiceや時間的scaffoldを置くのは、明示的な同期が不可欠な サンプルだけです。habitat busだけへ送る場合にも、この制限を適用します。

ListenerTwin

Conchordalは、提示された音だけをmodel化するlistener側のListenerTwinを持ちます。 habitat busは読まないため、hidden scaffoldが偽のlistener tensionを作ることはありません。 listener_state reportには四つの知覚levelがあります。

  • stability_level — 現在聞こえる音の安定性 / consonance。
  • resolvability_level — 近くに、より安定したもっともらしい継続状態があるか。
  • tension_level — (1 - stability) * resolvability。現在は不安定だが改善経路がある状態。
  • attention_level — presentation由来のonset / spectral-flux salience。

listener側のmeter推定も含みます。

  • beat_hz、beat_phase、beat_confidence
  • subdivision_ratio、subdivision_confidence
  • measure_hz、measure_ratio、measure_confidence

generated_frame_id、analysis_frame_id、analysis_lag_framesは知覚遅延を明示します。 report eventと原因となった音を比較するときに重要です。

Twinを操作するscripting verbはありません。命令する対象ではなく観測する対象です。 report有効時にlistener_state recordを出し、GUIにも同じstateを表示します。generationへ 結合する前に、自分が聴くtensionとTwinのreportが一致するかを確認してください。

DCC:Twinを戻す結合

任意の結合であるDCCはscriptではなくconfig.toml(または--configで指定したfile)で 設定します。

[dcc]
# Listener pressure is report/UI-only by default.
# coupling_strength = 0.0
# max_temperature_bonus = 0.10
  • coupling_strength(0.0–1.0、既定値0.0):0.0ではレポートとUI専用で、 generationは変わりません。値を上げると tension_pressure = tension_level * coupling_strengthを 一時的な音高探索の加算値としてだけ使います。ListenerTwinの緊張度にはすでに 解決可能性が含まれるため、結合時に重ねて掛けません。目標音高やリズム同期を 直接設定しません。
  • max_temperature_bonus(既定値0.10):一時的な加算値の上限。

listener_stateが音楽的に読めることを確かめてからcoupling_strengthを少しずつ上げます。 結合中はdcc_pressure recordにpressureとtemperature bonusが記録されます。

タイムラインと構造

シナリオは音響標本を一つずつ予定表へ並べません。スクリプト上の時刻を進め、その時点で Populationを配置し、更新または終了する時刻を記述します。

place、wait、flush

place()は現在時刻に初代のVoiceをただちに配置し、安定したPopulationへの参照を 返します。wait(seconds)は保留中の更新を発行して時刻を進めます。flush()は 時刻を進めずに保留中の更新だけを発行します。

let spec = harmonic()
    .amp(0.04)
    .brightness(0.35)
    .sustain();

let population = place(spec, consonance(220.0).count(3));
population.amp(0.025); // Live patch at the same script time.
flush();               // Emit it; the cursor does not move.
wait(2.0);             // Advance two seconds.
release(population);

意味上の境界はwait()やflush()ではなくplace()です。発音体、振る舞い、生存過程、 再生成の初期設定はPopulationSpecに属し、実行中の更新と終了だけがPopulationに属します。

release、section、play

release(population)は明示的なreleaseです。section(name, callback)と play(callback, ...)は有効範囲を作り、関数が戻ると内部で作られたPopulationを 自動的にreleaseします。有効範囲の終了時にはreleaseより前に保留中の更新を発行します。

名前の付いたformにはsectionを使います。名前はreportのscene_markerになります。 引数を取る再利用可能なgestureにはplayを使います。

let gesture = |root_hz, duration_sec| {
    place(
        harmonic().amp(0.035).sustain(),
        consonance(root_hz).peak().count(3)
    );
    wait(duration_sec);
};

section("two gestures", || {
    play(gesture, 110.0, 2.0);
    play(gesture, 165.0, 2.0);
});

各playが作るPopulationは呼び出しの終了時にreleaseされます。外側のsectionはレポートの印を 提供し、その直下で作ったものを所有します。

Parallel timeline

parallel([callbacks])は現在時刻から複数のcursorをforkします。全branchは同時に始まり、 記述後の主時刻は最長の分岐の終端へ進みます。各分岐も一つの有効範囲であり、戻ると内部の Populationをreleaseします。

section("overlap", || {
    parallel([
        || {
            place(sine().amp(0.05).sustain(), at(220.0));
            wait(3.0);
        },
        || {
            wait(1.0);
            place(harmonic().amp(0.03).sustain(), at(330.0));
            wait(1.0);
        }
    ]);
});

第一branchはforkから3秒後、第二branchは2秒後に終わるため、main cursorは3秒進みます。 両分岐の有効範囲が重なる区間だけ、両方のVoiceが同時に鳴ります。

スクリプト上の時刻と実行時の振る舞い

スクリプト上の時刻は制御事象の時刻を決めます。その時刻のLandscapeを予測するものでは ありません。wait()でscenarioが進む間も、movement、coupled rhythm、death、respawnは 実行中も続きます。

  • scriptはmacro structureを書く。
  • Communityは瞬間ごとの振る舞いを生成する。
  • レポートは、記述された区間で実際に起きたことを示す。

演奏で説明した手順を使って結果を確かめ、scenarioを修正します。 特定の実現を再現するときだけseed(...)または--seedを使います。

シーン全体の設定と途中の変更

大域的な設定の名前は、いつ適用されるかを表します。set_のない meter_stability、temporal_basin、control_update_mode、scaffold_off、 scaffold_shared、scaffold_scrambled、seed、output_gainはシーン全体の初期条件です。 終わりを定めた曲では、wait()の後に書いても、最後の指定が全体へ適用されます。temporal_modeも 初期条件ですが、イベントを置く前に最上位で一度だけ宣言します。

set_roughness_aversion、set_harmonicity_preference、set_support_focus_preference、 set_support_conflict_preference、set_related_novelty_preference、set_global_coupling、 set_pitch_objectiveは、 その時点のスクリプト時刻に変更を置きます。wait()で変更の時刻を選べます。 配置、解放、有効範囲を作る語は、引き続き操作そのものを表します。

部屋の響きを選ぶ

room("presentation") を指定すると、客席にはステレオの反射音が加わり、生態系には直接音が届きます。地点を一つも指定しない曲では、客席は全音源を 12 m の距離で聴きます。 同じ曲を both で演奏すると、客席の響きは従来の 23.5 m 相当になります。 room("both") では、生態系にも反射音が届きます。自分の音を除いて聴く個体では、自分が出した音の反射も差し引きます。 反射音を使う場合のサンプルレートは 48 kHz です。room("off") はモノラルの直接音を選びます。 台本に宣言がなければ設定ファイルの [room].mode が効き、両方を省略すると off になります。

有限の曲では、最後の宣言が wait() の後にあっても曲頭から効きます。 endless() では最初に時刻を進める前に宣言します。both は個体別の履歴をあらかじめ確保できる有限の曲で使えます。

音源と耳を置く

有限の台本を conchordal-render で描画するときは、配置に site(x, y) を付けてメートル単位の座標を選べます。下の例では、線を (−12, 0) と (12, 0) のどちらに置いても客席からは 12 m です。線を (12, 0) に移すと、苔には線の直接音が強く届きます。

room("both");
let moss = place(flora().respond_to_onsets(2), random(200, 1000).site(12, 0));
let line = place(sine().sustain(), at(500).site(-12, 0)); // try (12, 0)
wait(4);

一つでも地点を指定すると、曲頭からすべての配置に距離が効き、無指定の音源は (0, 12) に置かれます。客席と生態系の共有の観測点は原点 (0, 0) です。直接音の振幅は、1 m を下限として耳までの距離で割ります。反射音への送りは距離によらず 1/23.5 なので、both では遠くの音ほど個体に届く残響の割合が高まります。すべてのモードで、複数の外音の相対的な大きさや、かすかな音が解析の床を越えるかどうかが変わります。二者だけの off/presentation で外音が一声なら、調波性・粗さの正規化が音量差をほぼ相殺します。絶対量を使う資源消費や音の重なりには距離が効きます。地点は固定で、伝搬の遅れ、左右の方位、発音中の移動は扱いません。全音源を (0, 12) に置くと、presentation で地点を省いたときと客席の直接音・反射音の比が揃います。地点を指定すると個体がその場所の音を聴くため、演奏自体は変わることがあります。

共有の慣れ、音響から学ぶ拍、音高集合の記憶は原点で聴きます。原点に近い音が共有の慣れや拍を支配しても、遠方の個体にはその音が小さく届きます。原点と客席の感度は 12 で、原点の近くでいくつもの音が重なると調性感・音高集合を読む IPEM の入力範囲 [−1, 1) で飽和しえます。左チャネルの max_p は最終 gain と limiter より前の客席音を測ります。個体の耳では 1 m 基準の振幅を保ちます。地点指定は有限の offline 描画で使えます。follow_harmonic_relations と follow_harmonic_continuation の重みは 0 を指定するか、省略します。

曲全体の再生音量

output_gain(db)で曲全体の再生音量をdB単位で指定します。整数と小数のどちらも使え、 省略時は0 dBです。終わりを定めた曲では、seedと同じく、wait()の後の宣言も含めて最後の指定が曲全体に 適用されます。途中の音量変化やフェードを作る操作ではありません。

output_gain(3.0);
play(|| {
    place(sine().amp(0.04).sustain(), at(220.0));
    wait(2.0);
});

指定値は設定ファイルの[audio].output_gain_db(既定値は off で +4.0 dB、presentation と地点指定のある both で −5.0 dB、地点指定のない both で −10.5 dB)に加算され、 振幅を10^((設定のdB + 曲のdB)/20)倍にします。楽器のスピーカー出力と、オフライン描画の WAV出力の両方で、出力リミッターの直前に適用されます。リミッターを無効にしても音量指定は 有効です。曲の指定を0にすると、設定ファイルで定めた再生音量を保ちます。音量を上げると、 ピークを抑えるリミッターが働く場合があります。

変わるのは再生音量だけです。音響解析、ListenerTwin、生態、レポート、UIの音量表示には 元の水準の音が渡ります。Populationの発音そのものや、生態に与える影響を変えるときは amp()を使います。

値は有限で、振幅倍率が有限かつ正のf32として表現できる必要があります。設定値と加算した 結果も同じ条件で検査し、不正な指定には宣言位置を付けてエラーを返します。この制限は f32の表現範囲によるものです。作品の音量目標や、それ以外のdB範囲は設けていません。

既知の終わりへ向けた表情

expressive_section(name, arch_weight, ritard_weight, callback)は、作者が明示した 最後の区間に強弱の弧と減速を付けます。Populationの所有と自動解放はsectionと同じです。 二つの重みは初期の指定だけに使い、有限の非負値を受け取ります。0では中立、1以上では 完全適用に飽和します。語を使わなければ従来の音を保ち、両方0ならsectionと同じ処理を通ります。

temporal_basin(1.6, 2.4);
meter_stability(0.55);
let pluck = modal().metric()
    .modes(stiff_string_modes(0.004).count(12))
    .brightness(0.42).adsr(0.004, 0.18, 0.0, 0.35).amp(0.04);
let pulse = place(pluck, line(196.0, 392.0).count(3));
section("opening", || { wait(4.0); });
expressive_section("ending", 1.0, 1.0, || {
    wait(8.0);
    release(pulse);
});

曲線にはTodd(1992)の単層の強度とFriberg–Sundberg(1999)のq=3の減速を使います。 これらは候補モデルです。作者の区間に割り当てること、振幅の床を加えること、生成時計を 一時的に固定することは作者規則です。句や終止を知覚したという意味ではありません。 既定の聴き手の型へ自動で加える機能でもありません。

初版の対象は、自由音高の再発音を伴わないOnceのVoiceと、持続しない同期型のmetric()の Voiceです。Flora、参加型の時計、持続するmetric()、follow_own_sequenceとの併用、 restは対象外です。対象外を含むシーンでは警告を出し、表情の効果全体を無視します。 既存の語の指定は消しません。非零の区間は一つだけとし、全Populationを終端までに解放します。 例のように外側で作ったPopulationには明示的なreleaseが必要です。関数を抜ける際の自動解放は 内部で作ったPopulationだけに働きます。区間後の配置や更新はできません。不正な重みや区間も 警告して効果を無視します。装置の設定時には、Onceの発音と解放が同じ配送hopに入る場合と、 変換後600秒を越える場合を、時間写像の適用前に診断します。

強弱は既に鳴っている余韻を含め、両busへ分ける前の発音に作用します。発音行為の直接の エネルギー更新には掛けません。完全適用では区間中央の振幅が√2倍になります。 減速の完全適用では区間長が約1.403倍になり、末端の速度は入口の0.3倍になります。 同期時計の入口の位相速度を保存し、区間内では速度の再抽選も停止します。感覚の観測、生態、 身体の包絡は実時間のままです。gate単位の音長は同じ写像に従い、解放の開始は遅くなりますが、 その後のフェードは元の秒数を保ちます。入口より前に予約済みのOffは元の実時刻を保ちます。 減速の重みは正ならどれだけ小さくても時計を固定し、0なら従来の時計を維持します。 区間名や予定された終端をListenerTwinの終止の知覚の根拠へ渡すことはありません。

Once は出生時に発音する形に限ります。Once の phonate_when_viable() は初版の対象外です。

終わりを定めずに演奏する

endless()を宣言すると、脚本が最後まで進んでも演奏は続きます。イベントが 尽きた後もVoiceは活動し、世代交代も続きます。すべてを解放した場合も自動終了せず、 無音のまま演奏者の終了操作を待ちます。endless()は最上位に一度だけ、再生イベントを 置く前、時刻を進める前に書きます。

endless();
let drone = place(sine().amp(0.04).anchor().sustain(), at(220.0));
wait(2.0);
drone.amp(0.025);
flush();

GUIの End または一度目のCtrl-Cで、残っているPopulation、Flora、Rainをそれぞれに 指定した長さでフェードさせて終了します。すでに始まっているフェードも最後まで待ちます。 Exit、ウィンドウを閉じる操作、二度目のCtrl-Cは即時終了です。

--duration <sec>を指定すると、その演奏時刻に終了を要求します。同じ処理区間に 予定されたイベントを配ってから解放するので、出力には解放後のフェードや余韻も含まれます。 終わりを定めた曲が指定時刻より先に終わる場合は、そのまま終了します。

終わりを定めない曲をconchordal-renderでWAVに書く場合、--durationが必須です。 楽器でも、この種の曲に--reportや--profileを付ける場合は--durationが必要です。 計測記録には処理区間数の上限があるので、フェードの余地を残してください。 WAVは起動時の長さの検査に加え、書き込み中にもRIFF形式の上限を検査します。 楽器自体には録音機能はありません。

終わりを定めない曲には、次の三つの規則があります。

  • seed、output_gain、temporal_mode、scaffold_*、 control_update_mode、meter_stability、temporal_basinは、最初に時刻を 進めるwait()より前に宣言します。いずれも演奏全体の初期条件です。
  • 自分自身の音を除外するPopulationには、配置前のPopulationSpecで leave_self_out(true)を指定します。その能力を後から新たに追加する更新はできません。 配置時に指定してあれば、無効にしてから再び有効にする更新はできます。
  • parallelは使えません。

終わりを定めない脚本は専用のスレッドで、演奏時刻の少し先まで逐次評価します。 終わらないループには、譜面時刻を進めるwait()を入れます。

endless();
loop {
    section("breath", || {
        let p = place(sine().sustain(), at(220));
        wait(4);
    });
    wait(2);
}

最初に時刻を進めるwait()で演奏全体の初期条件を確定します。時刻を進めずに脚本が 返る場合は、その時点で確定します。時刻0のイベントは確定するまで実行しません。 metric()で拍に同期するVoiceの初期値には、最後のtemporal_basin宣言を反映します。 最初のイベントより前にwait()を書いてもかまいません。初期条件の確定後に脚本で エラーが起きると、以後の評価は止まりますが、確定済みのイベントと生態系の演奏は 続きます。System欄で評価済み時刻、完了、エラー、同じ呼び出し箇所ごとにまとめた 警告を確認できます。

繰り返し配置するPopulationやFloraは、明示的に解放するか、処理を終えて解放する sectionやplayの内側で作ります。Voiceが自然に死んでも、未解放のPopulationの 記録は残ります。配置やRhai配列を解放せず増やし続ける場合、その保持量は作者側の管理です。

終わりを定めない曲のコンパイルのみの実行とWAV出力には、--durationが必要です。 その範囲を越えるwait()では、範囲の時刻で評価を止め、sectionやplayの内側で 作ったPopulationとFloraを解放します。この解放は同じ時刻の演奏終了要求より先に 実行します。--compile-onlyでは end: open (evaluated through t=…)を表示します。有限曲は従来どおり一括評価し、 parallelも利用できます。1処理区間内の操作数や、操作に付随するデータの保持量が 受け渡し用のキューの容量を超えると、WAV出力とコンパイルのみの実行は、同じ譜面時刻で 容量超過のエラーになります。

脚本から使える機能

終わりの有無にかかわらず、すべての脚本でevalとファイルを読むimportを禁止します。 sleepとtimestampもエラーになります。演奏上の時刻を進めるにはwait()を使います。 実時間をtimestampやelapsedで読み取る経路と、sleepで評価を止める経路を閉じることで、 脚本とseedから演奏予定が定まります。診断用のprintとdebugは引き続き使えます。

調的文脈の観測を予約する

終わりを定めない曲で正の重みのfollow_tonal_contextを配置する場合、時刻を進める前、 その配置より前にobserve_tonal_context()を宣言します。これは作者規則です。演奏開始時から 調的文脈の観測器と表を用意し、後から生まれるVoiceにもそれまでに聴いた履歴を渡します。 時刻が進んだ後の宣言と、宣言なしの正の重みの配置は、位置付きの脚本エラーになります。 有限の曲では宣言は不要です。書いた場合は警告して無効にし、従来どおり配置の先読みにより 観測器の要否を決めます。

終わりを定めない曲では、共有のonset habituationを演奏開始時から観測します。 後のrest_on_habituationの配置を予見できないためです。有限の曲は正の重みの利用者が ある場合だけ観測器を用意します。harmonic_rhythmも、終わりを定めない曲では最初に 時刻を進めるwait()より前に宣言します。

支持の集中・競合・関連する新規成分への三つの選好は、いずれも既定値が0です。 集中と競合には符号付きの有限値、新規成分には0以上の有限値を指定します。 聴いた音の一次の支持場を身体の部分音で積分する作者規則です。Voiceの移動には leave_self_out(true)が必要で、自己除外がないVoiceでは正の重みを一度警告し、 移動への加点を無視します。出生のpeak・density・tensionとFloraのlane選択にも作用します。 Floraの成長、慣れ、ListenerTwinの入力は変えません。部分音の密度は身体のスペクトルの 自己申告から出生・再構成時に保存します。自己申告がない身体は基本周波数の単一部分音として 読み、その旨を表示します。これは仮想的なPCMの混合結果を予測する評価ではありません。

follow_harmonic_relations(w) と follow_harmonic_continuation(w) はcursor eventで、 有限の [-1,1]、既定0の符号付きの性向を取ります。関係は、動くときの行き先について 正なら学んだ関係への適合、負なら離脱を好みます。継続は、正なら保持・待機・出生見送り、 負ならその逆の方向を、学んだ継続の支持に応じて評価します。関係だけでは既定の 「動く/保つ」を変更しません。どちらも作者規則であり、既存の慣れや身体費用を含む scoreへ加算します。未知の証拠は中立、両方0なら元の経路と乱数列を保ちます。 固定の調や進行profileを使わず、性向の変更でも履歴は残ります。 シーンの途中で変更する場合は、wait()でcursorを進めてから指定します。

endlessでの和声観測の予約

endlessでは縦の支持scanを演奏開始時から公開し、三つの評価重みが0の間も観測します。 時間方向の関係モデルは、時刻を進める前にobserve_harmonic_relations(max_sources)で 別に予約します。正の整数max_sourcesは退役中を含む同時VoiceとFlora laneの最大音源数で、 上限38400は既存の構造記録の容量に由来し、音楽上の上限ではありません。時間の二語は 正負いずれかの非零重みを使うときに宣言が必要で、未宣言と遅い宣言は位置付きの脚本エラーです。 有限の曲では宣言を警告して無視し、観測器と音源容量は従来どおりeventの先読みで決めます。 宣言だけでは評価重みは有効になりません。宣言は作者規則で、既存の600秒の移動履歴と 対応するevent密度の範囲を変更しません。

APIリファレンス

このページは、engineに登録されたスクリプティング面とドキュメントregistry (src/scripting/docs.rs)から生成されます。engineとの差異はCIテストで検出されます。再生成するには次を実行します:

cargo run --bin gen_rhai_defs

文字列の選択肢は小文字の正規名を使います。大文字、別名、前後の空白は受け付けず、入力位置を示すエラーで停止します。

構築用のメソッドは操作対象を返すため、続けて呼び出せます。整数と小数は、両方のoverloadが登録されている箇所では交換可能です。正確なoverloadは生成されたLSP定義(rhai-defs/conchordal.d.rhai)に記載されています。

スクリプティング面は四層に分かれます。Core APIは作曲用の基本語彙です。Experimentalと併せてトップレベルのサンプルを記述できます。Experimentalは試聴中のCore候補です。Mechanism Tuningは、Coreでは表せない挙動を作品が必要とするとき、動詞の背後にある機構を調整します。Research Controlsは作曲ではなく、instrumentを研究するためのものです。関数ごとの技術説明は、LSP hoverと同じ英語の単一ソースを掲載しています。

根拠の札は機構の部分ごとに付き、公開用途の区分とは独立です。機構の根拠と作曲者の選択を参照してください。札の追加は既定値の変更や受入の認定ではありません。

型

型説明根拠
FloraSpecflora()で作る、スペクトル成長の再利用可能な設定。周波数範囲に配置するとFloraになる。該当なし(APIの器):構築・操作に使う語の札を参照。
Flora配置されたスペクトル成長。振幅と拍に対する生態時間の倍率を更新でき、解放を指定できる。該当なし(APIの器):構築・操作に使う語の札を参照。
RainSpecrain()で作る、打音のtextureの再利用可能な設定。周波数範囲に配置するとRainになる。該当なし(APIの器):構築・操作に使う語の札を参照。
Rain配置された打音のtextureと共鳴する物。amp、rate、sway、hit、widthの更新と解放を指定できる。該当なし(APIの器):構築・操作に使う語の札を参照。
PopulationSpec再利用可能なPopulationSpec。初代のVoiceの特性に、生存過程、respawn、個体数の規則を組み合わせる。該当なし(APIの器):構築・操作に使う語の札を参照。
Populationplace()が返すPopulation。Voiceが死亡し世代交代しても、同一性を保つ安定した参照。該当なし(APIの器):構築・操作に使う語の札を参照。
Placement初代のVoiceをどこへ配置するかを表す。at()、consonance()、dissonance()、edge()、gap()、random()、line()で作る。該当なし(APIの器):構築・操作に使う語の札を参照。
ModePatternモーダル合成の発音体に使う周波数構成。*_modes()関数で作る。該当なし(APIの器):構築・操作に使う語の札を参照。
Bus二つのmono出力busの一つ。`で結合するとBusSet`になる。
BusSet`busbusで作るbusの組み合わせ。send()`へ渡す。

組み込み定数

定数型説明根拠
habitat_busBus解析bus:聴覚解析を経てLandscapeへ送られ、生態系が知覚する。該当なし(経路):busの選択・結合。独立した自己知覚の規則はleave_self_outを参照。
presentation_busBus提示bus:cpal出力、録音、UI meterへ送られ、聴き手が耳にする。該当なし(経路):busの選択・結合。独立した自己知覚の規則はleave_self_outを参照。

Core API

作曲用の基本語彙です。Experimentalと併せてトップレベルのサンプルを記述できます。

Flora

Floraは、Landscapeを入力とする作曲上の規則で、指定した周波数範囲にスペクトルの重みを成長させる。聴覚認知のモデルではない。

amp

amp(level)

適用対象:FloraSpec, Flora。

Set Flora’s nominal target-amplitude scale in [0, 1], a ceiling rather than a guaranteed level. Squared lane target amplitudes sum to at most amp squared; this does not bound transients or output power. Numeric arguments must be finite before and after f32 conversion. Invalid values raise script errors. Live patches emit at wait, flush or scope end and glide to the new level over this Flora’s fade() seconds (at least 80 ms).

根拠: 該当なし(初期の身体):Floraの身体、振幅、fadeの選択。flora、paceを参照。
作者規則:背後のスペクトル成長、消費、退出の生態則。聴覚認知のモデルではない。

pace

pace(multiplier)

適用対象:FloraSpec, Flora。

Set Flora’s ecological speed relative to its private beat clock with a minimum of 1/64 and no cost-based upper bound (default 1). Ecological speed is (f/2 Hz)min{k,20r}: one 10-second renewal per nominal opportunity. Ratio r is 1 for beats/fallback; k>20 enables confirmed subdivisions of 2, 3 or 4. Supported tonal/residual amplitude targets and joint normalization follow biomass each hop through the existing slew; confirmed opportunities gate births and discrete replacements. Fallback retains continuous allocation. Retirement shares saturation; beat phase, birth slew and macro fade keep their clocks. Finite f32 values above the minimum are retained. Subminimum values, NaN and negative infinity warn and use 1/64; positive infinity/overflow warn and use f32::MAX. Live patches emit at wait, flush or scope end. Whole-scene real-time cost remains the composer’s responsibility. See the Flora chapter for details.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
作者規則:生態時間の速度、行動機会、既定倍率1、機会あたり10秒の生態時間の飽和(§9.3.97–99, §9.3.102)。

leave_self_out

leave_self_out(enabled)

適用対象:FloraSpec。

Exclude Flora’s own habitat PCM from growth consonance and seed harmonicity. Default true, unlike Voice’s false: one Flora has many partials whose own harmonic lattice can sustain its growth and seed positions. Set false before placement to read mixed C/H without an H/R observer. External resource power always excludes own PCM. Presentation-only Flora reads mixed C/H regardless of this setting.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:自己除外。Voiceの既定はfalse、Floraはtrue。Voiceは既定ではH/Rの両方から自己を除き、tail_roughness_aversionで実際のOff/On音高候補のRだけを選択的に混合する。environmentの回復とFloraの契約は維持(§9.3.95、§9.3.120)。

send

send(bus_or_set)

適用対象:FloraSpec。

Route Flora to a Bus or BusSet, using the same buses as Populations. Default: habitat_bus | presentation_bus.

根拠: 該当なし(経路):busの選択・結合。独立した自己知覚の規則はleave_self_outを参照。

place

place(flora_spec, placement) -> Flora

Place a Flora over a consonance or random frequency extent. Consonance seeds from the base consonance density mass before habituation; random seeds uniformly. Requires count 1, density sampling, zero tension and target-default spacing. Bounds follow field placements and must span at least 1/96 octave, one initial Log2Space bin. Scoped Flora releases at scope end.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

release

release(flora)

Mark a Flora for release using its spec’s fade. The next wait, flush or scope end emits its pending patch before ReleaseFlora in one event. Repeated release and release after scope end warn and are ignored.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

pitch_apply_mode

pitch_apply_mode(name)

適用対象:FloraSpec, Flora。

Choose tonal peak following (glide, default) or fixed-pitch replacement (rearticulate). Rearticulate holds each tonal lane at birth frequency through its tail, including between beat crossings. Beyond the 50-cent claim radius, lanes retire and replacements follow existing beat, slew and pool rules. Live changes preserve sounding lanes; the next allocation applies the new rule, holding current pitch when switching from glide. Residual noise keeps its centroid motion. Unsupported names, including gate_snap, warn and retain the previous mode. Patches emit at wait, flush or scope end.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

rest_on_habituation

rest_on_habituation(weight)

適用対象:FloraSpec。

Alternate Flora spans and gaps using heard attack habituation (finite nonnegative weight, default 0). Zero creates no private span state. Positive weights use the full habitat attack history (at the placement in a spatial score), averaged over sounding tonal frequencies by target power. Exit requests retire all tonal and residual lanes at a private beat crossing. Ecology continues during gaps; births wait until a return crossing after every tail ends. Actual lane births alone drive private recovery. Release and fade take priority. Invalid values warn and use zero. This is initial-only; the observer starts at scene start, including before later Flora placements.

根拠: 原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
作者規則:spanの確率的な退出と私的回復・復帰。重み0で中立(§9.3.96、§9.3.101)。

Rain

Rainは、打音を一つずつ分布から引き直して周波数範囲に降らせる。配置の指定で、自由な分布かLandscapeに従う分布かを選ぶ。打音は一つの素材を毎回少しずつ変えて鳴らす。共鳴する物は協和の山に置かれ、打音が当たると鳴り、当たるたびに半音まで協和の高い方へ移る。anchor()で高さを固定できる。作曲上のtextureの規則で、聴覚認知のモデルではない。

amp

amp(level)

適用対象:RainSpec, Rain。

Set Rain’s output scale in [0, 1]. Scales impacts and objects together. Live patches ramp over 80 ms and emit at wait, flush or scope end.

根拠: 該当なし(初期の身体):Rainの振幅、fade、打音の素材、物の身体。rainを参照。

anchor

anchor()

適用対象:RainSpec。

Hold Rain’s objects at their placement pitches. Without it, an object drifts toward higher consonance by at most a semitone each time it is struck.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:物は協和の山から始まり、打たれるたびにVoiceの移動費用の既定値で協和の方へ動く。anchor()で固定する。

send

send(bus_or_set)

適用対象:RainSpec。

Route Rain to a Bus or BusSet, using the same buses as Populations.

根拠: 該当なし(経路):busの選択・結合。独立した自己知覚の規則はleave_self_outを参照。

place

place(rain_spec, placement) -> Rain

Place a Rain over a field or random frequency extent. random(lo, hi) draws impact centres log-uniformly. consonance, dissonance, edge and gap follow the same density masses as Voice placement, rebuilt each hop; zero mass falls back to log-uniform. Count must be 1, with density sampling, no tension and the default spacing.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

release

release(rain)

Mark a Rain for release using its spec’s fade.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

PopulationSpec

PopulationSpecは、初代のVoiceの特性とPopulation全体の生存規則を定める。生成関数で作り、構築用メソッドで調整し、place()でPopulationにする。

sine

sine() -> PopulationSpec

PopulationSpec whose founder voices use a pure sine body.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

harmonic

harmonic() -> PopulationSpec

PopulationSpec whose founder voices use a harmonic-series body.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

modal() -> PopulationSpec

PopulationSpec whose founder voices use a resonator-based modal body; shape it with modes().

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

saw

saw() -> PopulationSpec

Harmonic-body preset with brightness 0.85.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

square

square() -> PopulationSpec

Harmonic-body preset with brightness 0.65.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

noise

noise() -> PopulationSpec

Harmonic-body preset with brightness 1 and motion 1 (mainly vibrato; jitter is not perceptible in the measured configuration).

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

配置

Placementは、初代のVoiceが周波数空間へ入る場所を決める。生成関数で作り、place()へ渡す前に調整する。

site

site(x, y)

適用対象:Placement。

有限の offline 描画で、配置にメートル単位の固定座標を与える。客席と共有の観測点は (0,0)。一つでも地点を使うと曲頭から全配置に距離が効き、無指定の配置は (0,12) になる。全地点を省略すると、客席は presentation では 12 m、both では従来の 23.5 m 相当の響きで聴く。直接音の振幅は 1 m を下限として距離で割る。both では個体の耳に届く直接音と反射音の比も変わる。詳しくは「部屋の響きを選ぶ」を参照。

根拠: 原理:自由音場の直接音圧は距離に反比例し、直接音と反射音は線形に重なる。
作者規則:距離の下限1 m、一様な残響送り、共有点の感度、固定配置は作曲用の設定。

at

at(freq_hz) -> Placement

Place at a fixed frequency in Hz, or start an explicitly moving voice here. With explicit seek_consonance() and free pitch, this sets the starting position. Otherwise it locks the pitch. freq() and anchor() lock it; seek_consonance() enables movement.

根拠: 該当なし(配置):開始位置、範囲、個体数(§9.3.56)。

consonance

consonance(root_hz) -> Placement
consonance(min_hz, max_hz) -> Placement

Target consonance maxima. Density cloud by default; .peak() for the extremum. consonance(root) takes a harmonic window around a root (default 1x-4x, set multiples with range()); consonance(min, max) takes an absolute range. Default spacing is 1.0 ERB.

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

dissonance

dissonance(min_hz, max_hz) -> Placement

Target consonance minima (tension, clusters). Density cloud by default; .peak() for the most dissonant point.

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

edge

edge(min_hz, max_hz) -> Placement

Target the consonance/dissonance boundary (C near its midpoint). The metastable region between fusion and beating. Density band by default; .peak() for the point closest to the boundary.

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

gap

gap(min_hz, max_hz) -> Placement

Target empty registers (low subjective intensity); fill the room. Density cloud by default; .peak() for the emptiest position.

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

peak

peak()

適用対象:Placement。

Realize a field target as its deterministic extremum.

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

density

density()

適用対象:Placement。

Realize a field target as a stochastic cloud (the default).

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

tension

tension(degree)

適用対象:Placement。

Bias Consonance placement toward a field-score step below the in-range maximum (degree 0..1). Consonance placement only. 0 leaves ordinary Consonance placement unchanged: peak() selects the strongest peak, while the default density remains the ordinary Consonance cloud. Higher values target a weaker, more tense step (target = L_max - degree*(L_max - L_min) over the range, in field_score). Pairs with peak() (nearest step, sharp) or density (a broader cloud around it).

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

random

random(min_hz, max_hz) -> Placement

Log-uniform random placement inside a frequency range.

根拠: 該当なし(配置):開始位置、範囲、個体数(§9.3.56)。

line

line(start_hz, end_hz) -> Placement

Linear interpolation of positions between two frequencies.

根拠: 該当なし(配置):開始位置、範囲、個体数(§9.3.56)。

count

count(n)

適用対象:Placement。

Positive number of founder voices to place (default 1).

根拠: 該当なし(配置):開始位置、範囲、個体数(§9.3.56)。

range

range(min_mul, max_mul)

適用対象:Placement。

Multiplier range relative to the root; only valid on consonance(root).

根拠: 該当なし(配置):開始位置、範囲、個体数(§9.3.56)。

spacing

spacing(min_erb)

適用対象:Placement。

Minimum ERB distance between placed voices; valid on field placements.

根拠: 該当なし(配置):H/Rと作者が定めたConsonance Fieldの評価を入力とする。set_roughness_aversion、set_harmonicity_preference、set_pitch_objectiveを参照。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:極値・密度・間隔・緊張に基づく選択(§9.3.56)。

TimelineとPopulation

place()は現在のスクリプト時刻にPopulationを配置する。wait()は時刻を進め、flush()は時刻を進めずに保留中の更新を発行する。有効範囲が終わると、内部のPopulationは自動的に解放される。

place

place(population_spec, placement) -> Population

Create a Population at the current script time. place() is the sole Population boundary. Configure initial-only properties on the PopulationSpec first; the returned Population exposes only live patches and release.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

observe_harmonic_relations

observe_harmonic_relations(max_sources)

終わりを定めない曲で、時刻を進める前に和声関係の履歴を予約する作者規則。二つのfollow_harmonic語を正負いずれかの非零の重みで使う場合に必要。max_sourcesは退役中を含む同時VoiceとFlora laneの最大音源数を表す正の整数で、構造記録の容量38400を超えられない。観測は演奏開始時から行う。遅い宣言と未予約の非零制御は位置付きの脚本エラー。有限の曲では警告して宣言を無視し、従来どおりeventを先読みする。縦の支持scanはendlessで宣言なしに開始時から観測する。

根拠: 作者規則:終わりを定めない演奏で、開始時から和声関係の履歴と音源数の容量を予約する。

observe_tonal_context

observe_tonal_context()

終わりを定めない曲で、時刻を進める前に調的文脈の観測を予約する作者規則。正のfollow_tonal_contextを配置する前に宣言すると、演奏開始時から観測器と共有の表を用意する。遅い宣言と未予約の正の配置は位置付きの脚本エラー。有限の曲では宣言は不要で、書いた場合は警告して無効にする。有限の曲の表の要否は従来どおり配置の先読みで決まる。

根拠: 作者規則:終わりを定めない演奏で、開始時から調的文脈の観測を予約する。

endless

endless()

Declare an open-ended performance before playback events and time advances. Call once at top level. After the script returns, the ecology keeps sounding, even with no queued events. End with the GUI End button, the first Ctrl-C, or –duration; Exit and the second Ctrl-C stop immediately. Evaluation runs incrementally on a dedicated thread. Unbounded loops must advance score time with wait(). Declare scene headers before time advances; parallel is unavailable. Release repeated placements or scope them with section/play. Compile-only and render require –duration.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

wait

wait(seconds)

Emit pending live patches, then advance the timeline cursor.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

flush

flush()

Emit pending live patches without advancing time.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

release

release(population)

Close a live Population; its voices enter their release phase and fade out. Release is terminal at the scripting surface: later live patches on the same Population are ignored.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

listener_profile

listener_profile(name)

Choose the scene’s initial listener profile: sensory (default) or tonal. Call before scene actions/scopes. Sensory preserves the author-rule base. Tonal inherits follow_own_sequence=0.05, melodic_continuity=0.00076066292, phrase_boundary=1, and final-section arch/ritard=1/1. These are audition weights, not author-adopted values; ME matches the displaced terms’ mean absolute contribution. Candidate models and author-rule adapters retain their individual evidence labels. TC is excluded: its table costs about 1 GB/80 seconds and approximation acceptance covers [0.25,1] at measured weights 0.25/0.5/1. Explicit Population values, including zero, win. Unsupported final Voices are silently skipped. Expression requires existing whole-scene PE support; absent/unsupported sections are silent. Explicit expressive_section, including zero, wins. Individual axes default to zero; sensory remains the default until separate author adoption.

根拠: 該当なし(型の選択):候補モデルと作者規則の札は follow_own_sequence、melodic_continuity、phrase_boundary、expressive_section を参照。

expressive_section

expressive_section(name, arch_weight, ritard_weight, callback)

Give a known final section a loudness arch and a shared slowing clock. Initial-only finite nonnegative weights, neutral at zero and saturated at one. Same scope and releases as section. Acts on all Voice PCM, including outer populations and tails. Supports immediate Once without free rearticulation and non-sustained synchronized metric voices; Flora, participation, sustained metric and rest are unsupported. Every population must be released by the end. Unsupported scenes warn and ignore the whole effect. Ritard freezes generation phase velocity and renewal while auditory observation continues; gate durations follow the score map, body envelopes and release tails keep physical seconds. Only one nonzero final section; both zero follows the unchanged section path. This is authored form, not perceived closure.

根拠: 候補:Todd (1992) の単層の強度と Friberg–Sundberg (1999) の q=3 の時間曲線。脳機構の確定ではない。
作者規則:既知の最終区間、重みの飽和、振幅の床、生成時計の固定と対象の制限(§9.3.109)。

section

section(name, callback)

Named scope; populations placed inside are released when the callback returns.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

play

play(callback)
play(callback, arg1)
play(callback, arg1, arg2)
play(callback, arg1, arg2, arg3)
play(callback, [args])

Scoped callback execution with automatic population release. Accepts 0-3 positional arguments, or an array of arguments.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

parallel

parallel(callbacks)

Run an array of closures on parallel timelines from the current cursor. Each branch starts at the current cursor; the cursor advances to the latest branch end.

根拠: 該当なし(大きな形):Scenarioの時間構成、配置、解放。入力の機構の札は各語を参照。

room

room(mode)

曲全体の響きを選ぶ。off はモノラルの直接音、presentation は客席にステレオの反射音を加え、both は生態系が聴く音にも反射を加える。地点を一つも指定しない場合、客席から音源までの距離は presentation で 12 m、both で従来の 23.5 m 相当。有限の曲では最後の宣言が曲頭から効き、設定ファイルの [room].mode に優先する。反射音を使う場合は 48 kHz。endless では時刻を進める前に宣言する。both は有限の曲で使える。

根拠: 原理:直接音と反射音の線形重ね合わせ。固定のインパルス応答は特定の測定条件を近似する。
該当なし(作曲):どのバスに部屋の響きを加えるかは作曲者が選ぶ。

output_gain

output_gain(db)

Set scene-wide playback gain in dB (default 0). The last declaration wins for the whole scene, even after wait(). Added to [audio].output_gain_db; amplitude = 10^((config dB + scene dB)/20), applied immediately before the cpal/WAV output limiter, including limiter none. Analysis, listener, reports and UI bus meters remain unchanged. Accepts integers and floats; values and the combined gain must yield a finite, positive f32 amplitude gain. Invalid values report the declaration position; limits come from f32 representability, not a loudness target.

根拠: 該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。

seed

seed(value)

Set the random seed for reproducible scenarios. For a scene, initial RNG seed; a script declaration overrides the CLI seed, and the last declaration wins. For a ModePattern, sets that pattern’s private seed. Integer >=0; no fixed seed in top-level composing samples.

根拠: 該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。

Bodyと音色

Voiceの音響bodyを構成するlevel、spectrum、detuning、envelope。

amp

amp(value)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Amplitude in 0.0-1.0.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

freq

freq(hz)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Frequency lock in Hz; implies an anchored pitch (see anchor()).

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

brightness

brightness(value)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Spectral brightness in 0.0-1.0 (harmonic/modal bodies).

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

attack_noise

attack_noise(db)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Add a short band-limited noise burst on every harmonic attack. Initial RMS in dB relative to the note amplitude at unit impulse, up to 0 dB. Omitted or −80 dB is silent. The burst starts at the strike and decays independently of the note envelope with a 15 ms time constant.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

spread

spread(value)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Amount of unison layering in [0,1], default 0: width and depth together. With unison(n) above one, the copies spread up to ±24·value cents around the centre, and a copy at relative offset u (−1 to 1) has relative amplitude value^|u|. With an odd count a small value gives narrow, shallow layering around the centre copy; an even count has no centre copy, so its central pair keeps equal weight and beats at full depth. 1 gives equal copies. The copies’ powers sum to the uncopied power, so the mean level stays the same. Zero leaves a single copy.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

unison

unison(count)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Number of unison copies (1-9, default 1); spread sets how far and how strongly they layer.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

modes

modes(pattern)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Set the mode pattern of a modal body. See the Mode Patterns section for constructors and modifiers.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

adsr

adsr(attack_sec, decay_sec, sustain_level, release_sec)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

ADSR amplitude envelope. Attack, decay and release are nonnegative seconds; sustain level is in [0,1]. Omission uses the selected body’s envelope. An explicit envelope alone does not add a mortality drain.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

Phonationとリズム

Voiceがいつ、どれだけの間鳴るかを決める。Tier 1はリズム結合連続体の領域を選び、Tier 2はwhen/durationを明示し、Tier 3は専門的な調整を行う。同じ軸では最後の指定が優先される。

brain

brain(name)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Articulation life: "entrain" (default), "seq", or "drone". Selects articulation life independently of onset timing. entrain responds to consonance and metabolism. seq holds for 1 second, ignoring metabolic controls. drone lives until release, with a 0.05 Hz sway whose base amplitude multiplier ranges from 0.3 to 1.0 before rhythm relaxation gain. Explicit metabolic and articulation-rhythm controls ignored by seq/drone produce warnings.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

sustain

sustain()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Sustain phonation mode (default). The default is a continuous note until release. Explicit sustain() combined with metric(), entrained(), steady() or flow(), in either order, retains the sounding Tone between opportunities. A selected attack replaces it; waiting or skipping retains it. Add cycles() or adaptive_duration() with rest() for finite notes separated by pauses. See the Rhythm chapter for pitch application, tie and persistence.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

phrase_boundary

phrase_boundary(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Soften one new Sine onset after a confirmed local self boundary. Initial-only finite nonnegative weight, default 0. Requires Sine, sustained metric/entrained/steady/flow and discrete pitch; unsupported final forms warn and disable it. Candidate model: LBDM (Cambouropoulos 2001). Online adaptation and the post-boundary response are author rules. Renderer execution receipts are published after each hop, separately from SQ-1 issuance records. A six-onset window uses pitch/IOI/rest weights .25/.50/.25. Caps are one octave and four initial bodily cycles (an author mapping to a whole note), fixed at birth. The first existing opportunity consumes the response even if vetoed. A legal new Tone receives gain 1/(1+w*B), without changing strength, clocks or release. See Rhythm for support, expiry and evidence limits.

根拠: 候補(LBDM、Cambouropoulos 2001):音高・IOI・休みの重み.25/.50/.25を用いる局所境界モデル。実装の検査は原著プログラムやcorpus成績の再現ではない(§9.3.106)。
作者規則:有限列の完備化、6 Onのオンライン接続、出生時に固定する上限、境界判明後の合法なSine On一件へのgain 1/(1+w*B)。重みの既定値は0。既定の聴き手の型への採用は未実施(§9.3.106)。

rest_on_habituation

rest_on_habituation(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

End sustained spans probabilistically as heard attacks become familiar. Initial-only finite nonnegative f32 weight, default 0. Values above 1 proportionally increase exit rate without changing its law. Requires explicit sustain() with metric(), entrained(), steady() or flow(). Shared habitat attack habituation drives exit; private executed attacks govern return after all tails end. Onsets remain on existing legal opportunities and may be vetoed. rest() adds its fixed tail-following gap before recovery resumes. Uses habituation enabled/satiation_sec/recovery_sec; disabled habituation prevents exits. This is an author rule, not phrase perception. Invalid or unsupported values warn and are ignored. Replacements inherit the weight but reset private state.

根拠: 原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
作者規則:spanの確率的な退出と私的回復・復帰。重み0で中立(§9.3.96、§9.3.101)。

rest

rest()
rest(periods)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Release each finite participation note, then leave a rest after all its tails finish. Requires explicit sustain() with metric/entrained/steady/flow and an explicit finite duration (cycles() or adaptive_duration()), in either builder order. After release, wait until all tails finish, then wait the requested number of intrinsic body periods. Default 1 period; finite nonnegative values have no upper cap, invalid values become zero. Without a known period it keeps waiting. The next legal opportunity may sound; expiry never forces an onset. Released tails keep their pitch.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

repeat

repeat()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Repeated/pulsed phonation mode.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

metric

metric()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Confidence-weighted rate and phase attraction to the acoustically confirmed beat. Attracts rate and phase to the beat confirmed from sound; before confirmation, each Voice free-runs with an independent phase. Default entrainment 0.95. The starting rate is the scene’s final tempo-basin center, or 2 Hz without a basin. Every crossing is an opportunity, subject to lifecycle, gates and rests. Explicit sustain() retains a Tone between crossings. See pitch_apply_mode() and tie() for how pitch and attacks meet.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
候補(照合未了):Largeの神経共鳴振動子の形とLarge & Jones(1999)のシミュレーション利得。原典一致・候補受入を認定しない。
作者規則:参加、結合の既定値、事前分布。metricのentrainmentは0.95、meter_stabilityの既定は0、basin未指定時の中心は2 Hz。これらの値は原理から導いた定数ではない。

entrained

entrained()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Adaptive acoustic participation with a lifetime-fixed bodily scale. Uses the intrinsic body period (default 2 Hz) as a starting scale, then adapts participation to heard recurrence. At each opportunity, acoustic context selects sounding, waiting or skipping. Default entrainment 0.5. intrinsic_rate() sets the body scale. Explicit sustain() retains a Tone while opportunities continue; without it, notes have finite duration.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
作者規則:参加・skip・再帰入力の扱いと結合値。intrinsic_rateは身体の初期尺度(§9.3.55–57)。

steady

steady()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Fixed private due times; acoustic context selects sound or skip. Keeps a private due-time grid at the intrinsic body period (default 2 Hz). Acoustic context selects sounding or skipping at due time; it does not shift the grid. Default entrainment 0.5. intrinsic_rate() sets the body scale. Explicit sustain() retains a Tone between opportunities.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
作者規則:参加・skip・再帰入力の扱いと結合値。intrinsic_rateは身体の初期尺度(§9.3.55–57)。

flow

flow()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Irregular bodily renewal with acoustic timing choices. Draws irregular renewal intervals at the intrinsic body scale (default 2 Hz), with acoustic context selecting sounding, waiting or skipping. Default entrainment 0.05. intrinsic_rate() sets the body scale. Finite note lengths use three times the body period. Explicit sustain() retains a Tone between opportunities.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
作者規則:参加・skip・再帰入力の扱いと結合値。intrinsic_rateは身体の初期尺度(§9.3.55–57)。

intrinsic_rate

intrinsic_rate(hz)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Set the intrinsic bodily rate at creation for entrained()/steady()/flow(), in Hz. Initial-only body rate for entrained(), steady() and flow(), in Hz. Default 2 Hz; finite range 0.01..=200 Hz protects execution. Either builder order works. It scales cycles(), finite durations and rest() together; ADSR release stays in seconds. Replacements start from the Population template. Other timing forms warn and ignore it. This sets a body scale, not a required onset rate.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

entrainment

entrainment(strength)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Preset-specific acoustic timing influence or beat-rate and phase attraction. Order-independent with presets: entrainment(0.8).metric() and metric().entrainment(0.8) are equivalent. Within a selected preset it changes the timing influence, not the preset. For entrained(), it weights acoustic period adaptation and timing costs; for flow(), acoustic timing costs while the renewal scale stays fixed; for steady(), sound-or-skip costs without adapting the period or moving due. For metric(), beat confidence weights its attraction of both effective rate and phase toward the confirmed beat. Omitted values are 0.95 for metric(), 0.5 for entrained()/steady() and 0.05 for flow(). Zero removes these acoustic timing influences; flow still draws irregular renewal intervals. Without an already coupled timing specification, a bare call initializes Coupled timing with its defaults.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

rhythm_role

rhythm_role(name)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Metrical job: "beat", "subdivision", "accent", or "texture". accent emits a stronger onset that drives the shared meter harder, so a recurring downbeat can seed an emergent measure.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

measure_accent

measure_accent(amount)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Weak onset emphasis following the emergent measure, amount 0-1 (default 0). Scales onset strength by 1 + 0.35 * amount * measure confidence * cos(measure phase). Zero phase follows observed accents. With no detected measure, strength stays unchanged. Does not schedule onsets or impose a grouping. Order-independent with metric/entrained/steady/flow presets.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

microtiming

microtiming(amount)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Signed beat-phase offset for metric timing, in -0.5..0.5. A value of 0.5 offsets the synchronized target by half a beat. Does not place entrained/steady/flow participants at fixed offsets.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

cycles

cycles(n)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Duration of n rhythm cycles. For entrained/steady/flow, duration uses the intrinsic bodily period set by intrinsic_rate(hz), or 2 Hz when omitted, independently of acoustic cadence adaptation. Metric timing uses its effective beat period. Flow retains its threefold hold multiplier. With rest(), this finite duration is retained independently of sustain() and the participation preset, and each sounded note releases at its scheduled end.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

tie

tie(p)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Extend a living Tone with probability p at an opportunity without pending pitch. Initial-only probability in [0,1] for free-pitch explicit sustained metric/entrained/steady/flow with gate_snap or rearticulate. At a selected opportunity without pending pitch, extend the living Tone with probability p; otherwise attack. Pending targets and initial/post-rest onsets still attack. Default 1 for sustained metric, 0 for sustained participation. Finite Off, tails, rest and release take priority. Unsupported explicit settings warn and are ignored. This thins opportunities; it does not select phrases or move their timing.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

articulation_persistence

articulation_persistence(p)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Retain a Voice’s private articulation policy across pitch adoptions and sustained clock opportunities. Initial-only policy inertia in [0,1], default 0. Requires free-pitch sustained metric/entrained/steady/flow, rearticulate and a positive boundary. Base follows that boundary; Connect glides adoptions and extends living Tones at sounded opportunities. Small moves and cost skips propose Connect; large moves and selected sounding propose Base. For 0<p<1, opposing proposals retain the policy with probability p. Endpoints use Base. Rest, release and legal initial onsets take priority. Unsupported settings warn and are ignored. This is policy inertia, not a legato proportion.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

Pitch Movement

VoiceがConsonance Field内をどう移動するかを決める。seek_consonance()、glide()、temperature()が基本の作曲用APIで、残りは山登り探索とpeak samplerを調整する。

dwell

dwell(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Slow pitch proposals while the current environment level is high. Initial-only author rule for free seek_consonance(), default 0. Finite nonnegative f32 weights have no upper clamp; negative, non-finite or unsupported values warn and become 0. Proposal phase advances at max{0,1+w*(1-2L)}; L is the habituated environment level at the current pitch, using pitch self-exclusion when available. For w>1 it stops at L>=(1+1/w)/2; maximum speed is 1+w at L=0. Replacements inherit weight and reset phase. Gap preserves the clock. Adaptation and movement costs retain their time units. Proposals never force onsets or change sound duration. See the Rhythm chapter for interpolation, conversion and why habituation does not guarantee departure.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
作者規則:馴化後の場の水準に応じた提案の遅延。重み0で中立(§9.3.98)。

follow_tonal_context

follow_tonal_context(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Favor pitches that fit the recently heard harmonic context. Initial-only finite nonnegative weight, default 0. At 48 kHz, adds w*q after candidate generation and before the current-pitch dwell sigmoid; ownership follows leave_self_out. Requires free, stepwise sustained seek_consonance(), rearticulate_above(0), no glide/persistence; unsupported forms warn and ignore it. Declared approximation range [0.25,1], based on weights 0.25/0.5/1: 4-6/362 argmax changes (1-2%), within 1/10 of TC effects; dwell sign changes zero. 0.125 and 2 failed. Outside this range acceptance is unverified; values remain valid without warnings. When enabled, the shared 9,673-node table costs about 1 GB and 80 seconds, estimates rather than limits. This cost excludes TC from PRE-1. See Rhythm for unknown fallback and scope.

根拠: 候補(原典照合済み):IPEMの感覚的短期記憶。40帯域ANI、periodicity pitch、半減時間0.1/1.5秒。仮説の実装であり、確定した脳機構ではない。
作者規則:正弦probe、表による近似、相関の読み出し、候補再採点とdwellへの接続。重みの既定値は0(§9.3.110)。

melodic_continuity

melodic_continuity(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Favor pitches predicted by the range and mobility of committed self onsets. Initial-only finite nonnegative score/bit weight; default 0. Requires free seek_consonance(), stepwise sustained participation and rearticulate_above(0), without glide or persistence. Invalid or unsupported final forms warn and disable it. Candidate: von Hippel (2000), text-consistent AR(1) equations. Prefix estimation and generation coupling are author rules. A known snapshot replaces movement cost and fixed-center gravity before candidate extraction; its log-density difference is added after extraction. Unknown statistics restore the current old terms. Four or more onsets and certified positive variance are required. SQ-1 can coexist independently. Replacements inherit only the weight. No rhythm, harmony or phrase learning. See Rhythm for support and resource limits.

根拠: 候補:von Hippel (2000) の本文に整合する AR(1) の平均・分散。著者公認の訂正ではない。
作者規則:有限 prefix の Pearson 推定、確定した自己 On の入力、連続音高の対数密度採点、移動費用と固定中心への重力の置換(§9.3.108)。

follow_own_sequence

follow_own_sequence(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Favor continuations learned from this Voice’s executed pitch intervals. Initial-only finite nonnegative score/bit weight; default 0, example 0.05. Negative or non-finite values warn and become 0. Requires free seek_consonance(), sustained metric/entrained/steady/flow, gate_snap or rearticulate, and rearticulate_above(0). Glide and unsupported final forms warn and disable it. Existing tie behavior remains. Candidate model: PPM-Decay (Harrison, Bianco, Chait, Pearce 2020). Symbol encoding and generation coupling are author rules. Learns rounded intervals from committed self onsets; output stays unquantized. Adds follow after candidate generation. Replacements inherit weight but start empty. No rhythm, harmony or phrase learning. See Rhythm for resource limits and numerical failures.

根拠: 候補(PPM-Decay、Harrisonほか2020):公表解析の固定モデル。原典fixtureの照合範囲は分布・情報量・学習状態であり、R APIや乱数生成器の同値性ではない(§9.3.105)。
作者規則:実行された音程の符号化、実行への接続、候補生成後の追従評価。重みの既定値は0。既定の聴き手の型への採用は未実施(§9.3.105)。

anchor

anchor()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Hold the voice at its pitch: an anchored voice never moves. at() anchors implicitly unless the final spec explicitly seeks consonance and remains free; in that case it sets only the initial position. freq() still sets an anchored pitch. A later anchor() or freq() overrides movement, while a later seek_consonance() restores it. Use anchor() to hold strategy-placed voices (consonance(), dissonance(), …) at their settled position, or to state the intent explicitly.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

seek_consonance

seek_consonance()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Free movement toward better field positions; defaults to hill-climb and a 0.30-second glide. With this explicit intent and a final free pitch mode, at(hz) sets only the initial position. A later freq() or anchor() restores the lock; calling seek_consonance() after either restores movement. How pitch decisions land is resolved at placement unless pitch_apply_mode() was called: sustained voices glide, re-attacking voices (pulse(), metric(), entrained(), steady(), flow()) snap at onsets. Explicit glide() and pitch_core() choices override these defaults in either builder order.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:協和の評価と局所探索。重みとglideの既定値を含む(§9.3.98)。

glide

glide(tau_sec)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Pitch glide time constant in seconds. Glide time constant in seconds, nonnegative. seek_consonance() defaults to 0.30 seconds unless explicitly set; otherwise the control default is 0 seconds. Applies in glide mode and to small moves in rearticulate mode.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

rearticulate_above

rearticulate_above(cents)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Nonnegative boundary in cents from the last sounded pitch; default 0. Distance boundary in cents, nonnegative, default 0. Requires rearticulate mode; other modes warn and ignore it. Adopted moves at or below a positive boundary glide; larger ones wait for a sounded opportunity, or attack at adoption in continuous Hold without coupled timing. The reference is the last actual onset pitch. Zero uses gate_snap behavior for sustained coupled timing. A live boundary change applies at the next adoption.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

pitch_apply_mode

pitch_apply_mode(name)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

"gate_snap", "glide" or "rearticulate": choose how adopted pitch targets are applied. Choose gate_snap, glide or rearticulate. Moving continuous and explicitly sustained voices default to glide; finite gated voices default to gate_snap. Gate_snap holds the latest adopted target for a sounded opportunity. Glide slides continuously. Rearticulate uses rearticulate_above() to glide small moves and defer larger ones; continuous Hold without coupled opportunities attacks at adoption. Free-pitch finite gated rearticulate is an error. Live mode changes keep the sounding Tone, clear pending attacks and emit no attack. Sustained metric uses shared-beat crossings; sustained participation can wait or skip.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

temperature

temperature(value)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Search temperature shared by both pitch cores: 0 settles greedily, higher is more exploratory. The single stochastic-search knob. At 0 the hill-climb is greedy (move only on a clear improvement, otherwise stay) and the peak sampler takes the argmax candidate. Higher values let the hill-climb accept downhill moves (Metropolis) and soften the peak sampler’s candidate choice. Musically the movement-tension dial; its placement twin is tension().

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

proposal_interval

proposal_interval(seconds)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Proposal generation interval in seconds. Controls opportunities to propose a pitch target, not the bodily participation rate set by intrinsic_rate(hz). A proposal or adoption is not necessarily a sounded onset.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

tail_roughness_aversion

tail_roughness_aversion(w)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

作者規則。初期設定と実行中の更新に対応し、既定値は0。有限の[0,1]を指定する。範囲外・非有限は警告し、有限値は範囲内へ制限、正の無限大は1、負の無限大とNaNは0にする。leave_self_out(true)で実際に旧ToneをOff・新ToneをOnする音高候補だけ、自己除外Rと混合Rを1-wとwで混ぜる。Hは自己除外のまま、既存の場の係数とsigmoidを使う。0は従来の既定経路、1は採択したVR-1の場。Lock、保持、Glide、GateSnap、提案によるOnのない待機には効かない。leave_self_out(false)で正の重みは効かず、Populationごとに一度だけ警告する。共有の和声機会でも同じ行為判定を使う。未来のreleaseや候補の全身体の予測ではない。environment、Flora、routing、releaseは変えない。

根拠: 作者規則:自分の余韻との粗さを音高選択で避ける性向。作曲者が選び、既定値は0。感覚は変えない(DCC §5、§9.3.120)。

近傍の知覚

Fieldを評価するとき、ほかのVoiceと自分自身のspectrum footprintをどう知覚するかを決める。

avoid_neighbors

avoid_neighbors(strength)
avoid_neighbors(strength, sigma_cents)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Crowding repulsion from neighboring voices. With one argument the repulsion width uses the default; the two-argument form sets it explicitly in cents.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

leave_self_out

leave_self_out(enabled)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Voiceの既定はfalse、Floraはtrue。自己の実habitat PCMを聴覚解析前に除く。tail_roughness_aversionの既定値0では、従来どおりH/Rの両方から全自己を除く。正の重みを選んだ場合だけ、実際に旧ToneをOff・新ToneをOnする音高候補のRに混合Rを加える。H、environmentの継続回復、共有snapshot、Floraの契約は変えない。

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:自己除外。Voiceの既定はfalse、Floraはtrue。Voiceは既定ではH/Rの両方から自己を除き、tail_roughness_aversionで実際のOff/On音高候補のRだけを選択的に混合する。environmentの回復とFloraの契約は維持(§9.3.95、§9.3.120)。

LifecycleとViability

時間に沿った生存と回復。endurance()は適合度がゼロのときの寿命、recovery()は最大の連続回復に要する時間を表す。consonance_viability()は回復範囲を定め、既定では環境相対評価を使う。

endurance

endurance(seconds)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Nominal survival time at zero field fit, excluding the release tail. Energy is normalized to 0-1. The runtime drain rate is derived at spawn; actual lifetime varies with field fit, attacks, recovery, and release time.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

recovery

recovery(seconds)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Time to refill normalized energy from empty at full viability. Optional. If omitted, continuous recovery is disabled. This does not govern the separate per-attack economy.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

attack_cost_fraction

attack_cost_fraction(value)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Fraction of normalized energy spent by a full-strength attack.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

attack_recharge_fraction

attack_recharge_fraction(value)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Maximum normalized energy restored by a fully consonant attack.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

sustain_drive

sustain_drive(value)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Nonnegative dimensionless continuous drive for sustained voices, default 0.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

consonance_viability

consonance_viability(low, high)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Viability window in unbounded Consonance Field scores. Thresholds are finite Consonance Field scores, not bounded levels. Below low the continuous fitness is zero; above high it is one. Defaults to total without a viability window, environment with one; explicit viability_scope() overrides that default in either builder order.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

dissonance_penalty

dissonance_penalty(value)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

How strongly good field fit extends life beyond zero-fit endurance. The zero-fit endurance remains fixed; the penalty changes how much longer a well-fit voice survives.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

Respawn

Populationの世代交代。respawn policyはVoiceが死亡したときのreplacementの出現位置を決め、capacityとacceptance thresholdが生態系規模の挙動を形づくる。

respawn_random

respawn_random()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Respawn without parent inheritance. Candidates come from the Population’s original Placement and, when set, respawn_settle() adds alternative candidates. The current scene score weights the final choice, so this is not uniform random placement.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

respawn_hereditary

respawn_hereditary(sigma_oct)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Respawn near an energy-weighted living parent with Gaussian standard deviation sigma_oct in octaves. Candidates share one selected parent. The candidate with the highest current Consonance Field level is used.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

respawn_consonance

respawn_consonance()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Respawn from high field-score peaks, biased around an energy-weighted living parent. When living members exist, one parent is selected by energy. Candidate peaks come from the current Consonance Field and are weighted by scene score and their relation to the parent; without a usable peak, the policy falls back to the parent or original Placement.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

respawn_capacity

respawn_capacity(count)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Maximum number of living members in the Population. Defaults to the number of founder Voices created by place() and cannot be lower than that founder count.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

respawn_settle

respawn_settle(placement)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Add a Placement source to the replacement candidate pool. The policy’s own baseline still supplies one candidate; this Placement supplies the remaining alternatives. Requires a strategy-bearing placement: consonance(), dissonance(), edge(), gap(), random(), or line() (not at()).

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

respawn_min_consonance

respawn_min_consonance(level)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Minimum consonance level for respawn acceptance. Minimum Consonance Field level in [0,1]; omitted means no level threshold. A level is a bounded sigmoid view of a score.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

respawn_background_death_rate

respawn_background_death_rate(rate)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Background turnover rate per second.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

Mode Pattern

modal()の発音体に使う周波数関係。生成関数はModePatternを返し、構築用メソッドで調整できる。Landscape-awareな構成は実行中のLandscapeから値を取る。

harmonic_modes

harmonic_modes() -> ModePattern

Harmonic series: f, 2f, 3f, …

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

odd_modes

odd_modes() -> ModePattern

Odd harmonics: f, 3f, 5f, …

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

power_modes

power_modes(beta) -> ModePattern

Power law: f * n^beta.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

stiff_string_modes

stiff_string_modes(stiffness) -> ModePattern

Stiffness-adjusted harmonics.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

custom_modes

custom_modes(ratios) -> ModePattern

Custom frequency ratios from an array.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

modal_table(name) -> ModePattern

Named mode table lookup. Canonical names: uniform_aluminum_bar, uniform_wooden_bar, xylophone, vibraphone_1, vibraphone_2, wine_glass. Names are case-sensitive; an unknown name is a script error.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

landscape_density_modes

landscape_density_modes() -> ModePattern

Modes selected from the strongest live landscape density-mass positions. Selection is deterministic: after each strongest position is chosen, nearby weights are suppressed according to spacing(). Falls back to harmonic modes when live landscape data yields no usable position.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:Landscapeの密度・極値から身体のモードを選ぶ規則。入力の評価も作者の規則。

landscape_peaks_modes

landscape_peaks_modes() -> ModePattern

Modes selected from the strongest local peaks of the live Consonance Field level. Selection is deterministic and enforces the ERB separation from spacing(). Falls back to harmonic modes when live landscape data yields no usable peak.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。
原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:Landscapeの密度・極値から身体のモードを選ぶ規則。入力の評価も作者の規則。

count

count(n)

適用対象:ModePattern。

Number of modes.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

range

range(min_mul, max_mul)

適用対象:ModePattern。

Frequency multipliers relative to the fundamental; only valid on landscape_*_modes().

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

spacing

spacing(min_erb)

適用対象:ModePattern。

Minimum ERB distance between modes; only valid on landscape_*_modes().

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

gamma

gamma(g)

適用対象:ModePattern。

Density sharpening exponent; only valid on landscape_density_modes().

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

jitter

jitter(cents)

適用対象:ModePattern。

Randomize mode frequencies by up to the given cents.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

seed

seed(value)

適用対象:ModePattern。

Random seed for jittered patterns (>= 0). For a scene, initial RNG seed; a script declaration overrides the CLI seed, and the last declaration wins. For a ModePattern, sets that pattern’s private seed. Integer >=0; no fixed seed in top-level composing samples.

根拠: 該当なし(初期の身体):合成特性と初期条件。選んだ身体と行為の語を参照(§9.3.56)。

Routing

各Voiceは、独立した二つのモノラルバスへ寄与する。presentation busは作品として聴かれる音、habitat busは聴覚解析を通じて生態系が知覚する音である。初期状態では両方へ送る。

send

send(bus)

適用対象:PopulationSpecのみ。

Route the voice to specific buses; accepts a Bus or a BusSet. PopulationSpec only. send(habitat_bus) makes a voice sensed by the ecology but absent from the presented sound; send(presentation_bus) is heard without perturbing the ecology; send(habitat_bus | presentation_bus) feeds both (the default).

根拠: 該当なし(経路):busの選択・結合。独立した自己知覚の規則はleave_self_outを参照。

Directorとglobal parameter

scene全体の地形形成と研究用control。director verbはsoft priorであり、地形を形づくるが、beatをscheduleしたりmeasureを強制したりはしない。

harmonic_rhythm

harmonic_rhythm(N)

背景の変化をN拍ごとの共有機会にまとめる作者規則。Nは作曲者が置く非負整数で、0と省略は中立。最後の有効な指定を場面全体の初期前提とし、有限の曲ではwait()後の記述も途中変更にはならない。endlessでは最初に時刻を進めるwait()より前に宣言する。対象は全Floraと、出生時にOnce/WhileAlive、Free、Rearticulate、閾値0のVoice。準備が整わなければ機会を見送る。解放と支持喪失は優先し、競合する実行中の音高設定はwarningとともに拒否する。調・和音・進行の表や、小節頭への再整列は導入しない。Nは推定小節長ではない。

根拠: 作者規則:背景の変化を共有の機会にまとめる。0は中立。Nは作曲者が置く量であり、推定小節長や知覚の定数ではない。

meter_stability

meter_stability(value)

Attractor depth in 0-1: how readily a pulse forms. Scene-wide initial condition in [0,1], default 0; the last declaration wins. Shapes how readily a beat forms and the influence of the tempo basin. It does not schedule onsets.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
候補(照合未了):Largeの神経共鳴振動子の形とLarge & Jones(1999)のシミュレーション利得。原典一致・候補受入を認定しない。
作者規則:参加、結合の既定値、事前分布。metricのentrainmentは0.95、meter_stabilityの既定は0、basin未指定時の中心は2 Hz。これらの値は原理から導いた定数ではない。

temporal_basin

temporal_basin(min_hz, max_hz)

Set the beat’s tempo band and metric Voice/Flora pace prior. Scene-wide initial condition: the last declaration applies to every metric Population and every Flora, regardless of cursor position. Bounds are Hz, sanitized to the supported tempo band; their center initializes metric Voices and attracts the inferred beat according to meter stability. Every Flora follows confirmed acoustic beats and otherwise returns to the center. Without a basin the center is 2 Hz. Participating presets use their own intrinsic rate. This does not schedule a beat.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
候補(照合未了):Largeの神経共鳴振動子の形とLarge & Jones(1999)のシミュレーション利得。原典一致・候補受入を認定しない。
作者規則:参加、結合の既定値、事前分布。metricのentrainmentは0.95、meter_stabilityの既定は0、basin未指定時の中心は2 Hz。これらの値は原理から導いた定数ではない。

set_roughness_aversion

set_roughness_aversion(weight)

How much the modeled listener minds roughness (default 1.0). Cursor event: changes roughness valuation from this script time onward. Dimensionless, nonnegative; zero removes aversion. Does not change raw roughness sensation.

根拠: 作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。

set_support_focus_preference

set_support_focus_preference(weight)

支持の集中への選好。符号付きの有限値を指定し、正で集中を好み、負で避ける。既定値0のcursor eventで、上限は設けない。聴いた音の一次の支持場を身体の部分音で積分する作者規則。Voiceの移動にはleave_self_out(true)が必要で、出生とFloraのlane選択にも作用する。Floraの成長と慣れの入力は維持する。部分音の密度は身体の自己申告から出生・再構成時に保存する。自己申告がない身体は基本周波数の単一部分音として読み、その旨を表示する。 C/Nは合法な発音・保留・継続・release・出生見送りにも作用する。次の意思決定窓における身体の部分音の時間平均を既定の行為と比較し、既存のscoreと身体費用へ加える。heldは既存の提案・共有機会で比較し、Wは次の機会までとする。機会間のOff/Onは増やさない。releaseの尾を残し、新規音の支持はToneの予測APIで別に確認する。Voiceの出生は発音予定が未確定なのでC/Nの行為差分を中立とし、静的な出生位置の順位は維持する。Floraは選択後のtargetをpreviewと実行で共用し、rearticulateの既存laneは実音高を保持する。Wはallocationの絶対時刻から公表された次の拍・共有機会までとし、非同期fallbackの場合だけ次のhopまでとする。全laneと尾を共通の観測基準で評価し、出生は選択済みの経過に新しいlaneを加えた差分とする。Nは重なる部分音密度を合算してから求める。新規residualの身体予測は未支持なので、行為予測はresidual(false)の場合に限る。未支持の次の機会・身体経過・窓は中立とする。時間の継続の語を有効にする必要はない。 非ゼロのC/Nは身体の時間積分とFloraの全lane・尾の合成比較を加える。個体・lane・候補の数、支持された窓、積分の細分化で費用が増え、非ゼロの重みを小さくしても費用が比例して下がる保証はない。作曲者は場面全体の実時間費用を確かめる。詳細はtechnoteの「C/Nの行為比較の計算費用」を参照。

根拠: 作者規則:候補密度の追加による支持の集中、テンプレート間の競合、関連する新規成分。記号的和声は用いず、Voiceの移動には実PCMの自己除外が必要。

follow_harmonic_relations

follow_harmonic_relations(weight)

作者規則。cursor event、有限の[-1,1]、既定0。動く候補どうしで、正は学んだ関係への適合、負は離脱を好む。既定の勝者との支持された差を有界化し、慣れや身体費用を含む既存scoreへ加算する。継続0なら、関係だけでは保持・待機・出生見送りを増やさない。 支持されない比較は中立。両方0なら既存の選択と乱数列を保つ。性向の変更でも履歴は残り、不正値は警告して無視する。固定の調や進行のprofileは用いない。

根拠: 作者規則:演奏中に学んだ関係と継続の結果を分け、符号付きの性向で既存scoreへ加算する。支持は根音や和音の札ではなく、固定の調profile・進行表・corpus事前分布を用いない。

follow_harmonic_continuation

follow_harmonic_continuation(weight)

作者規則。cursor event、有限の[-1,1]、既定0。学んだ継続への支持を既定候補との差として既存scoreへ加算する。正は保持・合法な機会での待機・Flora laneの保持・出生見送りを支持に応じて好み、負はその支持からの離脱を好む。機会の時刻は新設しない。 支持されない比較は中立。両方0なら既存の選択と乱数列を保つ。性向の変更でも履歴は残り、不正値は警告して無視する。固定の調や進行のprofileは用いない。

根拠: 作者規則:演奏中に学んだ関係と継続の結果を分け、符号付きの性向で既存scoreへ加算する。支持は根音や和音の札ではなく、固定の調profile・進行表・corpus事前分布を用いない。

set_support_conflict_preference

set_support_conflict_preference(weight)

支持されるテンプレート間の競合への選好。符号付きの有限値を指定し、正で競合を好み、負で避ける。既定値0のcursor eventで、上限は設けない。聴いた音の一次の支持場を身体の部分音で積分する作者規則。Voiceの移動にはleave_self_out(true)が必要で、出生とFloraのlane選択にも作用する。Floraの成長と慣れの入力は維持する。部分音の密度は身体の自己申告から出生・再構成時に保存する。自己申告がない身体は基本周波数の単一部分音として読み、その旨を表示する。

根拠: 作者規則:候補密度の追加による支持の集中、テンプレート間の競合、関連する新規成分。記号的和声は用いず、Voiceの移動には実PCMの自己除外が必要。

set_related_novelty_preference(weight)

既存の音と支持を共有する新しい成分への選好。0以上の有限値を指定し、既存密度に覆われた成分には加点しない。既定値0のcursor eventで、上限は設けない。聴いた音の一次の支持場を身体の部分音で積分する作者規則。Voiceの移動にはleave_self_out(true)が必要で、出生とFloraのlane選択にも作用する。Floraの成長と慣れの入力は維持する。部分音の密度は身体の自己申告から出生・再構成時に保存する。自己申告がない身体は基本周波数の単一部分音として読み、その旨を表示する。 C/Nは合法な発音・保留・継続・release・出生見送りにも作用する。次の意思決定窓における身体の部分音の時間平均を既定の行為と比較し、既存のscoreと身体費用へ加える。heldは既存の提案・共有機会で比較し、Wは次の機会までとする。機会間のOff/Onは増やさない。releaseの尾を残し、新規音の支持はToneの予測APIで別に確認する。Voiceの出生は発音予定が未確定なのでC/Nの行為差分を中立とし、静的な出生位置の順位は維持する。Floraは選択後のtargetをpreviewと実行で共用し、rearticulateの既存laneは実音高を保持する。Wはallocationの絶対時刻から公表された次の拍・共有機会までとし、非同期fallbackの場合だけ次のhopまでとする。全laneと尾を共通の観測基準で評価し、出生は選択済みの経過に新しいlaneを加えた差分とする。Nは重なる部分音密度を合算してから求める。新規residualの身体予測は未支持なので、行為予測はresidual(false)の場合に限る。未支持の次の機会・身体経過・窓は中立とする。時間の継続の語を有効にする必要はない。 非ゼロのC/Nは身体の時間積分とFloraの全lane・尾の合成比較を加える。個体・lane・候補の数、支持された窓、積分の細分化で費用が増え、非ゼロの重みを小さくしても費用が比例して下がる保証はない。作曲者は場面全体の実時間費用を確かめる。詳細はtechnoteの「C/Nの行為比較の計算費用」を参照。

根拠: 作者規則:候補密度の追加による支持の集中、テンプレート間の競合、関連する新規成分。記号的和声は用いず、Voiceの移動には実PCMの自己除外が必要。

set_harmonicity_preference

set_harmonicity_preference(weight)

How much the modeled listener values harmonic support (default 1.0). Cursor event: changes harmonicity valuation from this script time onward. Dimensionless, nonnegative; finite weights are clamped to [0,100] and non-finite values are ignored. Zero removes the field’s harmonicity term and makes spawn density independent of harmonicity. The interaction term remains controlled by set_roughness_aversion. Does not change harmonicity sensation.

根拠: 作者規則:重みを場の係数aに掛け、密度ではH01の指数に用いる。H/Rの感覚は変更しない(§9.3.56)。
原理:西洋の聴き手の協和の好みは調和性の好みに従い、音楽経験とともに強まる(McDermott, Lehr & Oxenham 2010)。Tsimaneの聴き手には協和の好みが見られない(McDermott et al. 2016)。第3層に評価の重みを置く根拠であり、重みの式を導く根拠ではない。

set_pitch_objective

set_pitch_objective(name)

Cursor event: choose consonance or dissonance valuation. Cursor event: changes pitch valuation from this script time onward. Canonical names: consonance (default) and dissonance (negative consonance). Does not change the sensation model.

根拠: 作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。

Experimental

Core候補として試聴中の動詞です。作曲用ですが、検証が済むまでは研究段階の安定性です。

Flora

flora

flora() -> FloraSpec

Build a FloraSpec for spectral growth over a frequency extent. Defaults: pace 1, amp 0.03, fade 2 s, sine tone, residual disabled, leave_self_out true, both buses. Every Flora uses the shared habitat audio-only meter and a private CouplingClock (0.95). Fresh confirmed beats guide lane opportunities and ecological pace; unknown, stale or unconfirmed evidence restores continuous allocation and temporal_basin center pace (default 2 Hz). At frequency f and pace k, growth is 4kf/s, recovery is 20/(kf) seconds and consumption is 0.6/(kf) seconds. Pending windows reserve current excess once. While fresh confirmed beat observations are available, births occur at sample crossings. Support loss and release retire immediately. Birth ticks mark allocation; amplitude slew delays acoustic onset detection. All retiring lanes use a finite metabolic tail, bounded by macro fade; fade(0) ends immediately.

根拠: 該当なし(初期の身体):Floraの身体、振幅、fadeの選択。flora、paceを参照。
作者規則:背後のスペクトル成長、消費、退出の生態則。聴覚認知のモデルではない。

fade

fade(seconds)

適用対象:FloraSpec。

Set Flora’s placement and release fade in [0, 60] seconds. Requires a finite value before and after f32 conversion; invalid values raise script errors.

根拠: 該当なし(初期の身体):Floraの身体、振幅、fadeの選択。flora、paceを参照。
作者規則:背後のスペクトル成長、消費、退出の生態則。聴覚認知のモデルではない。

tone

tone(name)

適用対象:FloraSpec。

Choose Flora’s tonal atom: exactly “sine” or “resonant”. Other strings raise script errors.

根拠: 該当なし(初期の身体):Floraの身体、振幅、fadeの選択。flora、paceを参照。
作者規則:背後のスペクトル成長、消費、退出の生態則。聴覚認知のモデルではない。

residual

residual(enabled)

適用対象:FloraSpec。

Enable or disable rendering diffuse Flora mass as band noise. Disabled by default; residual(true) opts in.

根拠: 該当なし(初期の身体):Floraの身体、振幅、fadeの選択。flora、paceを参照。
作者規則:背後のスペクトル成長、消費、退出の生態則。聴覚認知のモデルではない。

respond_to_onsets

respond_to_onsets(w)

適用対象:FloraSpec。

Speed the Flora’s ecological time while new external onsets are heard inside its extent (finite nonnegative weight, default 0). Zero creates no state and reads nothing. Reads habitat attacks inside the extent (with sites: local external sound for self-exclusion, otherwise the full local mixture), skipping bins within 1.5 ERB of the Flora’s sounding lanes. A rise rho owes wtaurho extra ecological seconds (tau = satiation_sec/ln 10), spent at most w seconds per second, so unhabituated external onsets run the clock up to 1+w times faster; pace saturation still applies. Births stay on the Flora’s own crossings and the field chooses where; no onset, pitch or random draw is added. Unknown or regridded observations only re-prime. Disabled habituation warns once. Invalid values warn and use zero. Initial-only; the observer starts at scene start, including before later Flora placements.

根拠: 原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
作者規則:自分の部分音の外で聴こえた発音の履歴が上がった後に、Floraの生態の時間を速める。重み0で中立(§9.3.138)。

Rain

rain

rain() -> RainSpec

Build a RainSpec: impacts drawn one by one over a frequency extent, and resonant objects they strike. Defaults: amp 0.02, fade 2 s, rate 40 impacts/s, sway 0, hit 0.06, wine_glass impacts with width 0.05 octave, 3 objects with vibraphone_1 modes, object_decay 2 s, both buses. Impacts are Poisson, with no beat. Every impact strikes the same material at a centre drawn from the placement’s distribution, with fresh level, decay and mode offsets; it rings for tens of milliseconds at a new centre each time, so the texture has no musical pitch. Objects start on consonance peaks, at least 1 ERB apart, and drift toward higher consonance by at most a semitone each time they are struck, unless anchored. An impact lands on a uniformly chosen object with probability hit and strikes it at the same instant.

根拠: 作者規則:分布から一つずつ引く打音と、打音が当たって鳴る共鳴する物によるtexture。聴覚モデルではない作曲上の規則(docs/design-notes/rain.md)。

fade

fade(seconds)

適用対象:RainSpec。

Set Rain’s placement and release fade in [0, 60] seconds.

根拠: 該当なし(初期の身体):Rainの振幅、fade、打音の素材、物の身体。rainを参照。

rate

rate(impacts_per_second)

適用対象:RainSpec, Rain。

Set the mean impact rate in [0, 2000] per second. Impact times form a Poisson process at this rate, swayed by sway(); 0 stops new impacts. The bound limits per-sample work. Live patches take effect at once.

根拠: 作者規則:分布から一つずつ引く打音と、打音が当たって鳴る共鳴する物によるtexture。聴覚モデルではない作曲上の規則(docs/design-notes/rain.md)。

sway

sway(octaves)

適用対象:RainSpec, Rain。

Let the impact rate fluctuate with a 1/f spectrum; depth in [0, 4] octaves, default 0. The rate becomes rate * 2^(depth * g), where g has unit variance and a 1/f spectrum from about 100 s down to 2.5 s periods; faster than that would read as a pulse. Depth is one standard deviation in octaves: 1 doubles or halves the rate at one deviation. The swayed rate is capped at 2000 per second. Struck objects follow the swayed rate.

根拠: 作者規則:0.4〜102秒の九つのAR(1)過程による活動の1/fの揺らぎ。聴覚野の1/f変動への同調(Garcia-Lazaro et al. 2006)を動機とするが、そのモデルではない。

hit

hit(probability)

適用対象:RainSpec, Rain。

Set the probability in [0, 1] that an impact strikes one of the objects. A struck object is driven at the impact’s own onset, scaled so its onset peak matches the impact’s level; the impact and the ring share their start.

根拠: 作者規則:分布から一つずつ引く打音と、打音が当たって鳴る共鳴する物によるtexture。聴覚モデルではない作曲上の規則(docs/design-notes/rain.md)。

width

width(octaves)

適用対象:RainSpec, Rain。

Set the half range in [0, 5] octaves by which each impact mode strays from impact_modes. Each impact draws a fresh offset for every mode. At the default 0.05 (60 cents) every impact is recognisably the same material. Wider ranges scatter the modes until impacts lose their material and become crackles; 0 repeats the pattern exactly. Live patches apply to the next impacts.

根拠: 該当なし(初期の身体):Rainの振幅、fade、打音の素材、物の身体。rainを参照。

ring

ring(octaves)

適用対象:RainSpec, Rain。

Let impacts that land on more consonant places ring longer; up to 2^octaves at the most consonant place of the extent, in [0, 4], default 0. Each hop the eroded consonance score inside the extent is normalised to u in [0, 1]; a flat or silent extent gives u = 0. An impact reads u where its first mode sounds and lengthens the decay of all its modes by 2^(octaves * u). Level is unchanged, decays never shorten, and the pitch objective sign does not invert it. At 0 the field is not read. The bound 4 keeps the longest decay near a minute, within f32 precision. Live patches apply from the next hop.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:打音の減衰を2^(ring × u)倍に伸ばす。uは第一のモードが鳴る所の慣れを掛けた協和の評価の値を範囲の中で正規化したもの。片側だけで、大きさは変えない。

follow_meter

follow_meter(focus)

適用対象:RainSpec, Rain。

Gather impacts where the meter heard in the habitat expects its beat, subdivision and measure; finite and non-negative, default 0. Each hop the Rain reads the habitat meter that Flora reads. For the beat, and for the subdivision and measure when detected, the confidence c (how closely heard onsets lock to that level) gives the von Mises concentration kappa whose resultant is c; focus multiplies it, up to 512. The impact rate is multiplied by e^(sum kappa (cos phi - 1)), normalised to mean 1 over a measure, so impacts move in time but are not added. Focus 1 reproduces the heard concentration and larger values sharpen it; the meter hears the impacts, so a beat they gather on gains confidence. An unknown or unconfident meter leaves the rate unweighted. Live patches apply from the next hop.

根拠: 原理:入力となる拍の知覚機能(§9.3.56)。
候補(照合未了):habitatの拍の観測のLargeの神経共鳴振動子の形。metric()と同じ。原典一致を認定しない。
作者規則:打音の率に、拍・細分・小節についてe^(w × Σκ(cos φ − 1))を平均1に正規化した重みを掛ける。κは各段の確からしさを合成ベクトルの長さとするvon Misesの集中度。重み0で中立。

objects

objects(count)

適用対象:RainSpec。

Set the number of resonant objects, 0 to 16. Objects start on eroded consonance-level peaks inside the extent, at least 1 ERB apart; missing peaks are filled by log-uniform positions. Each hop an object proposes the best eroded consonance score within one semitone, less the Voice movement cost, and moves there when next struck. Objects stay inside the extent and 1 ERB apart. anchor() holds them.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:物は協和の山から始まり、打たれるたびにVoiceの移動費用の既定値で協和の方へ動く。anchor()で固定する。

object_modes

object_modes(pattern)

適用対象:RainSpec。

Set the objects’ ModePattern; default modal_table(“vibraphone_1”). Mode k has gain 0.5^k. Landscape-aware patterns read the Landscape at placement.

根拠: 該当なし(初期の身体):Rainの振幅、fade、打音の素材、物の身体。rainを参照。

impact_modes

impact_modes(pattern)

適用対象:RainSpec。

Set the impacts’ material as a ModePattern; default modal_table(“wine_glass”). The pattern’s ratios are taken once at placement, at the extent’s geometric centre, and at most eight are used. Mode k has level 0.85^k with a 3 dB spread. Decay is 25 ms at 3.2 kHz, longer at lower centres as (3.2 kHz / f)^0.5, with a log-normal spread; higher modes decay as ratio^-0.5. Each impact starts with a raised-cosine onset of 0.5 to 1.5 ms.

根拠: 該当なし(初期の身体):Rainの振幅、fade、打音の素材、物の身体。rainを参照。

leave_drops_out

leave_drops_out(enabled)

適用対象:RainSpec。

Let Rain read a habitat field without its own impacts; its objects stay in that field. Default false: Rain reads the mixed field, including its impacts. When true, the actual habitat PCM of this Rain’s impacts is removed before the auditory front end, and impact positions under consonance, dissonance and edge, object drift and ring read the remaining field with the shared habituation applied. gap still reads mixed occupancy. Before the first render the mixed field is read; a missing observation keeps the previous distribution. Presentation-only Rain warns and has no effect. Set before placement.

根拠: 原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:Rainが読む場から何を除くか。自分の打音の実際のhabitatのPCMだけを除き、共鳴する物の音は場に残す。

objects_follow_drops

objects_follow_drops(enabled)

適用対象:RainSpec。

Let an object hold its pitch only while it rings; once silent, it takes the centre of the next impact that strikes it. Default false. An object is silent when its longest mode’s T60 (object_decay for the default body) has passed since its last strike, or before its first strike. A silent object struck by an impact retunes to that impact’s centre, clamped to the extent; if the centre lies within 1 ERB of another object, it keeps its pitch and is struck as usual. A ringing object drifts as before. No random number is added, so impact times, levels and struck objects are unchanged. How long a pitch holds follows rate, hit, objects and object_decay: with long decays or frequent strikes, objects rarely fall silent. anchor() wins and warns. Set before placement.

根拠: 作者規則:物が高さを保つのは鳴っている間だけ。最後に打たれてからT60が過ぎたら、次に自分を打つ打音の中心の高さを取る。ほかの物から1 ERBの間隔は保つ。

object_decay

object_decay(seconds)

適用対象:RainSpec。

Set the T60 of an object’s first mode in [0.01, 30] seconds. Higher modes decay faster, as ratio^-0.7.

根拠: 該当なし(初期の身体):Rainの振幅、fade、打音の素材、物の身体。rainを参照。

Phonationとリズム

sway

sway(octaves)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Let the Population’s participation density sway with a 1/f spectrum; depth in [0, 4] octaves, default 0. The Population shares one process g with unit variance and a 1/f spectrum from about 100 s down to 2.5 s periods, as Rain’s sway. Each Voice takes an otherwise eligible onset opportunity with probability 2^(depth * g), capped at 1, and otherwise lets it pass, in every timing mode. The composer’s density is the ceiling; the sway thins it. Sustained notes, pitch and loudness are not changed. Out-of-range values warn and are clamped.

根拠: 作者規則:0.4〜102秒の九つのAR(1)過程による活動の1/fの揺らぎ。聴覚野の1/f変動への同調(Garcia-Lazaro et al. 2006)を動機とするが、そのモデルではない。

phonate_when_viable

phonate_when_viable()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Withhold the first onset until perceived consonance is viable. Silently settles into the field until consonance reaches the low bound of the voice’s consonance-viability window (consonance_viability(), or always-viable if that window was never set), then phonates normally and never re-gates. A voice that never settles dies unheard and the respawn policy replaces it – there is no timeout parameter, the energy economy is the timeout.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

Pitch Movement

respond_to_onsets

respond_to_onsets(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Bring pitch proposals forward while new onsets are heard outside the Voice’s own sound (finite nonnegative weight, default 0). Zero creates no state and reads nothing. Positive weights seed the Voice’s external attack detector from the habitat history at its placement. It excludes the Voice’s own PCM. A rise rho inside the pitch range owes wtaurho proposal-clock seconds (tau = satiation_sec/ln 10), spent at most w seconds per second; one unhabituated onset lends about 0.45*w seconds with a 2 Hz basin. After each pitch change nothing is lent until one ordinary proposal threshold of real time passes. The field still decides whether and where to move; no onset or random draw is added. Requires free seek_consonance(), sustain(), rearticulate, rearticulate_above(0) and no follow_own_sequence()/melodic_continuity(); otherwise warns to 0. Without leave_self_out(true) it warns and has no effect.

根拠: 原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
作者規則:自分のPCMを除いて聴こえた発音の履歴が上がった後に、音高の選び直しを早める。高さを変えた後の一周期は保つ。重み0で中立(§9.3.138)。

Directorとglobal parameter

remember_pitch_set

remember_pitch_set(weight)

実際のhabitat音から周期性の経験分布を作り、自由音高のHillClimbで山を再提案する実験的な作者規則。場面の動作とscopeより前に有限非負の重みを指定する。省略と0は中立。入力は48 kHz、問い合わせ範囲は約15.84〜1378.13 Hz。自己を含む音を聴き、有効な聴取時間で累積平均する。候補と現在目標へ同じ記憶を加点し、Floraのlane選択には接続しない。PPの観測部分はIPEM候補、連続化・記憶・候補化・採点は作者規則。部分調波や平均で移動した山も含むため、発音基音の台帳とは呼ばない。欠測では経験を保持してPS観測を再開し、TCは従来どおり無効のまま。固定音階、オクターブ折り畳み、忘却時間の指定、listener profileへの追加はない。

根拠: 作者規則:周期性の経験分布を累積し、その山を候補と採点へ戻す。連続化も作者規則であり、0は中立(§9.3.114)。
候補(出典あり):IPEMのANI・周期性観測。語全体が公表された学習モデルや確定した脳機構を実装するという意味ではない。

Mechanism Tuning

Core動詞の背後にある機構を細かく制御します。既定値は調整済みです。Coreでは表せない特定の挙動を作品が必要とするときに使います。

Phonationとリズム

once

once()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Single trigger.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

pulse

pulse(rate_hz)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Pulse at an explicit rate in Hz.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

adaptive_duration

adaptive_duration()

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Duration follows field support. With rest(), retain this finite duration independently of sustain() and entrained()/steady()/flow(), in any builder order.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

pulse_lock

pulse_lock(depth)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Low-level pulse phase weighting in 0-1.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

social

social(coupling)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Social coupling for participation or pulse(), in 0-1.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

rhythm_freq

rhythm_freq(freq_hz)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Internal theta/rhythm oscillator frequency. Sets the Entrain articulation core oscillator; it does not set the entrained()/steady()/flow() participation scale. Use intrinsic_rate(hz) for that bodily rate.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

rhythm_coupling_vitality

rhythm_coupling_vitality(lambda_v, v_floor)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Vitality-modulated rhythm coupling.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

rhythm_reward

rhythm_reward(rho_t, metric)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Energy reward for timing fit; metric is "attack_phase_match" or "none". Gain rho_t and metric attack_phase_match or none (default). Effective only for brain entrain, continuous Hold phonation and autonomous attacks (glide or gate_snap, without sustained coupled timing). Gated or coupled opportunities use ordinary consonance recharge and ignore this reward, producing a warning when explicitly requested.

根拠: 作者規則:発声、参加、持続、再発音の方策(§9.3.57)。既存の基本動作の既定値は維持。

Pitch Movement

move_cost

move_cost(coeff)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Nonnegative dimensionless movement-cost coefficient, default 0.5.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

global_peaks

global_peaks(count)
global_peaks(count, min_sep_cents)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Global field peaks as movement candidates, with optional minimum separation.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

ratio_candidates

ratio_candidates(count)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

Ratio-based movement candidates; 0 disables.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

LifecycleとViability

viability_scope

viability_scope(name)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

"environment" or "total": choose the field used for viability. Environment uses the PCM self-removal observation at the current pitch for the continuous-recharge score. Both H and R stay self-excluded here; the rearticulation pitch view does not feed recovery. It is independent of leave_self_out. Use "total" only when selection should include the voice’s own contribution.

根拠: 作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。

Directorとglobal parameter

set_global_coupling

set_global_coupling(value)

Cursor event: nonnegative dimensionless Voice interaction strength (default 1). Cursor event: changes interaction strength from this script time onward. Dimensionless, nonnegative, default 1.

根拠: 作者規則:結合の重み。Voice間の結合と聴き手のDCC帰還は別経路(§9.3.57)。

Research Controls

instrumentを研究するための面であり、作曲用ではありません。通常の作曲では触れません。研究上の問いが定まるにつれて変更または削除される可能性があります。

TimelineとPopulation

observe_felt_beat

observe_felt_beat()

Reserve habitat felt-beat observation before time advances in an endless scenario. Required for positive syncopate in endless scenes. Late declarations and unreserved placements are positioned errors. Finite scenes warn and ignore the declaration; placement pre-scanning reserves observation only when needed. Research only.

根拠: 作者規則:終わりを定めない演奏で感じられた拍の観測を予約する。入力は、60 ms の間に水準が 1 dB 上がって続く発音だけを読む。

temporal_mode

temporal_mode(name)

Select off or observe for new temporal cognition before playback. Declare once at top level before events or time advance. Default off keeps behavior. Observe currently tracks ordered NSGT evidence on both buses; relation inference remains unknown and no new action pressure is applied. Participate is rejected until implemented and calibrated. Run a new scenario to change mode.

根拠: 該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。

Phonationとリズム

syncopate

syncopate(w)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

Confirm an uncertain felt beat, defer to a half beat, or omit an opportunity (default 0). Finite nonnegative weight, without an upper bound. Requires metric() and microtiming(0); otherwise warns and uses zero. After existing vetoes, draws with a private Voice RNG: beat probability (1-c)^w, otherwise half-beat probability m_plus, otherwise omission. Unknown observation bypasses without drawing. Positive consumers read habitat frequency, felt phase and beat probability times R for coupling; the oscillator phase stays continuous. Half-beat targets expire after that cycle and do not change microtiming. Template values inherit; respawn resets private state. Zero owns no state/RNG and requests no observation. Initial-only; research only.

根拠: 作者規則:独立した拍の確認と半拍への発音の支え。観測は候補(Cannon 2021の図示値)、格子の推論と半拍への型の配置は作者規則。入力も作者規則:60 ms の間に水準が 1 dB 上がって続く発音だけを読む。

Pitch Movement

pitch_core

pitch_core(name)

適用対象:PopulationSpecのみ。 初期設定専用:place()より前にPopulationSpecへ設定する。

"hill_climb" or "peak_sampler". Research control.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

move_cost_time_scale

move_cost_time_scale(name)

適用対象:PopulationSpecとPopulation。 実行中に更新可能:Population内で鳴っているVoiceを更新する。

"legacy"/"integration_window" or "proposal"/"proposal_interval". Canonical names: legacy (default, integration-window scaling) and proposal_interval. Research control; changes the time scale used for movement cost.

根拠: 作者規則:音高移動、提案選択、探索費用(§9.3.57、§9.3.98–99)。既存の基本動作の既定値は維持。

Directorとglobal parameter

control_update_mode

control_update_mode(name)

"snapshot_phased" (default) or "sequential_rotating". Scene-wide research control. Scene-wide initial condition; the last declaration wins. Canonical names: snapshot_phased (default) and sequential_rotating.

根拠: 該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。

scaffold_off

scaffold_off()

Disable the external rhythm scaffold. Scene-wide initial condition; the last declaration wins. Scaffolds are external comparison controls for demos and assays, not the rhythm-composition abstraction.

根拠: 作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。

scaffold_shared

scaffold_shared(freq_hz)

Shared external scaffold pulse. Scene-wide initial condition; the last declaration wins. Frequency is nonnegative Hz; the default scene has no external scaffold.

根拠: 作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。

scaffold_scrambled

scaffold_scrambled(freq_hz, seed)

Per-voice scrambled scaffold pulse. Scene-wide initial condition; the last declaration wins. Frequency is nonnegative Hz; the default scene has no external scaffold.

根拠: 作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。

設定の根拠

以下はAppConfigの末端キーであり、新たなRhai関数ではありません。研究設定の層1・4の制約は維持され、協和の評価係数をRhaiへ直接公開する変更もありません。任意の設定は引き続き省略できます。busの結合(|)は該当なし(経路)です。send()と組み込みbusの説明を参照してください。

キー根拠
body_metabolism.enabled作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。
body_metabolism.updates_per_hop作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。
body_metabolism.observation_frames作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。
body_metabolism.representative_hold_sec作者規則:代謝、生存可能性、近傍個体との相互作用、生存過程・再生成。感覚入力を使っても、生態則が聴覚モデルになるわけではない(§9.3.57)。
render_prototype該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
temporal_meter_t2作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
audio.latency_ms該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
audio.sample_rate該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
audio.limiter該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
audio.output_gain_db該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
analysis.nfft該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
analysis.hop_size該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
analysis.tau_ms作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
analysis.kernel_align該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
psychoacoustics.loudness_exp原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:採用した感覚実装の尺度。全係数の原典一致の認定でも、層1の感覚を作曲用に開放する札でもない(§9.3.94)。
psychoacoustics.roughness_k原理:入力となるH/Rの感覚機能。個々の式・定数の原典一致を認定する札ではない(§9.3.56、§9.3.104)。
作者規則:採用した感覚実装の尺度。全係数の原典一致の認定でも、層1の感覚を作曲用に開放する札でもない(§9.3.94)。
psychoacoustics.consonance.field.kernel.a作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.consonance.field.kernel.b作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.consonance.field.kernel.c作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.consonance.field.kernel.d作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.consonance.field.level.beta作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.consonance.field.level.theta作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.consonance.density.roughness_gain作者規則:協和の評価、符号、粗さの好み。H/Rの感覚は変更しない(§9.3.56)。既存の評価の既定値は維持。
psychoacoustics.habituation.enabled原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
psychoacoustics.habituation.satiation_sec原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
psychoacoustics.habituation.recovery_sec原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
psychoacoustics.habituation.ref_drive原理:入力となる馴化の機能(§9.3.60)。
作者規則:現行の馴化の浸食式と時間・駆動の工学値(§9.3.60)。
dcc.coupling_strength作者規則:結合の重み。Voice間の結合と聴き手のDCC帰還は別経路(§9.3.57)。
dcc.max_temperature_bonus作者規則:結合の重み。Voice間の結合と聴き手のDCC帰還は別経路(§9.3.57)。
playback.wait_user_exit該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
playback.wait_user_start該当なし(運転):出力、再現性、研究用の実行設定(§9.3.56)。
temporal_ridge.means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_ridge.deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.group_means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.group_deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.accent_means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.accent_deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.group_retirement_sec作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.inactive_energy_max作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.correlation_window_sec作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.min_pairs作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.min_coverage作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_acoustic.persistence_hops作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_period.model作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_period.horizon_sec作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.component_weights作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.gain作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.threshold作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.weight_gain作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.window作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.combination作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.attribution作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_t2.unknown作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body.means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body.deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body.accent_means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body.accent_deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body_prototypes.model_version該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_body_prototypes.sample_rate該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_body_prototypes.nfft該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_body_prototypes.hop_size該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_body_prototypes.means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body_prototypes.deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body_prototypes.accent_means作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body_prototypes.accent_deviations作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_body_prototypes.medoids.record_id該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_body_prototypes.medoids.raw_values該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_body_prototypes.medoids.mask該当なし(観測データ):凍結した記述子、識別子、取得時の構成。データを認知の定数としない。
temporal_onset_comparison.footprint作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_onset_comparison.arrival作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。
temporal_onset_comparison.arrival_weight作者規則:研究用のモデル、比較、正規化、対照。内部学習を作曲者が操作する語ではない(§9.3.55–57)。

サンプル

16本のサンプルを、同じsamples/内の二つの群として紹介します。1〜12は、機能を 一つずつ確かめる小さな実演です。音楽作品ではなく、APIと挙動を示します。 13〜16は、それらの機能を組み合わせて曲として書いた、やや長い場面です。 どちらも実行し、scriptを読んで確かめられます。

cargo run --release -- samples/01_a_single_voice.rhai

機能の実演(1〜12)

  1. A Single Voice — 一つのVoiceが現れ、息を保ち、去る。
  2. Constellation — line、peak、density、strain、gap、chanceという六つの入り方。
  3. Gravity — 二つのsunの下の同じroot。peakはchartではなく現在の音を聴く。
  4. Tension — Voiceが協和へ落ち着き、不安定になって離れ、再び冷えて落ち着く。
  5. Settling — 散らばったVoiceが、Consonance Fieldに支えられる場所へ滑らかに移る。
  6. Bells — 打撃されるbody。最後のbellはpartialをFieldに選ばせる。
  7. Heartbeat — 拍を打つ専用Voiceを使い、同期を実演する。
  8. Murmuration — 指揮者のいない群れ。各Voiceは自分の間合いを保ち、聴こえた再来へ周期を寄せる。共有の拍は狙わない。
  9. Rain — beatを持たず、Fieldに沿って落ちる時間。
  10. Generations — Voiceが生き、飢え、和声に支えられる場所へ生まれ直す。
  11. Autumn Cycle — directionを持つharmony。季節が巡り戻る。
  12. Emergence and Resolution — Populationの探索が強まり、再び落ち着く。専用の拍打ちは置かず、Voice自身の発音がリズムの入力を担う。

機能を組み合わせた曲(13〜16)

  1. Three Windows — 三本の線が音高を採用するたびに発音し、それぞれの扉から去る。
  2. Stone and Wire — 拍を刻む二つのVoiceの間を、独立した線が横切る。
  3. Folded Air — 相手が休みを置いて戻り、区間ごとに発音の形を変える。
  4. Open Court — やや密な群れが、独立した二本の道の周りへ集まる。

道筋と実行

1〜6はConsonance Field上の配置、引力、緊張、移動、音色を紹介します。 7〜9は三つの時間の取り方を示します。metric()は音から確認された共有拍へ寄り、 entrained()は共有拍の位相を狙わず、音を聴いて参加します。flow()は拍を作らない、 かたまりの更新を担います。10は生存と世代交代の循環、11〜12は複数の機構の組み合わせです。 13–16は、採用ごとに発音する線、拍を刻むVoiceと横切る線、 休む相手と区間ごとの発音の切り替え、やや密な群れを示します。 全サンプルはtest suiteでcompile-checkされ、現在のAPIとの 不一致を検出します。最上位のサンプルは意図的にseed(...)を呼ばず、毎runを新しい scenario seedで始めます。 比較を再現可能にする必要があるresearch assayだけが固定seedを使います。

音高の基準を作るanchorは、通常はhabitat busだけへ送られ、直接は聞こえません。 Gravityでは、聞こえる持続音そのものが主題です。Heartbeatは同期を実演するため、拍を打つ 専用Voiceを置いています。他の公開サンプルには専用の拍打ちVoiceはありません。

Research assay

samples/research/にはheredity/selection ablation、external-scaffold rhythm control、 mechanism studyなどの比較fixtureがあります。instrumentを演奏するのではなく研究するもので、 上の道筋には含まれません。 専用の同期補助は、明示的な同期が実演や実験に不可欠な場合だけ使います。 habitat busだけへ送って聞こえなくしても、他のサンプルで使える理由にはなりません。

Offline rendering

conchordal instrumentはaudioをdiskへ書きません。演奏は、音が鳴り終わるとinstrument内には 残らない一過的な出来事(ephemeral)として設計されています。offline WAVには、同じcore engineを 共有する別binaryのconchordal-renderを使います。