elements.catalog.helmholtz_resonator
elements.catalog.helmholtz_resonator(volume, neck_length, neck_area, name='hr')Side-branch Helmholtz resonator: a tee, a neck duct, and a backing cavity.
The “first user” of the composite mechanism (TODO item 3): a single element wrapping the junction + duct (neck) + cavity build that is otherwise placed by hand. The main line passes straight through the tee (the two external edges both attach to it); the neck duct and cavity hang off as an internal side branch. Resonates at the lumped Helmholtz frequency f0 = c * sqrt(neck_area / (volume * neck_length)) / 2pi, the neck’s inertance (its duct phase) against the cavity’s compliance (storage M).
Parameters
| Name | Type | Description | Default |
|---|---|---|---|
| volume | float | Backing cavity volume [m^3]. | required |
| neck_length | float | Neck length [m] (the acoustic inertance; lengthen by an end correction to model the entrained near-field mass). | required |
| neck_area | float | Neck cross-sectional area [m^2]; the two internal edges (tee->neck, neck->cavity) carry it. | required |
| name | str | Display name. | 'hr' |
Returns
| Name | Type | Description |
|---|---|---|
| CompositeElementSpec |