Ir al contenido

materials.absorbers.impedance_tube

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.

Two-microphone transfer-function method in the impedance tube.

BS EN ISO 10534-2:2001: the complex reflection factor r at the sample surface is obtained from the measured transfer function H12 between two microphones flush-mounted in the wall of a tube terminated by the specimen, and from it the surface impedance and the normal-incidence absorption coefficient (Clause 7, Eqs. (17)-(20)). Time convention ; the incident wave carries and the reflected wave (Annex D, Eqs. (D.1)-(D.8)). The complex wavenumber is with the attenuation constant (Clause 2.6, Annex A). Air properties from Clause 7.2, Eqs. (5)/(7), use temperature in kelvin.

The tube itself is described here as well (its cross-section, the hydraulic diameter a rectangular tube reports, the complex wavenumber, the lower-bound wall attenuation and the plane-wave working range), because a specimen is characterised only where the field in the tube is a plane wave, and because the four-microphone method measures in the same tube and reuses that arithmetic.

The other two standardised impedance-tube methods are their own modules, each kept in its own sign convention (they are not interchangeable): standing_wave for the probe-traverse standing-wave-ratio method of BS EN ISO 10534-1:2001, and four_microphone for the transmission transfer-matrix method of ASTM E2611-19, whose air properties are given in degrees Celsius and whose forward wave carries the opposite exponent sign.

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

absorption_from_reflection(reflection: complex | np.number[Any]) -> float
absorption_from_reflection(
reflection: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.float64]
absorption_from_reflection(
reflection: NumericArrayLike,
) -> float | NDArray[np.float64]

Normal-incidence absorption coefficient (ISO 10534-2, Eq. (18)).

. This form is shared with ISO 10534-1 Eq. (9) and ASTM E2611-19 Eq. (28).

Parameters

Name Description
reflection Complex reflection factor r.

