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は試聴中のCore候補です。Mechanism Tuningは、Coreでは表せない挙動を作品が必要とするとき、動詞の背後にある機構を調整します。Research Controlsは作曲ではなく、instrumentを研究するためのものです。関数ごとの技術説明は、LSP hoverと同じ英語の単一ソースを掲載しています。

型

組み込み定数

Core API

選別された作曲用の面です。すべてのサンプルは、ここにある動詞だけで記述できます。

PopulationSpec

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

sine

sine() -> PopulationSpec

PopulationSpec whose founder voices use a pure sine body.

harmonic

harmonic() -> PopulationSpec

PopulationSpec whose founder voices use a harmonic-series body.

modal

modal() -> PopulationSpec

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

saw

saw() -> PopulationSpec

Harmonic-body preset with brightness 0.85.

square

square() -> PopulationSpec

Harmonic-body preset with brightness 0.65.

noise

noise() -> PopulationSpec

Harmonic-body preset with full brightness and maximal spectral motion (jitter).

variant

variant(population_spec) -> PopulationSpec

Clone a PopulationSpec so the copy can be modified independently.

配置

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

at

at(freq_hz) -> Placement

Place at a fixed frequency in Hz.

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.

dissonance

dissonance(min_hz, max_hz) -> Placement

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

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.

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.

peak

peak()

適用対象：Placement。

Realize a field target as its deterministic extremum.

density

density()

適用対象：Placement。

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

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).

random

random(min_hz, max_hz) -> Placement

Log-uniform random placement inside a frequency range.

line

line(start_hz, end_hz) -> Placement

Linear interpolation of positions between two frequencies.

count

count(n)

適用対象：Placement。

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

range

range(min_mul, max_mul)

適用対象：Placement。

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

spacing

spacing(min_erb)

適用対象：Placement。

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

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.

wait

wait(seconds)

Emit pending live patches, then advance the timeline cursor.

flush

flush()

Emit pending live patches without advancing time.

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.

section

section(name, callback)

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

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.

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.

seed

seed(value)

Set the random seed for reproducible scenarios.

Bodyと音色

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

amp

amp(value)

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

Amplitude in 0.0-1.0.

freq

freq(hz)

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

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

brightness

brightness(value)

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

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

spread

spread(value)

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

Detuning spread.

unison

unison(count)

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

Number of unison detuning copies.

modes

modes(pattern)

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

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

adsr

adsr(attack_sec, decay_sec, sustain_level, release_sec)

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

ADSR amplitude envelope.

Phonationとリズム

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

brain

brain(name)

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

Articulation life: "entrain" (default), "seq", or "drone". Selects how the voice lives while sounding; orthogonal to the rhythm coupling continuum (metric/entrained/flow). entrain is a living articulation whose vitality responds to consonance and rhythm fit, subject to the metabolism economy. seq holds for a fixed lifetime, ignoring the field and metabolism. drone is undying, sustaining forever with a slow sway – useful as terrain material.

sustain

sustain()

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

Sustain phonation mode (default).

repeat

repeat()

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

Repeated/pulsed phonation mode.

metric

metric()

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

High coupling to the shared emergent meter: deep attractor, stable pulse. Takes no rate argument: the tempo region is director-level terrain (temporal_basin).

entrained

entrained()

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

Medium coupling: synchronization emerges over time, still drifts.

flow

flow()

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

Near-zero coupling: free renewal process, non-metric texture.

entrainment

entrainment(strength)

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

Override coupling strength in 0-1 (free .. locked). Order-independent with presets: entrainment(0.8).metric() and metric().entrainment(0.8) are equivalent.

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.

microtiming

microtiming(amount)

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

Signed beat-phase offset in -0.5..0.5; 0.5 reads as syncopation.

cycles

cycles(n)

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

Duration of n rhythm cycles.

Pitch Movement

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

anchor

anchor()

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

Hold the voice at its pitch: an anchored voice never moves. Voices placed with at() or given freq() are anchored implicitly; use anchor() to hold strategy-placed voices (consonance(), dissonance(), …) at their settled position, or to state the intent explicitly.

