Ir al contenido

noise_control.hvac

La referencia de la API se publica en inglés en los dos idiomas: se genera a partir de los docstrings del código, que son su texto original.

HVAC duct acoustics: fan power, duct losses, plenums and flow-generated noise.

A ventilation duct network attenuates fan noise through several mechanisms that add up along the path, and it regenerates noise wherever the airflow is disturbed. This module gathers the element models that a duct-borne noise calculation needs, from two engineering references that are kept side by side rather than merged, with the German guideline VDI 2081 beside them as a third model where it gives one:

  • Bies, Hansen & Howard, Engineering Noise Control 5th ed., Chapter 8, for the duct end reflection (§8.13, Table 8.14), the bends/elbows (§8.11, Table 8.11), the plenum chambers (§8.17, Wells’ method) and the flow-generated (self) noise of straight ducts and bends (§8.15).
  • Long, Architectural Acoustics 2nd ed., Chapters 13 and 14, for the fan sound power from the operating point (Eq. 13.1 with the ASHRAE Tables 13.5-13.7), the straight-duct attenuation of unlined and lined rectangular and circular ducts (Eqs. 14.9-14.13 with Tables 14.1-14.3, the Reynolds regressions), the lined flexible duct insertion loss (Table 14.4), the branch split loss (Eq. 14.17), the closed-form end reflection (Eqs. 14.14-14.16), the silencer self-noise (Eq. 14.31 with Table 14.8) and the room effect that turns the sound power arriving at the terminal device into a sound pressure level in the room.
  • VDI 2081 Part 1 for the German fan model (Section 4.3), the flow noise of straight ducts and bends (Section 5.2), the straight-duct, bend, branch and end-reflection reductions (Tables 5 and 7, Equation (35), Figure 28) and the silencer self-noise (Section 7.2.4.2), each selected with model="vdi2081" (method="vdi2081" for the end reflection); and Part 2 for the octave limits an A-weighted room requirement sets, read through the spectral assessment curve SPECTRAL_CORRECTION.

Both references trace back to the same ASHRAE data for the elbows: Bies Table 8.11 is indexed by and Long Tables 14.5-14.7 by the frequency-width product f w (kHz times inches), and the two indexings agree band by band (), so elbow_insertion_loss serves both. Where they genuinely differ (the end reflection, tabulated by Bies and given in closed form by Long), both are selectable (method="bies" or method="long") and neither replaces the other.

phonometry.noise_control.duct_path chains these elements into the end-to-end fan-to-room calculation.

Auto-generated from the source docstrings by scripts/generate_api_docs.py (make api-docs). Do not edit by hand.

air_terminal_damper_correction(
pressure_ratio: float,
*,
location: Literal['diffuser_neck', 'plenum_inlet', 'supply_duct'] = 'diffuser_neck',
) -> float

Level to add to a diffuser sound rating for a throttled volume damper.

ASHRAE (2019) HVAC Applications Handbook Chapter 49, Table 10. A balancing damper throttled in the neck of a diffuser turns the pressure it drops into noise right at the outlet, where the room hears it: at a damper pressure ratio of 3 the published penalty is 15 dB in the neck, 5 dB in the inlet plenum and 2 dB when the damper sits at least 1.5 m back in the supply duct. That ordering is the whole design rule: throttle far from the outlet, or balance the system with duct sizing instead.

The table is interpolated linearly between its tabulated pressure ratios (1.5 to 6) and held flat outside them.

Parameters

Name Description
pressure_ratio Damper pressure ratio, the total pressure drop across the damper divided by the pressure drop of the outlet itself.
location Where the damper sits: "diffuser_neck" (in the neck of a linear diffuser), "plenum_inlet" (in the inlet of the plenum of a linear diffuser) or "supply_duct" (in the supply duct at least 1.5 m from the inlet plenum).

Returns: The level to add to the diffuser’s rated sound power, dB.

Raises

Exception When
ValueError If pressure_ratio is not positive or location is unknown.
TypeError if location is not a text, or pressure_ratio is not a single number.
air_terminal_velocity_limit(
design_criterion: float,
*,
opening: Literal['supply', 'return'] = 'supply',
) -> float

Maximum recommended neck velocity of a diffuser or register.

ASHRAE (2019) HVAC Applications Handbook Chapter 49, Table 9: the “free” opening airflow velocity not to be exceeded if the room is to reach a given design RC(N), for use when no sound data is available for the selected device. It is a screening check, not a spectrum: the sound power of a real grille, register or diffuser comes from manufacturer data measured to ASHRAE Standard 70, and diffuser_sound_power estimates it when that data is not to hand. Several devices in the same room, or a damper throttled in the neck, raise the level further and the allowable velocity has to be reduced accordingly.

Parameters

Name Description
design_criterion Design RC(N) of the room; one of 25, 30, 35, 40 or 45.
opening "supply" (supply air outlet) or "return" (return air opening).

Returns: The maximum recommended neck velocity, m/s.

Raises

Exception When
ValueError If the design criterion is not tabulated.
TypeError if opening is not a text, or design_criterion is not a single number.
blade_passing_frequency(
rotational_speed_rpm: float,
n_blades: int | np.integer[Any],
) -> float

Blade passing frequency (Long Eq. 13.4).

.

Parameters

Name Description
rotational_speed_rpm Fan speed, revolutions per minute.
n_blades Number of impeller blades.

Returns: The blade passing frequency, Hz.

Raises

Exception When
ValueError If n_blades is not a whole number from 1, or the speed is not positive.
TypeError if rotational_speed_rpm is not a single number, or n_blades is a flag, a text or an array where a count goes.
diffuser_sound_power(
frequencies: NumericArrayLike | None,
face_area: float,
volume_flow: float,
pressure_drop_pa: float,
*,
shape: Literal['rectangular', 'round'] = 'rectangular',
n_devices: int | np.integer[Any] = 1,
) -> HVACSpectrumResult

Regenerated (self) noise of a grille, register or diffuser.

Reynolds’s estimate as Long Eqs. 13.27 to 13.33, for when the manufacturer’s ASHRAE Standard 70 data is not to hand. The overall sound power level is Eq. 13.27:

with S_\mathrm{G} the face area of the device (ft2), the approach velocity (ft/s) and the normalised pressure-drop coefficient of Eq. 13.28 (dP in inches of water gauge, lb/ft3); this function takes and returns SI and converts internally.

The octave-band spectrum follows from Eq. 13.29, , with the shape functions of Eqs. 13.30 and 13.31:

normalised to the peak frequency of Eq. 13.32, where is the distance in octaves from the peak band (Eq. 13.33) counted on Long’s band numbering, 0 at 32 Hz.

