run_ray_trace_v2

HSTB.kluster.modules.svcorrect.run_ray_trace_v2(cast, beam_azimuth, beam_angle, two_way_travel_time, surface_sound_speed, z_waterline_offset, additional_offsets)

Apply the provided sound velocity cast and surface sound speed value to ray trace the angles/traveltime through each layer. We construct cumulative depth/distance/time for each layer and then apply linear interpolation using the provded twowaytraveltime to get the actual alongtrack/acrosstrack/depthoffset for each beam.

Replaces the SoundSpeedProfile method

Parameters
  • cast (list) – list of [depth values, sv values] for this cast

  • beam_azimuth (DataArray) – 2dim (time, beam), beam-wise beam azimuth values relative to vessel heading at time of ping, assume radians

  • beam_angle (DataArray) – 2dim (time, beam) values for beampointingangle at each beam, assume radians

  • two_way_travel_time (DataArray) – 2dim (time, beam) values for the beam two way travel time in seconds

  • surface_sound_speed (DataArray) – 1dim (time) values for surface sound speed in meters per second for each ping

  • z_waterline_offset (float) – offset from transducer to waterline, positive down

  • additional_offsets (list) – list of numpy arrays for [x (time, beam), y (time, beam), z (time, beam)] offsets

Returns

[xarray DataArray (time, along track offset in meters), xarray DataArray (time, across track offset in meters),

xarray DataArray (time, down distance in meters)]

Return type

list