angl2str

Convert angles to character array

collapse all in page

    Syntax

    str = angl2str(angles)
    str = angl2str(angles,signcode)
    str = angl2str(angles,signcode,format)
    str = angl2str(angles,signcode,format,n)

    Description

    str = angl2str(angles) converts numeric angles in degrees to a character array that represents the angles. This function is useful for displaying angles as text on maps.

    example

    str = angl2str(angles,signcode) returns a character array that represents the angles using the signs or directions specified by signcode.

    example

    str = angl2str(angles,signcode,format) returns a character array that formats the angles as degrees, degrees-minutes, degrees-minutes-seconds, or radians. The function does not convert degrees to radians or vice-versa.

    example

    str = angl2str(angles,signcode,format,n) specifies the number of decimal places to use in the character array.

    example

    Examples

    collapse all

    Open Live Script

    Convert numeric angles to a character array. By default, the angl2str function formats the angles as degrees.

    angles = [-9.7 12.95 24];
str = angl2str(angles)
    str = 3×16 char array
    ' - 9.70^{\circ} '
    '  12.95^{\circ} '
    '  24.00^{\circ} '

    Convert the same angles to a character array and prefix a plus sign (+) to the positive angles.

    strPlus = angl2str(angles,"pm")
    strPlus = 3×16 char array
    ' - 9.70^{\circ} '
    ' +12.95^{\circ} '
    ' +24.00^{\circ} '
    Open Live Script

    Convert the coordinates of Washington, DC to a character array that uses degrees-minutes. Remove the leading and trailing whitespaces.

    lat = 38.9072;
lon = -77.0369;

latStr = angl2str(lat,"ns","degrees2dm");
latStr = strtrim(latStr);

lonStr = angl2str(lon,"ew","degrees2dm");
lonStr = strtrim(lonStr);

coordStr = "(" + latStr + ", " + lonStr + ")";

    Display the location and character array on a terrain map.

    geobasemap colorterrain
geoscatter(lat,lon,"filled")
text(lat,lon,coordStr,VerticalAlignment="top")

    Open Live Script

    Convert angles in degrees to a character array. Round the angles to the nearest tenth.

    angles = [8.523 -34.79 -89];
str = angl2str(angles,"none","degrees",-1)
    str = 3×15 char array
    '   8.5^{\circ} '
    ' -34.8^{\circ} '
    ' -89.0^{\circ} '

    Input Arguments

    collapse all

    Angles in degrees or radians, specified as a numeric array.

    Signs or directions to use in the character array, specified as one of these options:

    • "ew" — Input angles are longitudes. The character array indicates positive longitudes using E and negative longitudes using W.

    • "ns" — Input angles are latitudes. The character array indicates positive latitudes using N and negative latitudes using S.

    • "pm" — The character array indicates positive angles using a plus sign (+) and negative angles using a minus sign (-).

    • "none" — The character array indicates negative angles using a minus sign (-) and does not use a plus sign (+) for positive angles.

    Data Types: char | string

    Format to use in the character array, specified as one of these options.

    OptionFormatExample
    "degrees"Degrees 
    angl2str(31.26,"none","degrees")
    ans =

    ' 31.26^{\circ} '
    "degrees2dm"Degrees-minutes (DM) 
    angl2str(31.26,"none","degrees2dm")
    ans =

    ' 31^{\circ} 15.60' '
    "degrees2dms"Degrees-minutes-seconds (DMS) 
    angl2str(31.26,"none","degrees2dms")
    ans =

    ' 31^{\circ} 15' 36.00" '
    "radians"Radians 
    angl2str(pi/6,"none","radians",-5)
    ans =

    ' 0.52360 R '

    The value ^{\circ} is the LaTeX representation of °.

    Data Types: char | string

    Number of digits to include in the character array, specified as an integer. When you specify n, the angl2str function rounds angles to the nearest multiple of 10n.

    The sign convention for this argument is opposite to the one used by the round function.

    Example: angl2str(31.467,"none","degrees",-2) returns ' 31.47^{\circ} ', which is 31.467 rounded to the nearest hundredth.

    Example: angl2str(31.467,"none","degrees",0) returns ' 31^{\circ} ', which is 31.467 rounded to the nearest integer.

    Output Arguments

    collapse all

    Text representation of the input angles, returned as a character array.

    Data Types: char

    Version History

    Introduced before R2006a

    See Also

    Functions

    Topics