The sixth power of velocity in Eq. 13.27 is the design message: the level rises about 18 dB for every doubling of the approach velocity, and for a given air volume doubling the face area buys about 15 dB. Nothing downstream can take that noise back out, because there is no ductwork left, which is why the terminal device usually sets the room criterion in the mid and high bands.

Several identical devices serving the same room add , which is what n_devices applies.

Parameters

Name Description
frequencies Octave-band centres, Hz; None uses the eight octave bands from 63 Hz to 8 kHz.
face_area Cross-sectional face area S_\mathrm{G} of one device, m2.
volume_flow Volume flow Q through one device, m3/s.
pressure_drop_pa Static pressure drop dP across the device, Pa.
shape "rectangular" (Eq. 13.31, includes slot diffusers) or "round" (Eq. 13.30).
n_devices Number of identical devices n in the room.

Returns: An HVACSpectrumResult of the band sound power level, dB re 1e-12 W.

Raises

Exception When
ValueError If a dimension is not positive, n_devices is not a whole number from 1 or shape is unknown.
TypeError if shape is not a text, face_area, pressure_drop_pa or volume_flow is not a single number, or n_devices is a flag, a text or an array where a count goes, or frequencies holds a text or a value that is not a real number.
elbow_insertion_loss(
frequencies: NumericArrayLike,
width_m: float,
*,
bend_type: Literal['round', 'square'] = 'square',
vanes: bool = False,
lined: bool = False,
speed_of_sound: float = 343.0,
model: Literal['ashrae', 'vdi2081'] = 'ashrae',
lined_side: Literal['both', 'one'] = 'both',
) -> HVACSpectrumResult

Duct bend/elbow insertion loss per bend, by either method.

Indexed by the frequency-to-width ratio (). Lined bends assume the lining extends at least three duct diameters up- and downstream. Round bends are treated as unlined with no vanes.

model="vdi2081" reads Table 7 of VDI 2081 Part 1 Section 6.2, which is printed once, for a 1250 mm side, and carried along the frequency axis for every other size. The duct’s limit frequency comes from Equation (33), c / (2 a), or Equation (34), 0.586 c / d; the octave holding it takes the place of the table’s own 125 Hz column, and the whole row moves with it. Below the shifted row the loss is nought, which is the guideline’s statement that a bend reflects nothing while only plane waves run.

The two methods index the same physics on the same ratio, but they do not tabulate the same bends: Table 7 distinguishes lining before, after, or on both sides of the corner, which the ASHRAE table does not, and width_m is read there as the largest side of a rectangular duct or the bore of a round one rather than as the width in the plane of the bend.

Parameters

Name Description
frequencies Frequencies f, Hz (1-D array).
width_m Duct width W in the plane of the bend, m. For model="vdi2081" it is the largest side of a rectangular duct, or the internal diameter of a round one.
bend_type "square" or "round". VDI 2081 reads a square bend as sharp-edged and a round one as radiused with r <= 2 D.
vanes Turning vanes fitted (square bends only).
lined Acoustically lined bend (square bends only).
lined_side VDI 2081 only. "both" (default) for lining before and after the corner, or "one" for lining on one side of it, which Table 7 tabulates separately. Ignored unless lined.
speed_of_sound Speed of sound c, m/s.
model "ashrae" (default) or "vdi2081".

Returns: A HVACSpectrumResult of the insertion loss, dB per bend.

Raises

Exception When
TypeError if lined_side or model is not a text, or speed_of_sound or width_m is not a single number, or bend_type is not a text, or frequencies holds a text or a value that is not a real number.
end_reflection_loss(
frequencies: NumericArrayLike,
diameter_m: float,
*,
termination: Literal['flush', 'room', 'wall', 'edge', 'corner', 'free'] = 'flush',
method: Literal['vdi2081', 'bies', 'long'] = 'bies',
speed_of_sound: float = 343.0,
aspect_ratio: float = 1.0,
max_reduction: float | None = 15.0,
) -> HVACSpectrumResult

Duct end reflection loss (Bies Table 8.14, ASHRAE; or Long’s closed form).

The low-frequency reflection of sound back up a duct at its open termination into a room. Two published methods are offered and neither replaces the other:

  • method="bies" (default) interpolates the ASHRAE look-up of Bies Table 8.14 over log diameter and log frequency, passing exactly through the tabulated (diameter, octave band) nodes. The table covers 63 Hz to 2 kHz and 150 mm to 1830 mm.
  • method="long" evaluates Reynolds’ closed form as given by Long (Eqs. 14.14-14.15), end_reflection_loss_closed_form, which has no frequency or diameter range limit.

The two agree within a couple of decibels over the bands both cover.

Parameters

Name Description
frequencies Frequencies f, Hz (1-D array).
diameter_m Duct internal diameter D, m (use equivalent_diameter for a rectangular duct of area S).
termination "flush" (duct flush with a wall/ceiling) or "free" (free space / suspended in the room).
method "bies" (Table 8.14 look-up), "long" (closed form) or "vdi2081" (VDI 2081 Part 1 Figure 28).
aspect_ratio VDI 2081 only. Nozzle length over height m (default 1, a square opening). Figure 28 is drawn from 1 to 30.
max_reduction VDI 2081 only. Ceiling on the reduction, dB (default 15). Section 6.6 says the theoretical value is not reached because the duct walls radiate what the nozzle reflects, and the guideline’s own worked example applies exactly this cap. None returns the uncapped closed form.
speed_of_sound Speed of sound c, m/s (used by the closed form; the table is indexed by frequency directly).

Returns: A HVACSpectrumResult of the reflection loss, dB.

Raises

Exception When
TypeError if method is not a text, or aspect_ratio, diameter_m, max_reduction or speed_of_sound is not a single number, or termination is not a text, or frequencies holds a text or a value that is not a real number.
end_reflection_loss_closed_form(
frequencies: NumericArrayLike,
diameter_m: float,
*,
termination: Literal['flush', 'free'] = 'flush',
speed_of_sound: float = 343.0,
) -> HVACSpectrumResult

Duct end reflection loss in closed form (Long Eqs. 14.14-14.15, Reynolds).

for a duct terminated in free space and for one terminated flush with a wall, d being the duct diameter (use the equivalent diameter equivalent_diameter for a rectangular duct, Eq. 14.16). The exponent 1.88 is Reynolds’ empirical fit: the plane-wave area-change result over-predicts at high frequency, where the sound leaves the duct as a beam and never sees the expansion. This is the closed-form alternative to the Bies/ASHRAE table look-up of end_reflection_loss; the two agree within a couple of decibels over the bands where both are defined.

