Engee documentation

Range Angle Calculator

Range and angle calculation.

range angle calculator

Description

The Range Angle Calculator block calculates the range and/or azimuth and elevation angles of several positions relative to the origin and reference directions. The starting direction and reference axes can be set in the parameters of the block or transmitted through the input ports.

Ports

Input

Ref - position of the starting point
real vector-column 3 by 1 | real matrix 3 by N

The position of a source point given as a 3-by-1 real vector or a 3-by-N real matrix, where N is the number of source points. Each column contains the Cartesian coordinates of the point in the form [x;y;z].

If the Pos matrix is 3 by N, then a 3 by N RefPos matrix must be specified for N reference points. If all the reference points are the same, then RefPos can be specified by a single vector 3 by 1. The units are metres.

*Example: [1000;2000;50]

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

RefPos - position of the reference point
`real vector-column 3 by 1 | real matrix 3 by N

The position of a reference point given as a 3-by-1 real vector or a 3-by-N real matrix, where N is the number of reference points. Each column contains the Cartesian coordinates of the point in the form [x;y;z].

If RefPos is a 3-by-N matrix, then Pos must be specified as a 3-by-N matrix for N source points. If all the source points are the same, then Pos can be given as a single 3 by 1 vector. The units of the source position are metres.

*Example: [100;100;10]

Dependencies

To use this port, set the Reference position source parameters to Input port.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

RefAxes - axes of the local coordinate system
`real matrix 3 by 3 | real array 3 by 3 by N

The axes of the local coordinate system given as a 3 by 3 real matrix or a 3 by 3 by N array. For an array, each page corresponds to a local coordinate axis at each datum. The columns in RefAxes specify the direction of the coordinate axes for the local coordinate system in Cartesian coordinates. N must correspond to the number of columns in Pos or RefPos when these dimensions are greater than one.

Example: [100;100;10]

Dependencies

To use this port, set the Reference axes source parameters to Input port.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Output

Ang - angles of azimuth and position
real matrix 2 by N | real matrix 2 by 2N

Azimuth and place angles in degrees, returned as a 2-by-N matrix or a 2-by-2N matrix. Each column represents a direction angle in the form [azimuth;elevation].

If the Propagation model parameters are set to Free space, Ang is a 2 by N matrix and represents the path angle from the source point to the reference point.

If the Propagation model parameters are set to Two-rays, Ang is a 2 by 2N matrix. The alternating Ang columns refer to the path within line of sight and the reflected path, respectively.

Dependencies

To use this port, set the Output(s) parameters to Angle or Range and Angle.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Range - range of propagation
real vector 1 over N | real vector 1 over 2N

The propagation range returned as a real vector 1 by N or a real vector 1 by 2N.

If the Propagation model parameters are set to Free space, the size of the Range is 1 by N. The propagation range is the length of the direct path from the position specified in Pos to the corresponding reference position specified in RefPos.

If the Propagation model parameters are set to Two-ray, Range contains the ranges for the direct and reflected paths. The alternating Range columns refer to the direct and reflected paths, respectively, for the same source-reference pair.

Dependencies

To use this port, set the Output(s) parameters to Range or Range and Angle.

Data types: Float16, Float32, Float64, Int8, Int16, Int32, Int64, UInt8, UInt16, UInt32, UInt64.

Parameters

Propagation model - propagation model
Free space (by default) | `Two-rays `

Specify the distribution model by setting this parameters to Free space or Two-ray.

Reference position source - initial direction source
Property (By default) | Input port

Specify the source of the initial direction by setting this parameters to Property or Input port.

If the Reference position source parameter is set to Property, then set the position using the Reference position parameter. If the Reference position source parameters are set to Input port, then the input port labelled RefPos is used.

Reference position is the initial direction
[0;0;0] (by default).

Set the initial direction as a 3 by 1 rectangular coordinate vector in metres in the form [x;y;z]. The initial direction serves as the origin of the local coordinate system. The ranges and angles of input positions are measured relative to the initial direction.

This parameter is used if the Reference position source parameter is set to Property.

Reference axes source - reference axes source
Property (By default) | Input port.

Define the reference axes source by setting this parameters to Property or Input port.

If the Reference axes source parameter is set to Property, define the axes using the Reference axes parameter. If the Reference axes source parameters are set to Input port, the input port labelled RefAxes is used.

Reference axes - reference axes
[1 0 0;0 1 0;0 0 0 1] (by default).

Set the reference axes of the local coordinate system, by which range and angles are calculated, as a 3 by 3 orthonormalised matrix. Each column of the matrix specifies the axis direction for the local coordinate system as [x; y; z] in the initial direction.

This parameter is used if the Reference axes source parameter is set to Property.

Output(s) - type of output data
Angle (by default) | Range | Range and Angle

Specify the desired output of the block. Depending on the parameters value, each output type is routed to a different port.

Value Port

Angle

Ang

Range

Range

Range and Angle

Ang and Range