Skip to content

underwater.propagation.sound_speed

Sound-speed profiles over a column of water.

A profile is a description of a place rather than of a substance, so it stays with the marchers that consume it while the point state of sea water lives in phonometry.fluids.water. The four sound-speed equations moved there with it; this module builds a column out of them.

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

sound_speed_profile(
depths: NumericArrayLike,
temperatures_c: NumericArrayLike,
salinities: NumericArrayLike,
*,
model: Literal['unesco', 'del_grosso', 'mackenzie', 'medwin'] = 'unesco',
latitude: float = 45.0,
) -> SoundSpeedProfile

Evaluate a sound-speed profile over a depth column.

Parameters

Name Description
depths Depths, in metres (1-D, non-negative, increasing).
temperatures_c Temperature per depth, in °C (array or a scalar broadcast to every depth).
salinities Salinity per depth, in PSU (array or scalar).
model Sound-speed equation (see sea_water_sound_speed). One of "unesco", "del_grosso", "mackenzie" or "medwin".
latitude Latitude for the depth→pressure conversion, in degrees.

Returns: A SoundSpeedProfile.

Raises

Exception When
ValueError If the inputs are invalid.
TypeError if model is not a text, or depths, salinities or temperatures_c holds a text or a value that is not a real number.
SoundSpeedProfile(
depths: NDArray[np.float64],
speeds_of_sound: NDArray[np.float64],
gradient_per_s: NDArray[np.float64],
model: Literal['unesco', 'del_grosso', 'mackenzie', 'medwin'],
)

Sound-speed profile c(z) over a column of water.

Attributes

Name Description
depths Depths, in metres (increasing downward).
speeds_of_sound Sound speed at each depth, in m/s.
gradient_per_s Vertical sound-speed gradient dc/dz, in (m/s)/m.
model The equation used. One of "unesco", "del_grosso", "mackenzie" or "medwin".
SoundSpeedProfile.plot(
ax: Axes | None = None,
*,
language: Literal['en', 'es'] = 'en',
**kwargs: Any,
) -> Axes

Plot the sound-speed profile (speed vs depth, depth increasing down).

Parameters

Name Description
language The language of the labels: "en" or "es".