End-reflection loss does not occur when the duct terminates in a diffuser, whose flare smooths the impedance transition into the room.

Parameters

Name Description
frequencies Frequencies f, Hz (1-D array).
diameter_m Duct internal diameter d, m.
termination "flush" (flush with a wall or ceiling) or "free" (free space).
speed_of_sound Speed of sound c, m/s.

Returns: An HVACSpectrumResult of the reflection loss, dB.

Raises

Exception When
TypeError if termination is not a text, or diameter_m or speed_of_sound is not a single number, or frequencies holds a text or a value that is not a real number.
equivalent_diameter(area: float) -> float

Equivalent duct diameter (Long Eq. 14.16).

Parameters

Name Description
area Duct cross-sectional area S, m2.

Returns: The equivalent diameter, m.

Raises

Exception When
TypeError if area is not a single number.
fan_casing_attenuation(
frequencies: NumericArrayLike | None = None,
) -> HVACSpectrumResult

Fan-housing (casing) attenuation of the radiated power (Long Table 13.8).

Subtracted from the sound power level of fan_sound_power to estimate what the fan radiates through its housing into the plant room rather than into the duct. The values assume no separate enclosure and no absorption inside the housing, but a silencer or a lining in the ductwork close to the fan; at low frequency the vibrating casing radiates as much as the unhoused fan would, hence the zeroes. Miller (1980) states them as approximate: real values depend strongly on the gauge and construction of the housing.

Parameters

Name Description
frequencies Octave-band centres, Hz; None (default) uses the eight octave bands from 63 Hz to 8 kHz.

Returns: An HVACSpectrumResult of the attenuation, dB.

Raises

Exception When
TypeError if frequencies holds a text or a value that is not a real number.
fan_efficiency_correction(*, relative_efficiency_percent: float) -> float

Off-peak efficiency correction C_EFF (Long Table 13.6).

A fan running away from its peak static efficiency is noisier at the same duty. The correction is a step function of the static efficiency expressed as a percentage of the peak (Long Eq. 13.3): 90 per cent of peak and above adds nothing, and anything below 50 per cent adds 16 dB. When the peak efficiency is unknown Long recommends assuming 80 per cent, which lands in the 6 dB step.

Parameters

Name Description
relative_efficiency_percent ASHRAE only. Static efficiency as a percentage of the peak, in (0, 100]. A fraction is not accepted in disguise: the table is tabulated from 50 % up, so 0.8 would fall to its bottom row and return 16 dB where 80 % returns 6, ten decibels with nothing to say it happened. Below 50 % the caller is warned that the value is outside the span Table 13.6 tabulates.

Returns: The correction C_EFF, dB.

Raises

Exception When
ValueError If the efficiency is not in (0, 100].
TypeError if relative_efficiency_percent is not a single number.
fan_sound_power(
volume_flow: float,
*,
fan_static_pressure_pa: float,
model: Literal['ashrae'] = ...,
fan_type: Literal['airfoil_large', 'airfoil_small', 'forward_curved', 'radial_low', 'radial_medium', 'radial_high', 'vaneaxial_hub_low', 'vaneaxial_hub_medium', 'vaneaxial_hub_high', 'tubeaxial_large', 'tubeaxial_small', 'propeller'] = ...,
relative_efficiency_percent: float = ...,
blade_frequency: float | None = ...,
frequencies: NumericArrayLike | None = ...,
) -> HVACSpectrumResult
fan_sound_power(
volume_flow: float,
*,
model: Literal['vdi2081'],
fan_total_pressure_pa: float,
assembly: Literal['rr', 't', 'am'],
fan_speed_rpm: float,
specific_sound_power_level: float | None = ...,
n_blades: int | np.integer[Any] | None = ...,
relative_flow: float = ...,
frequencies: NumericArrayLike | None = ...,
) -> HVACSpectrumResult

Octave-band fan sound power from the operating point, by either method.

Two schools of calculation answer the same question and do not agree on how. model="ashrae" (the default) is the scaling law below; model="vdi2081" is the German method, described after it. Each takes the arguments its own standard is written on, so neither can be handed the other’s: the ASHRAE law scales the static pressure, VDI 2081 the total pressure rise, and confusing them is worth 20 log of the ratio.

The ASHRAE (1987) scaling law, originally due to Beranek and published by Graham (1975):

with the spectral constant K_\mathrm{F} of Long Table 13.5 (one row per fan type), the off-peak efficiency correction C_EFF of Table 13.6 (fan_efficiency_correction) and the blade frequency increment C_BFI of Table 13.7, added to the single octave band that contains the blade passing frequency. In SI the reference volume flow is L/s and the reference pressure Pa, so the two logarithmic terms take the same values as the foot-pound form in cfm and inches of water gauge.

The law assumes ideal inlet and outlet flow conditions and gives the power radiated into the duct; the fan radiates the same power from its intake and from its discharge. Manufacturer data measured to AMCA 300 should be preferred wherever it exists: this model is the early-design fallback, and ASHRAE’s own current guidance (2019 HVAC Applications Handbook, Ch. 49) is that a fan’s sound power “is best obtained from manufacturers’ test data” to AMCA Standard 300 or ASHRAE Standard 68. Long’s worked sheet (Table 14.9) prints a forward-curved row that this equation does not reproduce; see the module warning.

VDI 2081 Part 1:2001-07, Section 4.3. The German method describes a fan by its assembly type rather than by a per-type band table:

Equation (13) and Equation (15). The factor 20 on the pressure is the general of Equation (11) with the Mach number exponent taken as 5, which Section 4.3.2 does for every ventilation fan. The Strouhal number carries no diameter: it cancels between the tip speed and the impeller circumference, so the impeller size a nomogram gives is not an input here. Section 4.3.3 sets the specific level and the spectral parameter for each of the three assemblies of VDI 3731 Part 2, and Figures 13 and 14 add a cubic allowance for running away from the best duty point, worth 0.1 dB at the optimum itself.

Parameters