seek_consonance

seek_consonance()

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

Free hill-climb movement toward better field positions, with glide defaults. How pitch decisions land is resolved at placement unless pitch_apply_mode() was called: sustained voices glide, re-attacking voices (pulse(), metric(), entrained(), flow()) snap at onsets.

glide

glide(tau_sec)

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

Pitch glide time constant in seconds.

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().

近傍の知覚

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.

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.

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.

attack_cost_fraction

attack_cost_fraction(value)

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

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

attack_recharge_fraction

attack_recharge_fraction(value)

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

Maximum normalized energy restored by a fully consonant attack.

sustain_drive

sustain_drive(value)

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

Continuous drive level for sustained voices.

consonance_viability

consonance_viability(low, high)

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

Consonance window used for viability scoring. Enables environment-relative scoring by default: a voice is evaluated against the field with its own footprint approximately removed (see viability_scope()).

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.

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.

respawn_hereditary

respawn_hereditary(sigma_oct)

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

Respawn near an energy-weighted living parent, with frequency variance in octaves. Candidates share one selected parent. The candidate with the highest current Consonance Field level is used.

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.

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.

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()).

respawn_min_c_level

respawn_min_c_level(level)

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

Minimum consonance level for respawn acceptance.

respawn_background_death_rate

respawn_background_death_rate(rate)

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

Background turnover rate per second.

Mode Pattern

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

harmonic_modes

harmonic_modes() -> ModePattern

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

odd_modes

odd_modes() -> ModePattern

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

power_modes

power_modes(beta) -> ModePattern

Power law: f * n^beta.

stiff_string_modes

stiff_string_modes(stiffness) -> ModePattern

Stiffness-adjusted harmonics.

custom_modes

custom_modes(ratios) -> ModePattern

Custom frequency ratios from an array.

modal_table

modal_table(name) -> ModePattern

Named mode table lookup. Falls back to harmonic_modes() with a warning if the name is unknown.

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.

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.

count

count(n)

適用対象：ModePattern。

Number of modes.

range

range(min_mul, max_mul)

適用対象：ModePattern。

Frequency range; only valid on landscape_*_modes().

spacing

spacing(min_erb)

適用対象：ModePattern。

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

gamma

gamma(g)

適用対象：ModePattern。

Density sharpening exponent; only valid on landscape_density_modes().

jitter

jitter(cents)

適用対象：ModePattern。

Randomize mode frequencies by up to the given cents.

seed

seed(value)

適用対象：ModePattern。

Random seed for jittered patterns (>= 0).

Routing

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

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).

Directorとglobal parameter

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

meter_stability

meter_stability(value)

Attractor depth in 0-1: how readily a pulse forms. A soft prior: it only deepens the basin for a real periodicity; it never fabricates a beat from non-metric input.

temporal_basin

temporal_basin(min_hz, max_hz)

Tempo region the emergent beat gravitates toward. The time-axis analogue of consonance(min, max): it shapes the terrain, does not place a beat, and never forces a measure.

Experimental

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

Phonationとリズム

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.

Mechanism Tuning

Core動詞の背後にある機構を細かく制御します。既定値は調整済みです。Coreでは表せない特定の挙動を作品が必要とするときに使います。

Phonationとリズム

once

once()

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

Single trigger.

pulse

pulse(rate_hz)

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

Pulse at an explicit rate in Hz.

while_alive

while_alive()

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

Hold/sustain until release.

adaptive_duration

adaptive_duration()

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

Duration follows field support.

pulse_lock

pulse_lock(depth)

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

Low-level pulse phase weighting in 0-1.

social

social(coupling)

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

Social coupling for entrained() or pulse(), in 0-1.

duration_range

duration_range(min_cycles, max_cycles)

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

Adaptive duration range in rhythm cycles.

duration_curve

duration_curve(k, x0)

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

Adaptive duration curve parameters.

shorten_on_drop

shorten_on_drop(gain)

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

