# distance

Distance between sites

Since R2019b

## Syntax

``d = distance(site1,site2)``
``d = distance(site1,site2,path)``
``d = distance(___,Name=Value)``

## Description

````d = distance(site1,site2)` returns the distance in meters between `site1` and `site2`.```

example

````d = distance(site1,site2,path)` returns the distance using a specified path type, either a Euclidean or great circle path.```
````d = distance(___,Name=Value)` returns the distance with additional options specified by name-value arguments.```

## Examples

collapse all

Create a transmitter site and a receiver site.

```tx = txsite(Name="MathWorks",Latitude=42.3001,Longitude=-71.3504); rx = rxsite(Name="Fenway Park",Latitude=42.3467,Longitude=-71.0972);```

Get the Euclidean distance in m between the sites.

`dme = distance(tx,rx)`
```dme = 2.1504e+04 ```

Convert the Euclidean distance to km.

`dkm = dme / 1000`
```dkm = 21.5037 ```

Get the great circle distance in m between the sites.

`dmg = distance(tx,rx,"greatcircle")`
```dmg = 2.1451e+04 ```

## Input Arguments

collapse all

Transmitter or receiver site, specified as a `txsite` or `rxsite` object. Specify multiple sites using array inputs.

Measurement path type, specified as one of the following:

• `"euclidean"` — Use the shortest path through space that connects the antenna center positions of the sites.

• `"greatcircle"` — Use the shortest path on the surface of the earth that connects the latitude and longitude locations of the sites. This path uses a spherical Earth model.

Data Types: `char`

### Name-Value Arguments

Specify optional pairs of arguments as `Name1=Value1,...,NameN=ValueN`, where `Name` is the argument name and `Value` is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

Example: `d = distance(site1,site2,Map="myfile.stl")` specifies the map as an STL file.

Before R2021a, use commas to separate each name and value, and enclose `Name` in quotes.

Example: `d = distance(site1,site2,"Map","myfile.stl")` specifies the map as an STL file.

Map for visualization or surface data, specified as a `siteviewer` object, a `triangulation` object, a string scalar, or a character vector. Valid and default values depend on the coordinate system.

Coordinate SystemValid map valuesDefault map value
`"geographic"`
• The current `siteviewer` object or a new `siteviewer` object if none are open

• `"gmted2010"`, if the function is called with an output

`"cartesian"`
• `"none"`

• A `siteviewer` object

• The name of a glTF™ file

• The name of an STL file

• A `triangulation` object

• `"none"`

a Alignment of boundaries and region labels are a presentation of the feature provided by the data vendors and do not imply endorsement by MathWorks®.

In most cases, if you specify this argument as a value other than a `siteviewer` or `"none"`, then you must also specify an output argument.

Data Types: `char` | `string`

## Output Arguments

collapse all

Distance between the sites, returned as an M-by-N numeric array in meters, where M is the number of sites in `site2` and N is the number of sites in `site1`.

## Version History

Introduced in R2019b