Name Description
volume_flow Volume flow through the fan Q_\mathrm{F}, m3/s.
fan_static_pressure_pa ASHRAE only. Fan static pressure P_\mathrm{F}, in pascals gauge. This is the pressure rise the fan produces across itself, not an ambient pressure, and it shares neither the unit nor the datum of the static_pressure_kpa the ISO 3740 family takes in kilopascals absolute. No plausibility guard can separate the two: 101 325 Pa is a legitimate duty for a panel or propeller fan, so the name is what keeps them apart.
fan_type ASHRAE only. One of "airfoil_large" / "airfoil_small" (backward-curved or backward-inclined centrifugal wheels above and below 36 in diameter), "forward_curved", "radial_low" / "radial_medium" / "radial_high" (radial blades by total pressure), "vaneaxial_hub_low" / "vaneaxial_hub_medium" / "vaneaxial_hub_high" (hub ratios 0.3-0.4, 0.4-0.6 and 0.6-0.8), "tubeaxial_large" / "tubeaxial_small" (above and below 40 in wheel diameter) or "propeller".
relative_efficiency_percent Static efficiency as a percentage of the peak (default 80, Long’s recommendation when the peak is unknown). Table 13.6 is tabulated from 50 % up, so a fraction such as 0.8 falls through to the table’s bottom row and returns its worst-case 16 dB correction instead of the 6 dB that 80 % earns. That is what HVACWarning says when it fires below the floor.
blade_frequency ASHRAE only. Blade passing frequency f_bp, Hz (from blade_passing_frequency). None (default) places the increment in the octave band Table 13.7 tabulates for the fan type.
model "ashrae" (default) or "vdi2081".
fan_total_pressure_pa VDI 2081 only. Total pressure rise \Delta p_\mathrm{t} across the fan, Pa. Not the static pressure of the ASHRAE law: the total pressure carries the dynamic head as well, and Equation (13) scales it by 20 rather than by 10.
assembly VDI 2081 only. "rr" (radial, rearwards curved blades), "t" (cylindrical rotor, forwards curved blades) or "am" (axial with a downstream diffuser).
fan_speed_rpm VDI 2081 only. Impeller speed n, min^-1.
specific_sound_power_level VDI 2081 only. The specific sound power level L_\mathrm{WSM}, dB. None (default) takes the representative value of the assembly, 34, 36 or 42 dB. Section 4.3.3 says a fan can sit up to 7 dB above its assembly average at the optimum duty point, so a manufacturer’s own value belongs here.
n_blades VDI 2081 only. Number of impeller blades z, which places the blade-frequency allowance of Section 4.3.4 in the octave holding n z / 60. None (default) omits it. The allowance is nought for assemblies RR and T built to the state of the art and 4 dB for AM.
relative_flow VDI 2081 only. Duty as a fraction of the best efficiency point, \dot{V} / \dot{V}_\mathrm{opt} (default 1).
frequencies Octave-band centres, Hz; None (default) uses the eight octave bands from 63 Hz to 8 kHz.

Returns: An HVACSpectrumResult of the band sound power level, dB re 1e-12 W.

Raises

Exception When
TypeError if assembly, fan_type or model is not a text, or blade_frequency, fan_speed_rpm, fan_static_pressure_pa, fan_total_pressure_pa, n_blades, relative_flow, specific_sound_power_level or volume_flow is not a single number, or frequencies holds a text or a value that is not a real number.
flexible_duct_insertion_loss(
frequencies: NumericArrayLike | None,
diameter_m: float,
length: float,
) -> HVACSpectrumResult

Insertion loss of a lined round flexible duct (Long Table 14.4, ASHRAE 1995).

The last run of a supply branch is usually flexible duct: a fabric liner inside a lightweight fibreglass fill inside a plastic membrane. Its published insertion loss is remarkably high, 2 to 3 dB per foot in the mid bands, partly because the test replaces a length of sheet-metal duct and so credits the flexible duct’s breakout as well as its dissipation. That same property makes a serpentine run of flexible duct in an attic or a joist space work as an improvised breakout silencer. The table is interpolated linearly over length and over log diameter; it stops at 4 kHz, so no 8 kHz value is returned.

Parameters

Name Description
frequencies Octave-band centres, Hz, within 63 Hz to 4 kHz; None uses all seven tabulated bands.
diameter_m Internal diameter, m (100 mm to 406 mm tabulated).
length Duct run length, m (0.9 m to 3.7 m tabulated).

Returns: An HVACSpectrumResult of the insertion loss, dB.

Raises

Exception When
TypeError if diameter_m or length is not a single number, or frequencies holds a text or a value that is not a real number.
flow_noise_bend(
frequencies: NumericArrayLike,
flow_velocity: float,
area: float,
height_m: float,
*,
density: float = 1.206,
model: Literal['ashrae', 'vdi2081'] = 'ashrae',
branch_diameter_m: float | None = None,
approach_velocity: float | None = None,
rounding_ratio: float | None = None,
) -> HVACSpectrumResult

Flow-generated octave-band sound power of a bend or junction, by either method.

with the stream power level (Bies Eq. (8.252)) and the Strouhal number (H the duct height in the plane of the bend). The radiated sound power grows as the sixth power of the stream speed at low N_\mathrm{s} (the inner-corner drag dipole) and the eighth power at high N_\mathrm{s} (the outer-corner shear quadrupole); equivalently, the efficiency referenced to the stream power grows as and respectively.

model="vdi2081" is Equation (18) of VDI 2081 Part 1 Section 5.2.2, which covers a junction and a bend with one law:

with the normalised level of Figure 17, , the rounding correction of Figure 18, , and . A bend is the same law with the two velocities equal, which sends the second term of and the velocity ratio to nought.

Both figures state that they hold only for , so a band below that returns negative infinity, the level of no contribution at all, rather than an extrapolation: the fit turns over there and its fractional power of is not real below one.

Parameters

Name Description
frequencies Octave-band centre frequencies f, Hz (1-D array).
flow_velocity Mean flow speed U, m/s.
area Duct cross-sectional area S, m2.
height_m Duct height H in the plane of the bend, m.
density Air density rho, kg/m3.
model "ashrae" (default, Bies) or "vdi2081".
branch_diameter_m VDI 2081 only. Diameter of the branch duct d_a, m; for a bend, the duct’s own diameter.
approach_velocity VDI 2081 only. Flow speed in the main duct ahead of the junction v_h, m/s. None (default) takes it equal to flow_velocity, which is the bend case.
rounding_ratio VDI 2081 only. Rounding radius over branch diameter r / d_a, which applies the correction of Figure 18. None (default) leaves it out altogether, which is how the guideline’s own worked example treats a bend: Figure 18 is drawn for the rounding of a junction, and its curves all cross zero at r / d_a = 0.15, so passing 0 asks for a sharp-cornered junction and is worth over 6 dB rather than nothing. Figure 18 is drawn from 0 to 0.20.

Returns: A HVACSpectrumResult of the band sound power level, dB re 1e-12 W.

Raises

Exception When
TypeError if model is not a text, or area, branch_diameter_m, density, flow_velocity, height_m or rounding_ratio is not a single number, or frequencies holds a text or a value that is not a real number.
flow_noise_straight_duct(
frequencies: NumericArrayLike,
flow_velocity: float,
area: float,
) -> HVACSpectrumResult