Shorten adaptive duration when field support drops.

rhythm_freq

rhythm_freq(freq_hz)

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

Internal theta/rhythm oscillator frequency.

rhythm_coupling_vitality

rhythm_coupling_vitality(lambda_v, v_floor)

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

Vitality-modulated rhythm coupling.

rhythm_reward

rhythm_reward(rho_t, metric)

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

Energy reward for timing fit; metric is "attack_phase_match" or "none".

Pitch Movement

pitch_smooth

pitch_smooth(tau_sec)

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

Pitch smoothing time constant in seconds.

pitch_apply_mode

pitch_apply_mode(name)

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

"gate_snap" or "glide": override how pitch decisions are applied. Without an explicit call, moving voices resolve this at placement from their phonation: sustained voices glide, re-attacking voices snap at onsets.

landscape_weight

landscape_weight(value)

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

Weight of the landscape objective.

neighbor_step_cents

neighbor_step_cents(value)

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

Step size for neighbor exploration in cents.

move_cost

move_cost(coeff)

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

Cost multiplier for pitch changes.

move_cost_exp

move_cost_exp(exp)

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

Exponent for the move cost.

proposal_interval

proposal_interval(seconds)

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

Proposal generation interval in seconds.

tessitura_gravity

tessitura_gravity(value)

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

Gravity toward the tessitura center.

window_cents

window_cents(width)

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

Peak-sampler search window width in cents.

top_k

top_k(count)

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

Number of top candidates kept by the peak sampler.

sigma_cents

sigma_cents(spread)

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

Gaussian spread of the peak sampler in cents.

random_candidates

random_candidates(count)

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

Number of random candidates considered.

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.

ratio_candidates

ratio_candidates(count)

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

Ratio-based movement candidates; 0 disables.

近傍の知覚

crowding_target

crowding_target(same_visible, other_visible)

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

Which voices are visible to crowding: own population, other populations (booleans).

leave_self_out

leave_self_out(enabled)

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

Subtract the voice’s own spectral contribution when evaluating the field.

leave_self_out_harmonics

leave_self_out_harmonics(count)

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

Number of harmonics used for approximate self-subtraction.

LifecycleとViability

viability_scope

viability_scope(name)

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

"environment" (default) or "total" viability scoring scope. Use "total" only when the selection question should include the voice’s own contribution.

Directorとglobal parameter

set_roughness_k

set_roughness_k(value)

Roughness tolerance of the landscape.

set_global_coupling

set_global_coupling(value)

Voice interaction strength.

Research Controls

instrumentを研究するための面であり、作曲用ではありません。通常の作曲では触れません。研究上の問いが定まるにつれて変更または削除される可能性があります。

Pitch Movement

pitch_core

pitch_core(name)

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

"hill_climb" or "peak_sampler". Research control.

move_cost_time_scale

move_cost_time_scale(name)

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

"legacy"/"integration_window" or "proposal"/"proposal_interval".

近傍の知覚

leave_self_out_mode

leave_self_out_mode(name)

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

"approx"/"approx_harmonics" or "exact"/"exact_scan".

LifecycleとViability

selection_approx_loo

selection_approx_loo(enabled)

適用対象：PopulationSpecのみ。

Override environment-relative viability scoring; research/reference control. PopulationSpec only. Use only for older reference assays that need the previous implementation-level control.

Directorとglobal parameter

set_pitch_objective

set_pitch_objective(name)

"consonance"/"positive" or "dissonance"/"negative". Research control.

set_control_update_mode

set_control_update_mode(name)

"snapshot_phased"/"snapshot" (default) or "sequential_rotating"/"sequential". Research control.

set_scaffold_off

set_scaffold_off()

Disable the external rhythm scaffold. Scaffolds are external comparison controls for demos and assays, not the rhythm-composition abstraction.

set_scaffold_shared

set_scaffold_shared(freq_hz)

Shared external scaffold pulse.

set_scaffold_scrambled

set_scaffold_scrambled(freq_hz, seed)

Per-voice scrambled scaffold pulse.