angl2str
Convert angles to character array
Syntax
str = angl2str(angle)
str = angl2str(angle,signcode)
str = angl2str(angle,signcode,units)
str = angl2str(angle,signcode,units,n)
Description
str = angl2str(angle) converts a numerical
vector of angles in degrees to a character array. The purpose of this
function is to make angular-valued variables into character vectors
suitable for map display.
str = angl2str(angle,signcode) specifies the method for indicating
that a given angle is positive or negative, where signcode is one of
the following:
'ew' | east/west notation; trailing 'e' (positive longitudes) or 'w' (negative longitudes) |
'ns' | north/south notation; trailing 'n' (positive latitudes) or 's' (negative latitudes) |
'pm' | plus/minus notation; leading '+' (positive angles) or '-' (negative angles) |
'none' | blank/minus notation; leading '-' for negative angles or sign omitted for positive angles (the default value) |
str = angl2str(angle,signcode,units) specifies the units and the output
format of the returned angle, using the following values:
| Units | Units of Angle | Output Format |
|---|---|---|
'degrees' | degrees | decimal degrees |
'degrees2dm' | degrees | degrees + decimal minutes |
'degrees2dms' | degrees | degrees + minutes + decimal seconds |
'radians' | radians | decimal radians |
str = angl2str(angle,signcode,units,n) uses the integer
n to control the number of significant digits provided in the
output. n is the power of 10 representing the last place of
significance in the number of degrees, minutes, seconds, or radians -- for
units of 'degrees',
'degrees2dm', 'degrees2dms', and
'radians', respectively. For example, if n =
-2 (the default), angl2str rounds to the nearest
hundredth. If n = -0, angl2str rounds to the
nearest integer. And if n = 1, angl2str rounds
to the tens place, although positive values of n are of little
practical use. Note that this sign convention for n is opposite to
the one used by the MATLAB®
round function.
Examples
Convert Numeric Angles to String Matrix
Create a series of values for angles.
a = -3:1.5:3;
Convert the numeric values in DMS units, using the north-south format.
str = angl2str(a,'ns','degrees2dms',-3)
str = 5x25 char array
' 3^{\circ} 00' 00.000" S '
' 1^{\circ} 30' 00.000" S '
' 0^{\circ} 00' 00.000" '
' 1^{\circ} 30' 00.000" N '
' 3^{\circ} 00' 00.000" N '
These LaTeX strings are displayed (using the text function) as follows:
x = [.1 .1 .1 .1 .1]; y = [.1 .2 .3 .4 .5]; text(x,y,str)