Flow-generated octave-band sound power of a straight duct (VDI 2081-1, 5.2.1).

in dB re 1e-12 W, for airflow speed v in a duct of area S. The two halves come from two places on the same page of VDI 2081 Part 1: Equation (16) is the overall level, and the level difference is printed inside Figure 16, whose abscissa is . Bies, Hansen & Howard 5e Eq. (8.251) prints the two as one line and credits the same guideline.

Parameters

Name Description
frequencies Octave-band centre frequencies f_m, Hz (1-D array).
flow_velocity Mean flow speed v in the duct, m/s.
area Duct cross-sectional area S, m2.

Returns: A HVACSpectrumResult of the band sound power level, dB re 1e-12 W.

Raises

Exception When
TypeError if area or flow_velocity is not a single number, or frequencies holds a text or a value that is not a real number.
flow_noise_straight_duct_overall(
flow_velocity: float,
area: float,
*,
weighting: Literal['Z', 'A'] = 'Z',
) -> float

Overall flow-noise sound power of a straight duct (VDI 2081 Part 1, 5.2.1).

Equations (16) and (17): the unweighted overall level and the A-weighted one, in dB re 1e-12 W, for a mean flow speed v in a duct of section S. Neither depends on how long the run is, only on how fast the air moves through how large a section, and the fifth power of the speed in the unweighted form is why halving the duct velocity is worth fifteen decibels.

The two are not one number weighted: fifty times the logarithm is a fifth power of the speed, and seventy is a seventh, because raising the speed also moves the spectrum up into the part of the curve the weighting stops attenuating. Faster air is worse than the unweighted number says.

flow_noise_straight_duct is this level with the relative spectrum of Figure 16 on it. The band levels do not sum back here, and not by a fixed amount either: the difference the figure prints tends to dB as falls, so the energy sum grows with however many octaves are taken. Over the range the figure is drawn for it lands within half a decibel of this number, and outside it the sum means nothing.

Parameters

Name Description
flow_velocity Mean flow speed v in the duct, m/s.
area Duct cross-sectional area S, m2.
weighting "Z" (default) for Equation (16) or "A" for Equation (17).

Returns: The overall sound power level, dB re 1e-12 W.

Raises

Exception When
ValueError If the speed or the area is not positive, or the weighting is neither of the two the guideline prints.
TypeError if weighting is not a text, or area or flow_velocity is not a single number.
HVACSpectrumResult(
frequencies: NDArray[np.float64],
values: NDArray[np.float64],
quantity: Literal['attenuation', 'sound_power_level'],
label: str,
)

A per-frequency HVAC quantity (attenuation or regenerated power level).

Attributes

Name Description
frequencies Frequencies f, Hz.
values The quantity per frequency (dB, or dB re 1e-12 W for a sound power level).
quantity What values holds ("attenuation" or "sound_power_level").
label A short human label of the element.
HVACSpectrumResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the quantity against a continuous log-frequency axis.

Requires matplotlib (the [plot] extra).

Parameters

Name Description
language The language of the labels: "en" or "es".
HVACSpectrumResult.report(
path: str | os.PathLike[str],
*,
metadata: ReportMetadata | None = None,
engine: Literal['reportlab'] = 'reportlab',
verbose: bool = False,
language: Literal['en', 'es'] = 'en',
) -> str

Render an HVAC duct-noise-spectrum fiche to path.

Writes a one-page HVAC-noise sheet: the method-basis line naming the reported quantity and the Bies, Hansen & Howard chapter (Engineering Noise Control 5th ed., Chapter 8), an optional metadata header (client, duct element, test environment, instrumentation, climate, date), a per-band table (nominal frequency and the reported quantity) beside the spectrum, the boxed single-number result (for a regenerated-noise spectrum the A-weighted sound power level L_WA re 1 pW with the overall unweighted total; for an attenuation spectrum the mean attenuation with its band range), an optional verdict row against a declared limit, and a method-basis strip stating the reported quantity’s relation.

Parameters

Name Description
path Destination path of the PDF file.
metadata Optional ReportMetadata supplying the header (client, specimen the duct element, test_room the test environment, instrumentation, temperature_c, relative_humidity_percent, pressure, test_date), the footer identity (laboratory, operator, report_id, notes) and, via requirement, a declared maximum A-weighted sound power level for a regenerated-noise spectrum (lower is better) or a declared minimum mean attenuation for an attenuation spectrum (more is better).
engine Rendering back end; only "reportlab" is supported.
verbose When True a regenerated-noise table adds the A-weighting correction and the A-weighted band level columns.
language Fiche language: "en" (default) or "es".

Returns: The written path as a str.

Raises

Exception When
ValueError If engine is not "reportlab" or language is unknown.
ImportError If reportlab (or, for the figure, matplotlib) is not installed (the [report] extra).

An HVAC input outside the span the table it feeds was tabulated from.

lined_circular_duct_attenuation(
frequencies: NumericArrayLike | None,
diameter_m: float,
length: float,
lining_thickness_m: float,
) -> HVACSpectrumResult

Insertion loss of a lined circular duct (Long Eq. 14.13, Table 14.3).

The Reynolds (1990) third-order regression , with the lining thickness t and the internal diameter d in inches and the length l in feet. It was developed for spiral ducts with a 12 kg/m3 fibreglass lining 25 mm to 76 mm thick behind a 25 per cent open perforated facing, over internal diameters from 150 mm to 1.5 m. Negative regression values are clipped to zero and, as for rectangular ducts, flanking limits the run to 40 dB. The unlined contribution is so small for circular ducts that Long ignores it.

Parameters

Name Description
frequencies Octave-band centres, Hz; None uses the eight octave bands from 63 Hz to 8 kHz.
diameter_m Internal diameter d, m.
length Duct run length l, m.
lining_thickness_m Lining thickness t, m.

Returns: An HVACSpectrumResult of the attenuation, dB.

Raises

Exception When
TypeError if diameter_m, length or lining_thickness_m is not a single number, or frequencies holds a text or a value that is not a real number.
lined_rectangular_duct_attenuation(
frequencies: NumericArrayLike | None,
width_m: float,
height_m: float,
length: float,
lining_thickness_m: float,
*,
include_unlined: bool = False,
) -> HVACSpectrumResult

Insertion loss of a lined rectangular duct (Long Eq. 14.12, Table 14.2).

The Reynolds (1990) regression , with the duct perimeter P in feet, its area S in square feet, the lining thickness t in inches and the run length l in feet. It was fitted to 25 mm to 52 mm linings of 24 to 48 kg/m3 density over P / S from 1.1667 to 6 ft^-1; linings thinner than 25 mm are generally ineffective. The insertion loss is measured by substituting the lined section for an unlined one of the same face size, so the unlined attenuation may be added on top (include_unlined=True, which Long recommends for rectangular ducts). Flanking limits the total to 40 dB.

