mach.wavefront.plane

mach.wavefront.plane(

origin_m: Real[Array, 'xyz=3'],

points_m: Real[Array, '*points xyz=3'],

direction: Real[Array, 'xyz=3'],

) → Real[Array, '*points']

Plane-wave transmit distance.

Plane-wave transmit is described by its propagation direction and origin-position.

Parameters:

• origin_m – The origin position of the plane-wave in meters.

• points_m – The position of the points to compute the transmit-arrival time for, in meters.

• direction – The direction of the plane-wave. Must be a unit vector. We use direction vector instead of angles because it is less ambiguous.

Returns:

The transmit-wavefront-arrival distance for each point in meters. To convert to time, divide by sound speed: distance_m / sound_speed_m_s

Notes

Does not check for negative distances.