angle

Angle between sites

Syntax

``[az,el] = angle(site1,site2)``
``[az,el] = angle(site1,site2,path)``
``[az,el] = angle(___,Name,Value)``

Description

example

````[az,el] = angle(site1,site2)` returns the azimuth and elevation angles between site 1 and site```

example

````[az,el] = angle(site1,site2,path)` returns the angles using a specified path type, either Euclidean or great circle path.```
````[az,el] = angle(___,Name,Value)` returns the azimuth and elevation angles with additional options specified by name-value pairs.```

Examples

collapse all

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

Get the azimuth and elevation angles between the sites.

`[az,el] = angle(tx,rx)`
```az = 14.0142 ```
```el = -0.2816 ```

Get the azimuth angle between sites in degrees clockwise from north.

```azFromEast = angle(tx,rx); % Unit: degrees counter-clockwise from east azFromNorth = -azFromEast + 90 % Convert angle to clockwise from north```
```azFromNorth = 75.9858 ```

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

Get the azimuth and elevation angles between the sites.

`[az,el] = angle(tx,rx,'greatcircle')`
```az = 14.0635 ```
```el = 0 ```

Input Arguments

collapse all

Transmitter or receiver site, specified as a `txsite` or `rxsite` object. You can use array inputs to specify multiple sites.

Measurement path type, specified as one of the following:

• `'euclidean'`: Uses the shortest path through space connecting the antenna center positions of the site 1 and site 2.

• `'greatcircle'`: Uses the shortest path on the surface of the earth connecting the latitude and longitude locations of site 1 and site 2. This path uses a spherical Earth model.

Data Types: `char`

Name-Value Pair Arguments

Specify optional comma-separated pairs of `Name,Value` arguments. `Name` is the argument name and `Value` is the corresponding value. `Name` must appear inside quotes. You can specify several name and value pair arguments in any order as `Name1,Value1,...,NameN,ValueN`.

Example: `'Map','siteviewer1'`

Map for visualization or surface data, specified as the comma-separated pair consisting of `'Map` and a `siteviewer` object or a terrain name. A terrain name may be specified if the function is called with an output argument. Valid terrain names are `'none'`, `'gmted2010'`, or the name of the custom terrain data added using `addCustomTerrain`. The default value is the current Site Viewer. If no Site Viewer is open, the default value is a new Site Viewer or else `'gmted2010'` if the function is called with an output argument.

Data Types: `char` | `string`

Output Arguments

collapse all

Azimuth angle between site 1 and site 2, returned as M-by-N arrays in degrees. M is the number of sites in sites 2 and N is the number of sites in sites 1. The values range from `-180` to `180`.

Elevation angle between site 1 and site 2, returned as M-by-N arrays in degrees. M is the number of sites in sites 2 and N is the number of sites in sites 1 The values range from `-90` to `90`.

When the path type specified is `'greatcircle'`, elevation angle is always zero.