Parameters

Name Description
frequencies Octave-band centres, Hz; None uses the eight octave bands from 63 Hz to 8 kHz.
width_m Duct width, m.
height_m Duct height, m.
length Duct run length l, m.
lining_thickness_m Lining thickness t, m.
include_unlined Add the unlined-duct attenuation of unlined_rectangular_duct_attenuation, the side-wall contribution the insertion-loss measurement subtracts out.

Returns: An HVACSpectrumResult of the attenuation, dB.

Raises

Exception When
TypeError if height_m, length, lining_thickness_m or width_m is not a single number, or frequencies holds a text or a value that is not a real number.
octave_band_limits(
a_weighted_limit_db: float,
frequencies: NumericArrayLike | None = None,
) -> HVACSpectrumResult

Octave limits from an A-weighted room requirement (VDI 2081 Part 2 Eq. (1)).

with the correction SPECTRAL_CORRECTION, which is the inverse A-weighting less 5 dB. The 5 dB is what Section 1.1 allows for summing eight octave bands: a spectrum flat in A-weighted terms would earn 9 dB, and the guideline takes 5 because the noise of an air-conditioning system does not follow the inverse A curve.

The result is the unweighted octave level each band may reach. The same requirement can be read the other way round, which is what the guideline’s own worked example does: add the A-weighting to the computed spectrum and compare every band against the flat L_A - 5. The two are the same test, since K_A = -A - 5.

Parameters

Name Description
a_weighted_limit_db The A-weighted level the room is required to meet L_A, dB.
frequencies Octave-band centres, Hz; None (default) uses the eight octave bands from 63 Hz to 8 kHz.

Returns: An HVACSpectrumResult of the per-band limit, dB.

Raises

Exception When
TypeError if a_weighted_limit_db is not a single number, or frequencies holds a text or a value that is not a real number.
plenum_attenuation(
exit_area: float,
line_of_sight: float,
wall_area: float,
mean_absorption: float | np.floating[Any] | np.integer[Any],
*,
angle_rad: float = 0.0,
) -> float
plenum_attenuation(
exit_area: float,
line_of_sight: float,
wall_area: float,
mean_absorption: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
angle_rad: float = 0.0,
) -> NDArray[np.float64]
plenum_attenuation(
exit_area: float,
line_of_sight: float,
wall_area: float,
mean_absorption: NumericArrayLike,
*,
angle_rad: float = 0.0,
) -> float | NDArray[np.float64]

Plenum-chamber transmission loss by Wells’ method (Bies Eq. (8.275)).

where the reverberant term uses the plenum room constant (phonometry.room.room_constant). The method holds above the inlet cut-on and when the plenum is large compared with the wavelength; it underpredicts the low-frequency loss by 5-10 dB.

Parameters

Name Description
exit_area Outlet-opening area S_out, m2.
line_of_sight Straight-line inlet-to-outlet distance r, m.
wall_area Total internal wall area S_\mathrm{w}, m2.
mean_absorption Mean Sabine wall absorption alpha in (0, 1) (scalar or per-band).
angle_rad Angle theta between the inlet axis and the line to the outlet, in [0, pi/2] rad (default 0).

