# Umber Grove — complete Csound settings

## Note and effect connections

Instrument 1 uses p3 for held seconds, p4 for MIDI pitch and p5 for velocity from 0 to 1. Its left and right outputs accumulate on shared buses. Instrument 90 processes the buses once per control block, clears the inputs and keeps effect memories active through the tails. Envelopes with release segments extend the note automatically. The score is an audible pitch-and-touch example; the synthesis controls are independent of its particular notes.

## Csound interpretation

These are explicit Csound models, not identical implementations of the Ableton devices. Wavetable positions, proprietary oscillator engines, physical-model macros, filter circuits, envelope slopes and effect algorithms can differ. Modulation depths are specified in octaves, cents or milliseconds rather than treated as universally interchangeable matrix values. Controller inputs such as pitch bend, modulation wheel, pressure and per-note expression are not mapped. Independent score notes do not implement Live's monophonic note-priority or legato system. Any pitch memory or drift included in this instrument is described in its steps.



## Signal path and controls

### Stage 1 — Excite a decaying string mode bank

Feed a 1.5 ms shaped pulse with a quiet noise component into sixteen string modes. The strike position is 0.13 of string length and the pickup position 0.22. Each mode is weighted by the sine of both positions, so moving the strike changes which harmonics are suppressed. A small stiffness term bends upper partials away from perfect harmonic ratios. The fundamental T60 is 2.6 s and upper modes decay faster. This modal bank interprets Tension rather than implementing its plectrum and string solver.

| Csound control | Value |
| --- | --- |
| Strike / pickup | 0.13 / 0.22 of length |
| Mode frequencies | f × n × sqrt(1 + 0.00008 × n²), below 11000 Hz |
| Decay | T60 / (1 + 0.08 × (n−1)^1.3) |
| Fundamental T60 | 2.6 s |
| Exciter lowpass | 4780 Hz |
| String scaling / instrument | 0.02 × (0.4 + 0.6 × velocity) / −10 dB |

### Stage 2 — Blend body modes and soften the string

Use broad body resonances at 97, 193 and 450 Hz with Q values 8, 12 and 18. Blend 28% of their weighted sum with the string and lowpass at 3900 Hz. The body colors the lower spectrum rather than supplying a sustained oscillator. Natural mode tails continue after the short excitation; the script holds their state for twice the fundamental T60. Body size, damping and pickup geometry are represented by these explicit choices, not a numerical conversion of all Tension macros.

| Csound control | Value |
| --- | --- |
| Body modes | 97/193/450 Hz; Q 8/12/18 |
| Body weights / scale | 0.4/0.2/0.1 × 0.04 |
| Body mix | 28% |
| Lowpass | 3900 Hz |

### Stage 3 — Round the signal with saturation

Use +0.5 dB drive with 30% shaped signal and -1 dB output trim. The smooth curve is `tanh(input × 3 × ampdb(drive)) / 3`; the other portion stays clean. Louder peaks enter its curved region more strongly, adding harmonics and rounding the envelope. This interprets the source saturation curve rather than implementing its proprietary transfer function.

| Csound control | Value |
| --- | --- |
| Drive / output | 0.5 / -1 dB |
| Shaped mix | 30% |
| Input DC removal | Order 2048 |

### Stage 4 — Surround the tone with a damped room

Feed the preceding signal through 12 ms predelay into `reverbsc`, with feedback 0.5101, 4500 Hz damping and 12% wet mix. Predelay leaves the initial articulation in front; feedback prolongs the tail, while damping darkens repeated circulation. The source room decay setting is 1.04 seconds, but Csound feedback is not a decay-time control: this is an interpretation of that space, with different diffusion and modulation. 

| Csound control | Value |
| --- | --- |
| Source decay target | 1.04 s (not a measured Csound decay) |
| Predelay / feedback | 12 ms / 0.5101 |
| Damping / wet | 4500 Hz / 12% |
| Room side multiplier | 1 |
| Room input cuts | Off |

### Stage 5 — Set the final width and gain

Use 17.4 dB gain after the effects. Scale the side signal by 1, preserving the center. Apply order-2048 DC removal, using a longer window to limit low-note loss. The fixed output-scale control at the end of instrument 90 remains a separate Csound gain setting. Clear the shared note buses only after processing them; effect memories continue carrying their own tails.

| Csound control | Value |
| --- | --- |
| Final gain | 17.4 dB |
| Width | 1 × side |
| Bass side cutoff | Off |
| DC removal | Order 2048 |

## Output and signal rates

The script uses 48000 Hz, 16-sample control blocks and stereo output. The fixed output-scale control is `0.6675029` and follows the whole chain at every stage, separate from any final gain step. DC-removal blocks, where enabled, use order 2048 to limit low-note attenuation; they add processing delay.

[Build guide and full script](BUILD_GUIDE.md#full-csound-script) · [Starting settings](STARTING_STATE.md)

[Read on playgrid.cc](https://playgrid.cc/tutorials/umber-grove/csound/settings/)
