airbornegeo.relative_distance

airbornegeo.relative_distance#

relative_distance(data, *, easting_column='easting', northing_column='northing', groupby_column=None)[source]#

Calculate distance between successive points in a dataframe. This assumes the data have been sorted by time, and that there are not flights which overlap in time. If there are, you must first sort by flight, then by time. For example, if you have columns ‘flight’ and ‘unixtime’, you can accomplish this with data = data.sort_values([“flight”, “unixtime”]). If groupby_column is provided, the dataframe will first be grouped by this.

Parameters:

  • data (DataFrame) – Dataframe containing the data.

  • easting_column (str) – name of the column containing the easting coordinates in meters

  • northing_column (str) – name of the column containing the northing coordinates in meters

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

Returns:

Returns a pandas Series of the relative distances which can be assigned to a new column.

Return type:

Series