Returns: The transmission loss, dB; a float for a number as the mean absorption; a per-band array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError If a dimension is not positive, mean_absorption leaves (0, 1) or angle_rad leaves [0, pi/2].
TypeError if angle_rad, exit_area, line_of_sight or wall_area is not a single number, or mean_absorption holds a text or a value that is not a real number.
plot_plenum_geometry(
exit_area: float,
line_of_sight: float,
wall_area: float,
*,
ax: Axes | None = None,
angle_rad: float = 0.0,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw the plenum-chamber section honouring the acoustic geometry.

The two truly geometric parameters of plenum_attenuation are drawn exactly: the inlet-to-outlet line of sight r and its angle_rad off the inlet axis fix the box; the exit area sets the drawn outlet mouth (square-duct side sqrt(S_out)) and the wall area is annotated.

Parameters

Name Description
exit_area Outlet area S_out, in m2.
line_of_sight Inlet-to-outlet distance r, in metres.
wall_area Total internal wall area S_w, in m2 (annotation).
ax Existing axes, or None to create a figure.
angle_rad Angle between the inlet axis and the line of sight, in radians (0 <= angle < pi/2).
language Label language, "en" (default) or "es".
kwargs Forwarded to the wall-segment plot calls (line properties such as linewidth or color).

Returns: The axes.

Raises

Exception When
ValueError naming the first of the three that is not finite and positive, or for an angle outside [0, pi/2).
TypeError if angle_rad, exit_area, line_of_sight or wall_area is not a single number.
room_effect(
distance: float,
room_constant: float | np.floating[Any] | np.integer[Any],
*,
directivity: float | np.floating[Any] | np.integer[Any] = ...,
) -> float
room_effect(
distance: float,
room_constant: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
*,
directivity: NumericArrayLike = ...,
) -> NDArray[np.float64]
room_effect(
distance: float,
room_constant: float | np.floating[Any] | np.integer[Any],
*,
directivity: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
room_effect(
distance: float,
room_constant: NumericArrayLike,
*,
directivity: NumericArrayLike = ...,
) -> float | NDArray[np.float64]
room_effect(
distance: float,
*,
absorption_area: float | np.floating[Any] | np.integer[Any],
directivity: float | np.floating[Any] | np.integer[Any] = ...,
) -> float
room_effect(
distance: float,
*,
absorption_area: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
directivity: NumericArrayLike = ...,
) -> NDArray[np.float64]
room_effect(
distance: float,
*,
absorption_area: float | np.floating[Any] | np.integer[Any],
directivity: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
room_effect(
distance: float,
*,
absorption_area: NumericArrayLike,
directivity: NumericArrayLike = ...,
) -> float | NDArray[np.float64]

Room effect: the drop from the terminal sound power to the room level.

The last step of a duct-path calculation turns the sound power arriving at the terminal device into a sound pressure level at the listener, through the steady-state room relation (Long Eq. 14.40; Bies Eq. (6.43), phonometry.room.steady_state_spl). This function returns the attenuation, the positive number , so it drops into a duct-path cascade beside every other loss; Long’s worked sheets print it as the negative level change. A ceiling diffuser radiates into a half space, hence the default .

VDI 2081 Blatt 1 Section 6.7.3 closes its own chain with the same expression, written in the equivalent absorption area A rather than the room constant R (Equation (36)), and prints the result as the Raumdämpfung , which is what this returns. The two measures are not interchangeable, so each has its own argument; and the guideline’s directivity comes from a chart against frequency, which is why Q may be given one value per band.

Parameters

Name Description
distance Terminal-to-listener distance r, m.
room_constant Room constant , m2 (scalar or per-band; from phonometry.room.room_constant). Give this or absorption_area, not both.
absorption_area Equivalent absorption area , m2 (scalar or per-band; from phonometry.room.equivalent_absorption_area). Give this or room_constant, not both.
directivity Directivity factor Q of the terminal device (2 flush in a ceiling or wall, 4 at an edge, 8 in a corner), scalar or per-band.

Returns: The room effect as a positive attenuation, dB; a float when the absorption measure and directivity are both numbers; an array of their broadcast shape when one is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError unless exactly one absorption measure is given, or if an argument is not positive and finite.
TypeError if distance is not a single number, or directivity holds a text or a value that is not a real number.
section_change_loss(
frequencies: NumericArrayLike,
upstream_area: float,
downstream_area: float,
*,
shape: Literal['rectangular', 'round'] = 'rectangular',
upstream_size: float | None = None,
speed_of_sound: float = 343.0,
cap: float = 5.0,
) -> HVACSpectrumResult

Reflection at a sudden change of duct section (VDI 2081 Part 1, 6.3).

Figure 26 gives the reduction of the internal sound power level in closed form, for the area ratio :

and it applies differently on the two sides of unity. A sudden reduction () reflects at every frequency; the figure’s own column says the frequency has no effect. A sudden increase () reflects only below the limit frequency of the upstream duct, Equation (33) or (34), and above it the figure gives nought: past that frequency the duct carries more than plane waves and the mismatch stops behaving as one.

A gradual change is not this: 6.3 says that where the transition is smooth, through a tapered adapter long compared with the wavelength, the reduction is negligibly small.

The reduction is reached only with the duct anechoically terminated at both ends, which practice rarely is, so VDI 3733 recommends taking no more than 5 dB from it. That is the default cap, and it binds from an area ratio of about 10.5 upwards, or 0.095 downwards.

There is no ASHRAE counterpart to call through model=: Long folds the reflection from a change of total section into the junction itself, which is what split_loss implements for model="ashrae", while VDI 2081 treats the two as separate elements of the chain.

Parameters

Name Description
frequencies Frequencies f, Hz (1-D array).
upstream_area Section S1 the sound arrives through, m².
downstream_area Section S2 it continues into, m².
shape "rectangular" (default) or "round", which decides which limit-frequency equation the upstream duct takes.
upstream_size The largest side of the upstream duct, m, for a rectangular one; its internal diameter for a round one. Needed only for a sudden increase, which is the only case a limit frequency enters the answer, and only for a rectangular duct, since a round one’s diameter follows from its area. Giving a round duct both is allowed while the two agree.
speed_of_sound Speed of sound c, m/s.
cap The largest reduction to take, dB (default 5).

Returns: An HVACSpectrumResult of the reflection loss, dB.

Raises

Exception When
ValueError If an area, a size, the speed of sound or the cap is not positive, the shape is unknown, a round duct’s size contradicts its area, or a rectangular duct meeting a sudden increase is given no size.
TypeError if shape is not a text, or cap, downstream_area, speed_of_sound, upstream_area or upstream_size is not a single number, or frequencies holds a text or a value that is not a real number.
silencer_self_noise(
frequencies: NumericArrayLike | None,
airway_velocity: float,
n_passages: int | np.integer[Any],
height_m: float,
*,
model: Literal['ashrae', 'vdi2081'] = 'ashrae',
pressure_drop_pa: float | None = None,
approach_area: float | None = None,
airway_width: float | None = None,
) -> HVACSpectrumResult

Regenerated (self) noise of a splitter silencer (Long Eq. 14.31).

Fry’s (1988) estimate, for when manufacturer self-noise data is not available:

with V the velocity in the splitter airway ( m/s), N the number of air passages and H the silencer height or, for a round unit, its circumference ( mm). The octave-band spectrum follows by subtracting the corrections of Table 14.8, which fall steeply above 500 Hz.

The fifth-and-a-half power of the airway velocity is the practical message: doubling the face velocity of a silencer adds about 17 dB, which is how a silencer ends up making the noise it was bought to remove.

Manufacturer self-noise data is measured on a 600 x 600 mm face, so a published spectrum has to be corrected by for the actual face area before it is used; this estimate needs no such correction because the face size enters through N and H.

Parameters

Name Description
frequencies Octave-band centres, Hz; None uses the eight octave bands from 63 Hz to 8 kHz.
airway_velocity Velocity V in the splitter airway, m/s.
n_passages Number of air passages N between the splitters.
height_m Silencer height H (or circumference, if round), m.
model "ashrae" (default, Long Eq. 14.31) or "vdi2081" (Section 7.2.4.2).
pressure_drop_pa VDI 2081 only. Total pressure drop across the silencer, Pa, which Equation (49) takes.
approach_area VDI 2081 only. Frontal area the silencer is approached over S, m2. That is the duct’s whole section, not the clear area between the splitters.
airway_width VDI 2081 only. Clear gap between splitters s, m. The Strouhal number is taken on the hydraulic diameter of that gap, which the guideline’s own worked example computes as 2 s, the parallel-plate limit, rather than as 4 A / P; docs/ERRATA.md records the difference.

Returns: An HVACSpectrumResult of the band sound power level, dB re 1e-12 W.

Raises

Exception When
ValueError If n_passages is not a whole number from 1.
TypeError if model is not a text, airway_velocity, airway_width, approach_area, height_m or pressure_drop_pa is not a single number, or n_passages is a flag, a text or an array where a count goes, or frequencies holds a text or a value that is not a real number.

Constant (numpy.ndarray, shape (8,)).

split_loss(
main_area: float,
branch_areas: NumericArrayLike,
*,
branch: int | np.integer[Any] = 0,
model: Literal['ashrae', 'vdi2081'] = 'ashrae',
) -> float

Power split loss into one branch of a duct division (Long Eq. 14.17).

Where a duct divides, the sound power is shared between the branches in proportion to their areas, and a further reflection occurs when the total branch area does not match the feeder area:

Long prints this as a negative level change (a 25 per cent area split shows as -6 dB in his worked sheet); this function returns it as a positive attenuation, like every other loss in the module.

model="vdi2081" keeps only the second term, which is Equation (35) of VDI 2081 Part 1 Section 6.4:

The two standards divide the same physics differently rather than disagreeing about it. Long folds the reflection from a change of total section into the junction; VDI 2081 treats a junction and a change of section as two elements of the chain, the second in Section 6.3, and its junction is the area split alone. Where the branches happen to sum to the feeder area the two agree; where they do not, the difference is exactly the reflection term, half a decibel in the guideline’s own Table 1 for the junction whose branch areas sum to twice its feeder.

The split is the same in every octave. The German text says so (“frequenzunabhängig”) and Figure 27 has no frequency axis; the English column of the same page says the opposite, which docs/ERRATA.md records.

Parameters

Name Description
main_area Cross-sectional area of the main feeder duct S_m, m2.
branch_areas Areas S_i of the branches continuing on from the main duct, m2 (1-D array-like).
branch Index into branch_areas of the branch being followed.
model "ashrae" (default, Long Eq. 14.17, reflection included) or "vdi2081" (Equation (35), the area split alone).

Returns: The split loss, dB (positive).

Raises

Exception When
ValueError If the areas are not positive or branch is not a whole number in range.
TypeError if model is not a text, main_area is not a single number, or branch is a flag, a text or an array where an index goes, or branch_areas holds a text or a value that is not a real number.
splitter_silencer_insertion_loss(
height_m: float,
length: float,
airway_widths: NumericArrayLike,
splitter_thickness_m: float,
*,
frequencies: NumericArrayLike | None,
) -> HVACSpectrumResult

Insertion loss of a parallel-splitter (dissipative) silencer.

A splitter silencer divides the duct into parallel airways separated by absorbent baffles. Bies, Hansen & Howard (§8.10.5) reduce it to a lined duct: each airway is calculated as a lined duct whose liner thickness is half the splitter thickness, because each face of a splitter lines the airway beside it, and the insertion losses of the airways combine as

which is the energy average over the airways: when they are identical the total equals the loss of a single passage, and when they differ the leakiest airway dominates, exactly as a real unit does. The airway loss itself comes from the Reynolds (1990) lined-rectangular-duct regression of lined_rectangular_duct_attenuation (Long Eq. 14.12), so the same validity envelope applies: linings of 25 mm to 52 mm at 24 to 48 kg/m3 and a perimeter-to-area ratio of the airway between 1.1667 and 6 ft^-1.

Published dynamic insertion loss (DIL) from the silencer manufacturer, measured with the design airflow and in the design direction, should be preferred wherever it exists; this estimate is the early-design fallback and ignores the entrance and exit losses of the unit. The unit’s regenerated noise is a separate quantity, silencer_self_noise.

Parameters

Name Description
frequencies Octave-band centres, Hz; None (default) uses the eight octave bands from 63 Hz to 8 kHz.
height_m Height of the silencer face, m (the airway dimension the splitters do not divide).
length Length of the silencer in the flow direction, m.
airway_widths Free width of each airway between splitters, m (a scalar is taken as a single airway; give one value per airway when they differ).
splitter_thickness_m Full thickness of a splitter baffle, m; the equivalent liner thickness of an airway is half of it.

Returns: An HVACSpectrumResult of the insertion loss, dB.

Raises

Exception When
ValueError If any dimension is not positive, or if airway_widths is not a non-empty 1-D array.
TypeError if splitter_thickness_m is not a single number, or airway_widths or frequencies holds a text or a value that is not a real number.
unlined_circular_duct_attenuation(
frequencies: NumericArrayLike | None,
length: float,
*,
diameter_m: float | None = None,
model: Literal['ashrae', 'vdi2081'] = 'ashrae',
) -> HVACSpectrumResult

Attenuation of an unlined circular sheet-metal duct (Long Table 14.1).

A circular duct is far stiffer than a rectangular one in its breathing mode, so the sound field can hardly excite it: the loss is about a tenth of the rectangular value and is tabulated as a length rate alone, 0.03 dB/ft up to 250 Hz and 0.05 to 0.07 dB/ft above. The published table stops at 4 kHz; the 4 kHz rate is held for the 8 kHz band.

model="vdi2081" reads Table 5 of VDI 2081 Part 1 Section 6.1, which does depend on the diameter: a wide round duct is stiffer still and its tabulated loss falls to nothing at 63 Hz above 400 mm, where the table prints a dash. That is the substantive difference between the two accounts of this element, and it is why diameter_m is required there and not here.

Parameters

Name Description
frequencies Octave-band centres, Hz; None uses the eight octave bands from 63 Hz to 8 kHz.
length Duct run length, m.
diameter_m VDI 2081 only. Internal diameter, m, which selects the Table 5 row. The table stops at 1.00 m.
model "ashrae" (default, Long Table 14.1) or "vdi2081".

Returns: An HVACSpectrumResult of the attenuation, dB.

Raises

Exception When
TypeError if model is not a text, or diameter_m or length is not a single number, or frequencies holds a text or a value that is not a real number.
unlined_rectangular_duct_attenuation(
frequencies: NumericArrayLike,
width_m: float,
height_m: float,
length: float,
*,
wrapped: bool = False,
model: Literal['ashrae', 'vdi2081'] = 'ashrae',
) -> HVACSpectrumResult

Attenuation of an unlined rectangular sheet-metal duct (Long Eqs. 14.9-14.11).

Sound running down an unlined duct loses energy into the induced motion of the duct walls, so the loss grows with the perimeter-to-area ratio P / S (a wide, shallow duct has floppier side walls). Reynolds (1990) fits the 63 Hz to 250 Hz bands with for ft^-1 and below it, and everything above 250 Hz with . An external fibreglass blanket adds surface mass and doubles the low-frequency loss (wrapped=True).

model="vdi2081" reads Table 5 of VDI 2081 Part 1 Section 6.1 instead: a step table in dB per metre, keyed on the largest clear side length and on five frequency columns, 63, 125, 250, 500 and above 1000 Hz. It is a different account of the same loss, not a restatement of this one: Reynolds fits a continuous power law of the perimeter-to-area ratio, VDI 2081 tabulates four size bands of 1 mm steel sheet, and where the two overlap they differ by a decibel or two per metre. wrapped has no meaning there and is refused.

Parameters

Name Description
frequencies Octave-band centre frequencies f, Hz (1-D array).
width_m Duct width, m.
height_m Duct height, m.
length Duct run length l, m.
wrapped The duct is externally wrapped with a fibreglass blanket, which doubles the 63 Hz to 250 Hz attenuation.
model "ashrae" (default, Reynolds) or "vdi2081" (Table 5, the largest side length selecting the row).

Returns: An HVACSpectrumResult of the attenuation, dB.

Raises

Exception When
TypeError if model is not a text, or height_m, length or width_m is not a single number, or frequencies holds a text or a value that is not a real number.