Returns: Absorption coefficient alpha (real). A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if reflection holds a text or a value that is not a number.
air_density_iso10534(
*,
temperature_c: float | np.floating[Any] | np.integer[Any],
static_pressure_kpa: float | np.floating[Any] | np.integer[Any] = ...,
) -> float
air_density_iso10534(
*,
temperature_c: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
static_pressure_kpa: NumericArrayLike = ...,
) -> NDArray[np.float64]
air_density_iso10534(
*,
temperature_c: float | np.floating[Any] | np.integer[Any],
static_pressure_kpa: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
air_density_iso10534(
*,
temperature_c: NumericArrayLike,
static_pressure_kpa: NumericArrayLike = ...,
) -> float | NDArray[np.float64]

Air density (ISO 10534-2:2001, Eq. (7)).

with kg/m3, K and kPa, and in kelvin.

Parameters

Name Description
temperature_c Air temperature, in degrees Celsius.
static_pressure_kpa Atmospheric pressure pa, in kilopascals (default 101.325 kPa).

Returns: Air density rho, in kilograms per cubic metre. A float when temperature_c and static_pressure_kpa are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError if any temperature is at or below -273.15 degC, or any pressure is not positive.
TypeError if static_pressure_kpa or temperature_c holds a text or a value that is not a real number.
apply_microphone_calibration(
h12_uncorrected: complex | np.number[Any],
calibration_factor: complex | np.number[Any],
) -> complex
apply_microphone_calibration(
h12_uncorrected: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
calibration_factor: NumericArrayLike,
) -> NDArray[np.complex128]
apply_microphone_calibration(
h12_uncorrected: complex | np.number[Any],
calibration_factor: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.complex128]
apply_microphone_calibration(
h12_uncorrected: NumericArrayLike,
calibration_factor: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Apply the microphone calibration factor (ISO 10534-2, Eq. (13)).

.

Parameters

Name Description
h12_uncorrected Uncorrected measured transfer function.
calibration_factor Calibration factor Hc from microphone_calibration_factor.

Returns: Corrected transfer function H12. A complex when h12_uncorrected and calibration_factor are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if calibration_factor or h12_uncorrected holds a text or a value that is not a number.
hydraulic_diameter(width_m: float, height_m: float) -> float

Hydraulic diameter of a rectangular tube, (ISO 10534-2, A.2.1.5).

For a rectangular cross-section of side lengths w and h the ratio of four times the area to the perimeter reduces to ; a square tube gives d_h equal to the side length. This is the d the Eq. (A.18) attenuation estimate expects for rectangular tubes (see tube_attenuation_constant).

Parameters

Name Description
width_m Inner side length w, in metres.
height_m Inner side length h, in metres.

Returns: Hydraulic diameter , in metres.

Raises

Exception When
TypeError if height_m or width_m is not a single number.
ImpedanceTubeResult(
frequencies: NDArray[np.float64],
reflection: NDArray[np.complex128],
surface_impedance: NDArray[np.complex128],
normalized_impedance: NDArray[np.complex128],
absorption: NDArray[np.float64],
*,
spacing_m: float,
x1: float,
diameter_m: float | None = None,
shape: Literal['circular', 'rectangular', 'square'] | None = None,
)

Two-microphone impedance-tube result (ISO 10534-2:2001).

All arrays share the shape of frequencies. reflection is the complex reflection factor r at the sample surface (Eq. (17)), surface_impedance the absolute surface impedance Z in rayls (Eq. (19)), normalized_impedance the ratio (Eq. (19)) and absorption the normal-incidence coefficient (Eq. (18)).

The trailing fields retain the tube geometry the reduction was run with (microphone spacing_m s, distance x1 from the sample to the farther microphone, tube diameter_m and cross-section shape, stored canonically as "circular"/"rectangular"; a "square" input is kept as "rectangular"). The diameter and the shape are None when they were not supplied to two_microphone_impedance; the spacing and x1 are always there, because the reduction cannot run without them.

Attributes

Name Description
shape One of "circular", "rectangular" or "square".
ImpedanceTubeResult.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the absorption spectrum alpha(f) with |r| overlaid.

Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
language The language of the labels: "en" or "es".
ImpedanceTubeResult.plot_geometry(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw the two-microphone tube to scale (dimensioned side view).

Requires matplotlib (the [plot] extra); returns the Axes.

Parameters

Name Description
language The language of the labels: "en" or "es".
ImpedanceTubeResult.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 ISO 10534-2 impedance-tube test-report fiche to a PDF.

Writes a one-page accredited normal-incidence report (BS EN ISO 10534-2:2001, two-microphone transfer-function method): the standard-basis line, an optional metadata header block (client, specimen, tube diameter d, microphone spacing s, the measured frequency range, mounting, climate …), a two-panel body with the per-frequency table (frequency, absorption alpha and the real/imaginary parts of the normalised surface impedance ) beside the alpha(f) curve, and a footer with the fixed disclaimer. ISO 10534-2 is a characterisation, so there is no pass/fail verdict and no single-number rating (the random-incidence weighted alpha_w is an ISO 11654 / ISO 354 quantity, not comparable to the normal-incidence coefficient reported here).

Parameters

Name Description
path Destination path of the PDF file.
metadata Optional ReportMetadata; None produces a body-and-disclaimer fiche whose header shows only the measured frequency range. The applicable descriptive/geometric fields are client, manufacturer, specimen, tube_diameter_m, tube_shape, microphone_spacing_m, mounting, test_room, test_date, temperature_c, static_pressure_kpa, measurement_standard, laboratory, operator, report_id and notes. The requirement field is ignored (ISO 10534-2 has no verdict).
engine Rendering back end; only "reportlab" is supported.
verbose When True, the value table inserts the reflection-factor magnitude |r| column.
language Fiche language: "en" (default, English, decimal point) or "es" (Spanish, decimal comma).

Returns: The written path as a str.

Raises

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

Advisory for out-of-plane-wave-range impedance-tube frequencies.

microphone_calibration_factor(
h12_config1: complex | np.number[Any],
h12_config2: complex | np.number[Any],
) -> complex
microphone_calibration_factor(
h12_config1: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
h12_config2: NumericArrayLike,
) -> NDArray[np.complex128]
microphone_calibration_factor(
h12_config1: complex | np.number[Any],
h12_config2: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.complex128]
microphone_calibration_factor(
h12_config1: NumericArrayLike,
h12_config2: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Microphone-mismatch calibration factor Hc (ISO 10534-2, Eq. (10)).

from a transfer function measured on an absorptive specimen in the standard configuration (I) and with the two microphones physically interchanged (II); the cabling to the analyser is not swapped (Clause 7.5.2).

Parameters

Name Description
h12_config1 Transfer function H12^I in the standard configuration.
h12_config2 Transfer function H12^II with microphones swapped.

Returns: Complex calibration factor Hc. A complex when h12_config1 and h12_config2 are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if h12_config1 or h12_config2 holds a text or a value that is not a number.
normalized_surface_admittance(
reflection: complex | np.number[Any],
) -> complex
normalized_surface_admittance(
reflection: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.complex128]
normalized_surface_admittance(
reflection: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Normalised surface admittance (ISO 10534-2, Eq. (20)).

.

Parameters

Name Description
reflection Complex reflection factor r.

Returns: Normalised surface admittance (complex). A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if reflection holds a text or a value that is not a number.
normalized_surface_impedance(
reflection: complex | np.number[Any],
) -> complex
normalized_surface_impedance(
reflection: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.complex128]
normalized_surface_impedance(
reflection: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Normalised surface impedance (ISO 10534-2, Eq. (19)).

.

Parameters

Name Description
reflection Complex reflection factor r.

Returns: Normalised surface impedance (complex). A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if reflection holds a text or a value that is not a number.
plane_wave_frequency_range(
spacing_m: float,
speed_of_sound: float,
*,
diameter_m: float | None = None,
shape: Literal['circular', 'rectangular', 'square'] = 'circular',
) -> tuple[float, float]

Working plane-wave frequency range (f_l, f_u) (ISO 10534-2, 4.2-4.5).

The upper limit is the smaller of the microphone-spacing bound (Eq. (4)) and, when the tube diameter_m is given, the cut-on bound for a circular tube (Eq. (2)) or for a rectangular tube (Eq. (3)). The lower limit uses the Clause 4.2 guideline that the spacing exceed 5 % of the wavelength, i.e. .

Parameters

Name Description
spacing_m Microphone spacing s, in metres.
speed_of_sound Speed of sound c0, in metres per second.
diameter_m Tube diameter (circular) or maximum lateral dimension (rectangular/square) d, in metres; None applies only the spacing bound.
shape "circular", "rectangular" or "square" (a square tube is the rectangular bound with d the side length).

Returns: Tuple (f_l, f_u) of the lower and upper frequency limits, in Hz.

Raises

Exception When
TypeError if diameter_m, spacing_m or speed_of_sound is not a single number, or shape is not a text.
plot_impedance_tube_geometry(
*,
ax: Axes | None = None,
spacing_m: float,
x1: float,
diameter_m: float | None = None,
shape: Literal['circular', 'rectangular', 'square'] | None = 'circular',
sample_thickness_m: float | None = None,
speed_of_sound: float = 343.2,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw the ISO 10534-2 two-microphone tube to scale.

Side view: loudspeaker at the left (three tube diameters before the farther microphone, the Clause 4.3 margin), the two flush microphones at x1 and x1 - s from the sample face, the sample against its rigid backing at the right, the cross-section emblem, and the plane-wave working range of plane_wave_frequency_range.

Parameters

Name Description
ax Existing axes, or None to create a figure.
spacing_m Microphone spacing s, in metres.
x1 Distance from the sample face to the farther microphone, in metres.
diameter_m Inner diameter (circular) or lateral dimension (rectangular/square), in metres; None draws a nominal bore and omits the bore dimension and the cut-on bound.
shape "circular", "rectangular", "square" or None.
sample_thickness_m Drawn sample thickness, in metres; None draws a 50 mm nominal sample.
speed_of_sound Speed of sound for the working range, in m/s.
language Label language, "en" (default) or "es".
kwargs Forwarded to the tube-bore rectangle.

Returns: The axes.

Raises

Exception When
ValueError for a spacing, distance, diameter or sample thickness that is not finite and positive, or an x1 no greater than the spacing.
TypeError if diameter_m, sample_thickness_m, spacing_m or x1 is not a single number, or shape is not a text.
plot_transmission_tube_geometry(
*,
ax: Axes | None = None,
l1: float,
s1: float,
l2: float,
s2: float,
thickness_m: float,
diameter_m: float | None = None,
shape: Literal['circular', 'rectangular', 'square'] | None = 'circular',
speed_of_sound: float = 343.2,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Draw the ASTM E2611 four-microphone transmission tube to scale.

Side view: loudspeaker, the two upstream microphones at l1 and l1 + s1 from the front face of the specimen, the specimen spanning its thickness, the two downstream microphones at l2 and l2 + s2 (measured from the front face, the module’s locked convention), and the changeable termination of the two-load method, with the ASTM working range of plane_wave_frequency_range_astm_e2611.

Parameters

Name Description
ax Existing axes, or None to create a figure.
l1 Front face to the nearer upstream microphone, in metres.
s1 Upstream microphone spacing, in metres.
l2 Front face to the nearer downstream microphone, in metres.
s2 Downstream microphone spacing, in metres.
thickness_m Specimen thickness, in metres; must be smaller than l2 (the downstream microphones sit past the back face).
diameter_m Inner diameter (circular) or largest section dimension (rectangular/square), in metres; None draws a nominal bore and omits the bore dimension and the cut-on bound.
shape "circular", "rectangular", "square" or None.
speed_of_sound Speed of sound for the working range, in m/s.
language Label language, "en" (default) or "es".
kwargs Forwarded to the tube-bore rectangle.

Returns: The axes.

Raises

Exception When
ValueError naming the first length or diameter that is not finite and positive, or an l2 no greater than the thickness.
TypeError if diameter_m, l2 or thickness_m is not a single number, or shape is not a text.
reflection_factor(
h12: complex | np.number[Any],
*,
spacing_m: float,
x1: float,
wavenumber: complex | np.number[Any],
) -> complex
reflection_factor(
h12: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
*,
spacing_m: float,
x1: float,
wavenumber: NumericArrayLike,
) -> NDArray[np.complex128]
reflection_factor(
h12: complex | np.number[Any],
*,
spacing_m: float,
x1: float,
wavenumber: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
) -> NDArray[np.complex128]
reflection_factor(
h12: NumericArrayLike,
*,
spacing_m: float,
x1: float,
wavenumber: NumericArrayLike,
) -> complex | NDArray[np.complex128]

Complex reflection factor at the sample surface (ISO 10534-2, Eq. (17)).

with the incident- and reflected-wave transfer functions (Eq. (D.5)) and (Eq. (D.6)), s the microphone spacing and x1 the distance from the sample to the farther microphone (Clause 7.7).

Parameters

Name Description
h12 Measured transfer function H12 between microphone positions 1 and 2 (Clause 7.6, Eq. (14)); complex, scalar or per band. It must already be corrected for microphone mismatch (see apply_microphone_calibration).
spacing_m Microphone spacing , in metres.
x1 Distance from the sample surface to the farther microphone (position 1), in metres.
wavenumber Complex wavenumber k0 (from tube_wavenumber), scalar or per band.

Returns: Complex reflection factor r at the reference plane. A complex when h12 and wavenumber are both numbers, an array when either is a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if spacing_m or x1 is not a single number, or h12 or wavenumber holds a text or a value that is not a number.
speed_of_sound_iso10534(
*,
temperature_c: float | np.floating[Any] | np.integer[Any],
) -> float
speed_of_sound_iso10534(
*,
temperature_c: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
) -> NDArray[np.float64]
speed_of_sound_iso10534(
*,
temperature_c: NumericArrayLike,
) -> float | NDArray[np.float64]

Speed of sound in air (ISO 10534-2:2001, Eq. (5)).

, with in kelvin.

Parameters

Name Description
temperature_c Air temperature, in degrees Celsius.

Returns: Speed of sound c0, in metres per second. A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
ValueError if any temperature is at or below -273.15 degC.
TypeError if temperature_c holds a text or a value that is not a real number.
surface_impedance(
reflection: complex | np.number[Any],
characteristic_impedance: float,
) -> complex
surface_impedance(
reflection: Sequence[complex] | Sequence[np.number[Any]] | NDArray[np.bool_ | np.number[Any]],
characteristic_impedance: float,
) -> NDArray[np.complex128]
surface_impedance(
reflection: NumericArrayLike,
characteristic_impedance: float,
) -> complex | NDArray[np.complex128]

Absolute surface impedance Z (ISO 10534-2, Eq. (19)).

.

Parameters

Name Description
reflection Complex reflection factor r.
characteristic_impedance Characteristic impedance of air rho c0, in rayls (rho and c0 from the Clause 7.2 helpers).

Returns: Surface impedance Z, in rayls (complex). A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if characteristic_impedance is not a single number.
tube_attenuation_constant(
frequency: float | np.floating[Any] | np.integer[Any],
speed_of_sound: float,
diameter_m: float,
) -> float
tube_attenuation_constant(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
speed_of_sound: float,
diameter_m: float,
) -> NDArray[np.float64]
tube_attenuation_constant(
frequency: NumericArrayLike,
speed_of_sound: float,
diameter_m: float,
) -> float | NDArray[np.float64]

Lower-bound tube attenuation constant k0'' (ISO 10534-2, Eq. (A.18)).

(nepers per metre). This ignores porous-wall and object losses and is therefore a lower limit (Clause A.2.1.5).

Parameters

Name Description
frequency Frequency f, in hertz (scalar or per band).
speed_of_sound Speed of sound c0, in metres per second.
diameter_m Circular-tube diameter d, in metres, or the hydraulic diameter 4 * area / perimeter for a rectangular tube (see hydraulic_diameter).

Returns: Attenuation constant k0'', in nepers per metre. A float for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if diameter_m or speed_of_sound is not a single number, or frequency holds a text or a value that is not a real number.
tube_wavenumber(
frequency: float | np.floating[Any] | np.integer[Any],
speed_of_sound: float,
*,
attenuation_np_per_m: NumericArrayLike | None = ...,
) -> complex
tube_wavenumber(
frequency: Sequence[float] | Sequence[np.floating[Any]] | Sequence[np.integer[Any]] | NDArray[np.bool_ | np.integer[Any] | np.floating[Any]],
speed_of_sound: float,
*,
attenuation_np_per_m: NumericArrayLike | None = ...,
) -> NDArray[np.complex128]
tube_wavenumber(
frequency: NumericArrayLike,
speed_of_sound: float,
*,
attenuation_np_per_m: NumericArrayLike | None = ...,
) -> complex | NDArray[np.complex128]

Complex wavenumber (ISO 10534-2, Clause 2.6).

The real part is (Eq. (2)); the optional attenuation constant k0'' enters with a minus sign on the imaginary part (Clause 2.6 NOTE, Eq. (A.1)).

Parameters

Name Description
frequency Frequency f, in hertz (scalar or per band).
speed_of_sound Speed of sound c0, in metres per second.
attenuation_np_per_m Attenuation constant k0'', in nepers per metre (scalar or matching frequency); None gives the lossless real wavenumber. Obtain a lower-bound estimate from tube_attenuation_constant.

Returns: Complex wavenumber k0, in reciprocal metres. A complex for a number, an array for a sequence or an array, a zero-dimensional one included.

Raises

Exception When
TypeError if speed_of_sound is not a single number, or attenuation_np_per_m or frequency holds a text or a value that is not a real number.
two_microphone_impedance(
h12: NumericArrayLike,
*,
frequency: NumericArrayLike,
spacing_m: float,
x1: float,
speed_of_sound: float,
characteristic_impedance: float,
attenuation_np_per_m: NumericArrayLike | None = None,
diameter_m: float | None = None,
shape: Literal['circular', 'rectangular', 'square'] = 'circular',
) -> ImpedanceTubeResult

Full two-microphone reduction (ISO 10534-2:2001, Clause 7).

Builds the complex wavenumber (Clause 2.6), the reflection factor (Eq. (17)), the surface impedance (Eq. (19)) and the absorption coefficient (Eq. (18)) from the measured transfer function H12. When diameter_m is supplied, frequencies outside the plane-wave range (Eqs. (1)-(4)) raise an ImpedanceTubeWarning; the results are still returned.

Parameters

Name Description
h12 Measured (mismatch-corrected) transfer function H12.
frequency Frequency f, in hertz (scalar or array).
spacing_m Microphone spacing s, in metres.
x1 Distance from the sample to the farther microphone, in metres.
speed_of_sound Speed of sound c0, in m/s (see speed_of_sound_iso10534).
characteristic_impedance Characteristic impedance rho c0, in rayls.
attenuation_np_per_m Optional tube attenuation constant k0'', in nepers/m (see tube_attenuation_constant).
diameter_m Optional tube diameter/lateral dimension, in metres, that activates the plane-wave range check.
shape Tube cross-section, "circular", "rectangular" or "square".

Returns: An ImpedanceTubeResult (the tube geometry is retained on the result).

Raises

Exception When
TypeError if shape is not a text, or frequency holds a text or a value that is not a real number, or h12 holds a text or a value that is not a number.