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と同じ英語の単一ソースを掲載しています。
根拠の札は機構の部分ごとに付き、公開用途の区分とは独立です。機構の根拠と作曲者の選択を参照してください。札の追加は既定値の変更や受入の認定ではありません。
型
| 型 | 説明 | 根拠 |
|---|---|---|
FloraSpec | flora()で作る、スペクトル成長の再利用可能な設定。周波数範囲に配置するとFloraになる。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
Flora | 配置されたスペクトル成長。振幅と拍に対する生態時間の倍率を更新でき、解放を指定できる。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
RainSpec | rain()で作る、打音のtextureの再利用可能な設定。周波数範囲に配置するとRainになる。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
Rain | 配置された打音のtextureと共鳴する物。amp、rate、sway、hit、widthの更新と解放を指定できる。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
PopulationSpec | 再利用可能なPopulationSpec。初代のVoiceの特性に、生存過程、respawn、個体数の規則を組み合わせる。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
Population | place()が返すPopulation。Voiceが死亡し世代交代しても、同一性を保つ安定した参照。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
Placement | 初代のVoiceをどこへ配置するかを表す。at()、consonance()、dissonance()、edge()、gap()、random()、line()で作る。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
ModePattern | モーダル合成の発音体に使う周波数構成。*_modes()関数で作る。 | 該当なし(APIの器):構築・操作に使う語の札を参照。 |
Bus | 二つのmono出力busの一つ。` | で結合するとBusSet`になる。 |
BusSet | `bus | busで作るbusの組み合わせ。send()`へ渡す。 |
組み込み定数
| 定数 | 型 | 説明 | 根拠 |
|---|---|---|---|
habitat_bus | Bus | 解析bus:聴覚解析を経てLandscapeへ送られ、生態系が知覚する。 | 該当なし(経路):busの選択・結合。独立した自己知覚の規則はleave_self_outを参照。 |
presentation_bus | Bus | 提示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
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
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
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)。 |