Convert global to local coordinates
lclCoord = global2localcoord(gCoord, OPTION)
gCoord = global2localcoord(___,localOrigin)
gCoord = global2localcoord(___,localAxes)
converts global coordinates
lclCoord = global2localcoord(
gCoord to local coordinates
OPTION determines the type of
global-to-local coordinate transformation. In this syntax, the global coordinate origin
is located at (0,0,0) and the coordinate axes are the unit vectors in the
x, y, and z
Global coordinates in rectangular or spherical coordinate, specified as a 3-by-N matrix. Each column represents one set of global coordinates.
If the coordinates are in rectangular form, each column contains the (x,y,z) components. Units are in meters.
The origin of the global coordinate system is assumed to be located at (0, 0, 0). The global system axes are the standard unit basis vectors in three-dimensional space, (1, 0, 0), (0, 1, 0), and (0, 0, 1).
Type of coordinate transformation, specified as a character vector. Valid types are
Origin of local coordinate system, specified as a
3-by-N matrix containing the rectangular coordinates
of the local coordinate system origin with respect to the global coordinate
system. N must match the number of columns of
Axes of local coordinate system, specified as a
3-by-3-by-N array. Each page contains a 3-by-3 matrix
representing a different local coordinate system axes. The columns of the
3-by-3 matrices specify the local x,
y, and z axes in rectangular form with
respect to the global coordinate system. However, you can specify
Local coordinates in rectangular or spherical coordinate form, returned as a
3-by-N matrix. The dimensions of
Convert global rectangular coordinates, (0,1,0), to local rectangular coordinates. The local coordinate origin is (1,1,1).
lclCoord = global2localcoord([0;1;0],'rr',[1;1;1])
lclCoord = 3×1 -1 0 -1
Convert global spherical coordinates to local rectangular coordinates.
lclCoord = global2localcoord([45;45;50],'sr',[50;50;50])
lclCoord = 3×1 -25.0000 -25.0000 -14.6447
The azimuth angle of a vector is the angle between the x-axis and the orthogonal projection of the vector onto the xy plane. The angle is positive in going from the x axis toward the y axis. Azimuth angles lie between –180 and 180 degrees. The elevation angle is the angle between the vector and its orthogonal projection onto the xy-plane. The angle is positive when going toward the positive z-axis from the xy plane. By default, the boresight direction of an element or array is aligned with the positive x-axis. The boresight direction is the direction of the main lobe of an element or array.
The elevation angle is sometimes defined in the literature as the angle a vector makes with the positive z-axis. The MATLAB® and Communications Toolbox™ products do not use this definition.
This figure illustrates the azimuth and elevation angles of a direction vector.
 Foley, J. D., A. van Dam, S. K. Feiner, and J. F. Hughes. Computer Graphics: Principles and Practice in C, 2nd Ed. Reading, MA: Addison-Wesley, 1995.
Usage notes and limitations:
Does not support variable-size inputs.