def parseETM5(strUTM, datum=Datums.WGS84, Etm=Etm, falsed=True, name=''):
'''Parse a string representing a UTM coordinate, consisting
of C{"zone[band] hemisphere easting northing"}.
@param strUTM: A UTM coordinate (C{str}).
@keyword datum: Optional datum to use (L{Datum}).
@keyword Etm: Optional (sub-)class to return the UTM
coordinate (L{Etm}) or C{None}.
@keyword falsed: Both easting and northing are falsed (C{bool}).
@keyword name: Optional B{C{Etm}} name (C{str}).
@return: The UTM coordinate (B{C{Etm}}) or a
L{UtmUps5Tuple}C{(zone, hemipole,
easting, northing, band)} if B{C{Etm}} is
C{None}. The C{hemipole} is the hemisphere
C{'N'|'S'}.
@raise ETMError: Invalid B{C{strUTM}}.
@example:
>>> u = parseETM5('31 N 448251 5411932')
>>> u.toStr2() # [Z:31, H:N, E:448251, N:5411932]
>>> u = parseETM5('31 N 448251.8 5411932.7')
>>> u.toStr() # 31 N 448252 5411933
'''
r = _parseUTM5(strUTM, ETMError)
if Etm is not None:
z, h, e, n, B = r
r = Etm(z, h, e, n, band=B, datum=datum, falsed=falsed)
return _xnamed(r, name)
def parseETM5(strUTM, datum=Datums.WGS84, Etm=Etm, falsed=True, name=NN):
'''Parse a string representing a UTM coordinate, consisting
of C{"zone[band] hemisphere easting northing"}.
@arg strUTM: A UTM coordinate (C{str}).
@kwarg datum: Optional datum to use (L{Datum}, L{Ellipsoid},
L{Ellipsoid2} or L{a_f2Tuple}).
@kwarg Etm: Optional class to return the UTM coordinate
(L{Etm}) or C{None}.
@kwarg falsed: Both easting and northing are falsed (C{bool}).
@kwarg name: Optional B{C{Etm}} name (C{str}).
@return: The UTM coordinate (B{C{Etm}}) or if B{C{Etm}} is
C{None}, a L{UtmUps5Tuple}C{(zone, hemipole, easting,
northing, band)}. The C{hemipole} is the hemisphere
C{'N'|'S'}.
@raise ETMError: Invalid B{C{strUTM}}.
@raise TypeError: Invalid B{C{datum}}.
@example:
>>> u = parseETM5('31 N 448251 5411932')
>>> u.toStr2() # [Z:31, H:N, E:448251, N:5411932]
>>> u = parseETM5('31 N 448251.8 5411932.7')
>>> u.toStr() # 31 N 448252 5411933
'''
r = _parseUTM5(strUTM, datum, Etm, falsed, Error=ETMError)
return _xnamed(r, name, force=True)
