# underwater.propagation.sound_speed

> One page of the phonometry documentation, as Markdown. Index: https://docs.jmrp.io/phonometry/llms.txt

Canonical: https://docs.jmrp.io/phonometry/reference/api/underwater/sound-speed/
Language: en
Version: phonometry 4.0.0
Install: pip install "phonometry[full]"
Author: José Manuel Requena Plens (https://orcid.org/0000-0003-1250-6212)
Published: 2026-07-15
Updated: 2026-11-11T17:49:24Z
License: MIT (https://github.com/jmrplens/phonometry/blob/main/LICENSE)
Summary: Sound-speed profiles over a column of water.

---

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`](https://docs.jmrp.io/phonometry/reference/api/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

```python
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`](https://docs.jmrp.io/phonometry/reference/api/fluids/water/#sea_water_sound_speed)). One of `"unesco"`, `"del_grosso"`, `"mackenzie"` or `"medwin"`. |
| `latitude` | Latitude for the depth→pressure conversion, in degrees. |

**Returns:** A [`SoundSpeedProfile`](https://docs.jmrp.io/phonometry/reference/api/underwater/sound-speed/#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

```python
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()

```python
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"`. |
