zea.beamform.delays

Delay computation for ultrasound beamforming.

Functions

compute_t0_delays_focused(origins, ...[, ...])	Computes the transmit delays for a focused transmit, shifted such that the first element fires at t=0.
compute_t0_delays_planewave(probe_geometry, ...)	Computes the transmit delays for a planewave, shifted such that the first element fires at t=0.
plot_t0_delays(t0_delays)	Plot the t0_delays for each transducer element.

zea.beamform.delays.compute_t0_delays_focused(origins, focus_distances, probe_geometry, polar_angles, azimuth_angles=None, sound_speed=1540)

Computes the transmit delays for a focused transmit, shifted such that the first element fires at t=0.

Parameters:

• origins (np.ndarray) – The origin of the focused transmit of shape (n_tx, 3,).

• focus_distance (float) – The distance to the focus.

• probe_geometry (np.ndarray) – The positions of the elements in the array of shape (element, 3).

• polar_angles (np.ndarray) – The polar angles of the planewave in radians of shape (n_tx,).

• azimuth_angles (np.ndarray, optional) – The azimuth angles of the planewave in radians of shape (n_tx,).

• sound_speed (float, optional) – The speed of sound. Defaults to 1540.

Returns:

The transmit delays for each element of shape (n_tx, element).

Return type:

np.ndarray

zea.beamform.delays.compute_t0_delays_planewave(probe_geometry, polar_angles, azimuth_angles=0, sound_speed=1540)

Computes the transmit delays for a planewave, shifted such that the first element fires at t=0.

Parameters:

• probe_geometry (np.ndarray) – The positions of the elements in the array of shape (n_el, 3).

• polar_angles (np.ndarray) – The polar angles of the planewave in radians of shape (n_tx,).

• azimuth_angles (np.ndarray, optional) – The azimuth angles of the planewave in radians of shape (n_tx,). Defaults to 0.

• sound_speed (float, optional) – The speed of sound. Defaults to 1540.

Returns:

The transmit delays for each element of shape (n_tx, n_el).

Return type:

np.ndarray

zea.beamform.delays.plot_t0_delays(t0_delays)

Plot the t0_delays for each transducer element.

Elements are on the x-axis, and the t0_delays are on the y-axis. We plot multiple lines for each angle/transmit in the scan object.

Parameters:

t0_delays (np.ndarray) – The t0 delays for each element of shape (n_tx, n_el).