distance

Compute total distance traveled for data stored in GPS data object

Since R2024b

Syntax

traveledDistance = distance(gpsData)

Description

Add-On Required: This feature requires the Scenario Builder for Automated Driving Toolbox add-on.

traveledDistance = distance(gpsData) returns the total distance traveled, in meters, for data stored in the GPS data object gpsData.

Examples

Compute Traveled Distance of GPS Data Object

Load recorded GPS data into the workspace.

load("recordedGPSData.mat")

Initialize a GPSData object by using information from the loaded GPS data.

gpsData = scenariobuilder.GPSData(timestamps,latitudes,longitudes,altitudes)

gpsData = 
  GPSData with properties:

          Name: ''

    NumSamples: 392
      Duration: 19.5498
    SampleRate: 20.0513
    SampleTime: 0.0500
    Timestamps: [392×1 double]

      Latitude: [392×1 single]
     Longitude: [392×1 single]
      Altitude: [392×1 single]

    Attributes: []

Plot the waypoints in the GPS data object.

plot(gpsData)

Compute the total traveled distance, as recorded in the GPS data object. Units are in meters.

traveledDistance = distance(gpsData)

traveledDistance = single

373.3607

Input Arguments

gpsData — GPS data

GPSData object

GPS data, specified as a GPSData object.

Output Arguments

traveledDistance — Total distance traveled

positive scalar

Total distance traveled for data stored in the GPS data object, returned as a scalar. Units are in meters. The function uses the Haversine formula to compute piecewise distance between consecutive world points. For more information, see Haversine Distance.

Data Types: single

Algorithms

The function uses the Haversine formula to compute the distance between two world points specified as (lat₁, lon₁) and (lat₂, lon₂). The Haversine distance is calculated as:

distance = R*2*atan2(sqrt(A),sqrt(1-A)),

where, the value of R is 6,378,137 meters, which specifies the radius of the Earth, and A is computed as:

$$A=\sin {\left(\frac{la{t}_2-la{t}_1}{2}\right)}^2+\cos (la{t}_1)\times \cos (la{t}_2)\times \sin {\left(\frac{lo{n}_2-lo{n}_1}{2}\right)}^2$$

Version History

Introduced in R2024b