airbornegeo.eotvos_correction

airbornegeo.eotvos_correction#

eotvos_correction(data, *, method='full', latitude_column=None, longitude_column=None, time_column=None, height_column=None, track_column=None, ground_speed_column=None, groupby_column=None, progressbar=True, **kwargs)[source]#

Compute the Eötvös correction with one of several methods.

Methods ‘harlan’, ‘full’ and ‘approx’ take time derivatives of the trajectory, so pass groupby_column (usually the line column) to compute them line by line — computing them across a whole survey at once gives spurious values at the joins between lines.

Parameters:
  • data (DataFrame) – Dataframe containing the columns needed by the chosen method.

  • method (str) – One of ‘full’ (Harlan 1968 full formulation), ‘harlan’ (Harlan 1968 simplified), ‘approx’ (approximated full formulation) or ‘glicken’ (Glicken 1962 simplified equation), by default ‘full’.

  • latitude_column (str | None) – Names of the geodetic latitude/longitude columns in decimal degrees.

  • longitude_column (str | None) – Names of the geodetic latitude/longitude columns in decimal degrees.

  • time_column (str | None) – Name of the column containing time in seconds.

  • height_column (str | None) – Name of the column containing the flight height in meters.

  • track_column (str | None) – Name of the column containing the aircraft track in decimal degrees from geographic north, only used by method ‘glicken’.

  • ground_speed_column (str | None) – Name of the column containing ground speed in meters per second, only used by method ‘glicken’.

  • groupby_column (str | None) – Column name to group by before calculation, by default None.

  • progressbar (bool) – Show a progress bar for each group, by default True.

  • kwargs (Any) – Additional keyword arguments passed to the chosen method’s implementation, e.g. ground_speed=False for method ‘harlan’.

Returns:

Eötvös correction in mGal, with one value per row of data.

Return type:

ndarray[tuple[Any, ...], dtype[TypeVar(_ScalarT, bound= generic)]]