- :
strs =angltostr(angles)¶ - :
strs =angltostr(angles, hemcode)¶ - :
strs =angltostr(angles, hemcode, unit)¶ - :
strs =angltostr(angles, hemcode, unit, prec)¶ Convert numerical angle values (Lat and/or Lon) into cellstr text values.
Inputs:
- angles is a scalar or any array of angular values in degrees. In case unit is specified as radians, angles is supposed to be in radians as well.
- hemcode (optional), used for indicating the hemisphere, can be one of "ew", "ns", "pm" or "none" (default), all case-insensitive. Depending on the sign of the input angle(s), the output strings have a trailing "E", "W", "N" or "S" character in case of hemcode = "ew" or "ns", a leading "+"or "-" in case of hemcode = "pm", or just a leading "-" or negative output values in case of hemcode = "none". angltostr.m is forgiving: "we", "sn", "mp" and "no" are also accepted and any empty value will be recognized as "none".
- unit (optional, case-insensitive) describes the output format.
* "degrees" (default): decimal degrees (~ -110.5320)
* "degrees2dm": integer degrees and real minutes (94°55.980’W)
* "degrees2dms": integer degrees and minutes and real seconds (~ 4°55’58.8"S)
* "radians": real radian "values" (~ +3.141593) - prec indicates the desired number of decimal places; it’s equal to abs(prec).
The output is a cell array of strings, one cell for each angle value, the same shape as the input array. To convert it to more Matlab-compatible output, just apply char() to get a char string or char array.
Furthermore, unlike its Matlab sibling angl2str, angltostr will map output values into the [-180, 180] interval and adjust output hemisphere indicators ("E", "W", "N", "S" or just "-" or "+") accordingly. For latitudes this works similarly only if "ns" was specified for hemcode; in all other cases output must be postprocessed manually to map absolute latitudes > 90 degrees into (180-lat) * sign(lat); analogously for radians.
See also: angl2str, str2angle.
Package: mapping