Documentation

This is machine translation

Translated by Microsoft
Mouse over text to see original. Click the button below to return to the English verison of the 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 =

 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)

See Also

|

Introduced before R2006a

Was this topic helpful?