georef_by_worker

HSTB.kluster.modules.georeference.georef_by_worker(sv_corr, alt, lon, lat, hdng, heave, wline, vert_ref, input_crs, horizontal_crs, z_offset, vdatum_directory=None, tide_corrector=None)

Use the raw attitude/navigation to transform the vessel relative along/across/down offsets to georeferenced soundings. Will support transformation to geographic and projected coordinate systems and with a vertical reference that you select.

Parameters

  • sv_corr (list) – [x, y, z] offsets generated with sv_correct

  • alt (DataArray) – 1d (time) altitude in meters

  • lon (DataArray) – 1d (time) longitude in degrees

  • lat (DataArray) – 1d (time) latitude in degrees

  • hdng (DataArray) – 1d (time) heading in degrees

  • heave (DataArray) – 1d (time) heave in degrees

  • wline (float) – waterline offset from reference point

  • vert_ref (str) – vertical reference point, one of [‘ellipse’, ‘vessel’, ‘waterline’, ‘NOAA MLLW’, ‘NOAA MHW]

  • input_crs (CRS) – pyproj CRS object, input coordinate reference system information for this run

  • horizontal_crs (CRS) – pyproj CRS object, destination coordinate reference system information for this run

  • z_offset (float) – lever arm from reference point to transmitter

  • vdatum_directory (Optional[str]) – if ‘NOAA MLLW’ ‘NOAA MHW’ is the vertical reference, a path to the vdatum directory is required here

  • tide_corrector (Optional[DataArray]) – if ‘Aviso MLLW’ is the vertical reference, this is the tide correction in meters

Returns

[xr.DataArray easting (time, beam), xr.DataArray northing (time, beam), xr.DataArray depth (time, beam),

xr.DataArray corrected heave for TX - RP lever arm, all zeros if in ‘ellipse’ mode (time), xr.DataArray corrected altitude for TX - RP lever arm, all zeros if in ‘vessel’ or ‘waterline’ mode (time), xr.DataArray VDatum uncertainty if using a VDatum vertical reference, all zeros otherwise, xr.DataArray computed geohash as string encoded base32]

Return type

list