rangeangle
Range and angle calculation
Syntax
Description
The function rangeangle
determines the propagation path length and path
direction of a signal from a source point or set of source points to a reference point.
The function supports two propagation models – the free space model
and the tworay model. The free space model is
a single lineofsight path from a source point to a reference point. The
tworay multipath model generates two paths. The first path
follows the freespace path. The second path is a reflected path off a boundary plane at
z = 0. Path directions are defined with respect to either the
global coordinate system at the reference point or a local coordinate system at the
reference point. Distances and angles at the reference point do not depend upon which
direction the signal is travelling along the path.
[
returns the propagation path length, rng
,ang
]
= rangeangle(pos
)rng
, and direction angles,
ang
, of a signal path from a source point or set of source
points, pos
, to the origin of the global coordinate system. The
direction angles are the azimuth and elevation with respect to the global coordinate
axes at the origin. Signals follow a lineofsight path from the source point to the
origin. The lineofsight path corresponds to the geometric straight line between
the points.
[
also specifies a reference point or set of reference points,
rng
,ang
]
= rangeangle(pos
,refpos
)refpos
. rng
now contains the
propagation path length from the source points to the reference points. The
direction angles are the azimuth and elevation with respect to the global coordinate
axes at the reference points. You can specify multiple points and multiple reference
points.
[
,
also specifies a propagation model. When rng
,ang
]
= rangeangle(___,model
)model
is set to
'freespace'
, the signal propagates along a lineofsight path
from source point to reception point. When model
is set to
'tworay'
, the signal propagates along two paths from source
point to reception point. The first path is the lineofsight path. The second path
is the reflecting path. In this case, the function returns the distances and angles
for two paths for each source point and corresponding reference point.
Input Arguments

Source point position, specified as a realvalued 3by1 vector or a realvalued
3byN matrix. A matrix represents multiple source
points. The columns contain the Cartesian coordinates of
N points in the form
When Position units are meters. 

Reference point position, specified as a realvalued 3by1 vector or a
realvalued 3byN matrix. A matrix represents multiple
reference points. The columns contain the Cartesian coordinates of
N points ins the form
When Position units are meters. Default: 

Local coordinate system axes, specified as a realvalued 3by3 matrix or a
3by3byN array. For an array, each page
corresponds to a local coordinate axes at each reference point. The columns
in Default: 

Propagation model, specified as Default: 
Output Arguments

Propagation range, returned as a realvalued 1byN vector or realvalued 1by2N vector. When When 

Azimuth and elevation angles, returned as a 2byN matrix or
2by2N matrix. Each column represents a direction
angle in the form When When Angle units are in degrees. 