Documentation

This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.

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:

UnitsUnits of AngleOutput Format
'degrees'degreesdecimal degrees
'degrees2dm'degreesdegrees + decimal minutes
'degrees2dms'degreesdegrees + minutes + decimal seconds
'radians'radiansdecimal 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

collapse all

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)

Introduced before R2006a

Was this topic helpful?