a ߙfbmJ@s*dZddlZddlZddlmZddlZddlmZm Z m Z m Z m Z m Z ddlmZmZddlmZGdd d Zd d Zd d ZddZddZd:ddZddZd;ddZdd5d6Z(d?d8d9Z)dS)@z This module contains formatting functions that are for internal use in astropy.coordinates.angles. Mainly they are conversions from one format of data to another. N)warn)IllegalHourWarningIllegalHourErrorIllegalMinuteWarningIllegalMinuteErrorIllegalSecondWarningIllegalSecondError)format_exceptionparsing)unitsc@sBeZdZdZeZddZeddZ eddZ d d d Z d S) _AngleParseru Parses the various angle formats including: * 01:02:30.43 degrees * 1 2 0 hours * 1°2′3″ * 1d2m3s * -1h2m3s * 1°2′3″N This class should not be used directly. Use `parse_angle` instead. cCs$dtjjvr |\tj_tj_dS)N_parser)r _thread_local__dict__ _make_parserr_lexer)selfr@lib/python3.9/site-packages/astropy/coordinates/angle_formats.py__init__4s  z_AngleParser.__init__cCsJttjjdd}t}|D]$}|tjkr|tjkr||jqt|S)NT)Zinclude_prefix_units) seturadianZfind_equivalent_unitsZdeg hourangleupdatenamessorted)clsZ simple_unitsZsimple_unit_namesunitrrr_get_simple_unit_names@s z#_AngleParser._get_simple_unit_namesc!Csddlm}m}d}dd}dd}dd }d d }d d }dd} ddd|D| _d} d} d} d} d}d}dd}tjddd}dd}d d!}d"d#}d$d%}d&d'}d(d)}d*d+}d,d-}d.d/}d0d1}d2d3}d4d5}d6d7}d8d9}tjd:dd;} | |fS).t_UFLOATcSst|j|_|S)z\d+)intr&r(rrrt_UINTis z)_AngleParser._make_parser..t_UINTcSs|jdkrd|_nd|_|S)u[+−-]+?r&r(rrrt_SIGNns z)_AngleParser._make_parser..t_SIGNcSs|jdkrdnd|_|S)z[EW]$Wr/r.r0r(rrr t_EASTWESTysz-_AngleParser._make_parser..t_EASTWESTcSs|jdkrdnd|_|S)z[NS]$Sr/r.r0r(rrr t_NORTHSOUTH~sz/_AngleParser._make_parser..t_NORTHSOUTHcSst|j|_|SN)rZUnitr&r(rrr t_SIMPLE_UNITsz0_AngleParser._make_parser..t_SIMPLE_UNIT|css|]}d|dVqdS)z(?:)Nr).0xrrr sz,_AngleParser._make_parser..:ud(eg(ree(s)?)?)?|°uhour(s)?|h(r)?|ʰum(in(ute(s)?)?)?|′|\'|ᵐus(ec(ond(s)?)?)?|″|\"|ˢ cSstd|jdS)NzInvalid character at col ) ValueErrorZlexposr(rrrt_errors z*_AngleParser._make_parser..t_errorZ angle_lextabzastropy/coordinates)ZlextabpackagecSs^|d|d}|d\}}t|trJ||df|dd|f|d<n|||f|d<dS)z angle : sign hms eastwest | sign dms dir | sign arcsecond dir | sign arcminute dir | sign simple dir rrN) isinstancetuple)psignr&rrrrp_angles   $z*_AngleParser._make_parser..p_anglecSs&t|dkr|d|d<nd|d<dS)z8 sign : SIGN | rCrrr.NlenrFrrrp_signs z)_AngleParser._make_parser..p_signcSs&t|dkr|d|d<nd|d<dS)zD eastwest : EASTWEST | rCrrr.NrIrKrrr p_eastwests z-_AngleParser._make_parser..p_eastwestcSs&t|dkr|d|d<nd|d<dS)zW dir : EASTWEST | NORTHSOUTH | rCrrr.NrIrKrrrp_dirs z(_AngleParser._make_parser..p_dircSs|d|d<dS)zC ufloat : UFLOAT | UINT rrNrrKrrrp_ufloatsz+_AngleParser._make_parser..p_ufloatcSsLt|dkr"|d|df|d<n&t|dkrH|d|d|df|d<dS)zd colon : UINT COLON ufloat | UINT COLON UINT COLON ufloat rrBrNrIrKrrrp_colons  z*_AngleParser._make_parser..p_coloncSsLt|dkr"|d|df|d<n&t|dkrH|d|d|df|d<dS)zT spaced : UINT ufloat | UINT UINT ufloat rBrrCrrPNrIrKrrrp_spaceds  z+_AngleParser._make_parser..p_spacedcSs|d|d<dS)zc generic : colon | spaced | ufloat rrNrrKrrr p_genericsz,_AngleParser._make_parser..p_genericcSsxt|dkr |dtjf|d<nTt|dvrH|d|dftjf|d<n,t|dvrt|d|d|dftjf|d<dS)a" hms : UINT HOUR | UINT HOUR ufloat | UINT HOUR UINT MINUTE | UINT HOUR UFLOAT MINUTE | UINT HOUR UINT MINUTE ufloat | UINT HOUR UINT MINUTE ufloat SECOND | generic HOUR rBrrrPrRrQrRN)rJrrrKrrrp_hmss   z(_AngleParser._make_parser..p_hmscSsxt|dkr |dtjf|d<nTt|dvrH|d|dftjf|d<n,t|dvrt|d|d|dftjf|d<dS)a0 dms : UINT DEGREE | UINT DEGREE ufloat | UINT DEGREE UINT MINUTE | UINT DEGREE UFLOAT MINUTE | UINT DEGREE UINT MINUTE ufloat | UINT DEGREE UINT MINUTE ufloat SECOND | generic DEGREE rBrrrVrWrRN)rJrdegreerKrrrp_dmss   z(_AngleParser._make_parser..p_dmscSs6t|dkr|ddf|d<n|d|df|d<dS)zS simple : generic | generic SIMPLE_UNIT rCrNrrIrKrrrp_simples z+_AngleParser._make_parser..p_simplecSs|dtjf|d<dS)z4 arcsecond : generic SECOND rrN)rZ arcsecondrKrrr p_arcsecondsz._AngleParser._make_parser..p_arcsecondcSs|dtjf|d<dS)z4 arcminute : generic MINUTE rrN)rZ arcminuterKrrr p_arcminutesz._AngleParser._make_parser..p_arcminutecSstdSr6)r?rKrrrp_error%sz*_AngleParser._make_parser..p_errorZangle_parsetab)Z tabmodulerA)Zastropy.extern.plyr!r"joinr __doc__r )!rr!r"tokensr*r,r1r3r5r7Zt_COLONZt_DEGREEZt_HOURZt_MINUTEZt_SECONDZt_ignorer@lexerrHrLrMrNrOrSrTrUrYr[r\r]r^r_parserrrrrLsF         z_AngleParser._make_parserFc Csz |jjj||jj|d\}}WnVtyv}z>t|rRtt|d||ntd||WYd}~n d}~00|dur|durtd||fS)N)rcdebugz in angle zSyntax error parsing angle zNo unit specified)rrparserr?strrZ UnitsError)ranglerreZ found_angleZ found_uniterrrrf,s  z_AngleParser.parseN)F) __name__ __module__ __qualname__ra threadinglocalrr classmethodr rrfrrrrr !s   `r cCsLtt|dkr$tt|dn$t|dks@t|dkrHt|dS)z@ Checks that the given value is in the range (-24, 24). g8@zTreating as 24 hrg8N)npanyabsrrr)Zhrsrrr_check_hour_range=srscCsFt|dkrtt|dn$t|dks:t|dkrBt|dS)y Checks that the given value is in the range [0,60]. If the value is equal to 60, then a warning is raised. N@zTreating as 0 min, +1 hr/degNN)rprqrrr)mrrr_check_minute_rangeGsrxcCsPt|dkrtt|dn.|dur(n$t|dksDt|dkrLt|dS)rtruzTreating as 0 sec, +1 minNrv)rprqrrr )Zsecrrr_check_second_rangeSs rycCst|t|t|dS)z\ Checks that the given hour, minute and second are all within reasonable range. N)rsrxryhrwsrrrcheck_hms_rangesasr}FcCstj|||dS)u Parses an input string value into an angle value. Parameters ---------- angle : str A string representing the angle. May be in one of the following forms: * 01:02:30.43 degrees * 1 2 0 hours * 1°2′3″ * 1d2m3s * -1h2m3s unit : `~astropy.units.UnitBase` instance, optional The unit used to interpret the string. If ``unit`` is not provided, the unit must be explicitly represented in the string, either at the end or as number separators. debug : bool, optional If `True`, print debugging information from the parser. Returns ------- value, unit : tuple ``value`` is the value as a floating point number or three-part tuple, and ``unit`` is a `Unit` instance which is either the unit passed in or the one explicitly mentioned in the input string. )re)r rf)rhrrerrr parse_anglelsr~cCs\td|}tt|\}}t|d\}}|d}t|||t|||fS)zd Convert a floating-point degree value into a ``(degree, arcminute, arcsecond)`` tuple. r.rurpcopysignZmodfrrfloor)drGZdfmfrwr|rrrdegrees_to_dmss  rc Cst|t|td|}zFtt|}|durFt|}d}ntt|}t|}Wn8ty}z ttd||||WYd}~n d}~00|||d|dS)zI Convert degrees, arcminute, arcsecond to a float degrees value. r.NrzL{func}: dms values ({1[0]},{2[1]},{3[2]}) could not be converted to numbers.ru @)rxryrprrrrr?r )rrwr|rGerrrrrdms_to_degreess$  rc Cst|||td|}zFtt|}|durBt|}d}ntt|}t|}Wn8ty}z ttd||||WYd}~n d}~00|||d|dS)z= Convert hour, minute, second to a float hour value. r.NrzL{func}: HMS values ({1[0]},{2[1]},{3[2]}) could not be converted to numbers.rur)r}rprrrrr?r )r{rwr|rGrrrr hms_to_hourss"   rcCst|||dS)z@ Convert hour, minute, second to a float degrees value. g.@)rrzrrrhms_to_degreessrcCstjtjt|||S)z@ Convert hour, minute, second to a float radians value. )rrZtorrrzrrrhms_to_radianssrcCstt|||S)z] Convert degrees, arcminutes, arcseconds to an ``(hour, minute, second)`` tuple. )rrrzrrr hms_to_dmssrcCsddlm}|j|tjdjS)z> Convert any parseable hour value into a float value. r)angles)r)rZAnglerrZhour)r{rrrrhours_to_decimals rcCstjtj|S)z/ Convert an angle in Hours to Radians. )rrrr)r{rrrhours_to_radianssrcCs\td|}tt|\}}t|d\}}|d}t|||t|||fS)z\ Convert an floating-point hour value into an ``(hour, minute, second)`` tuple. r.rur)r{rGZhfrrwr|rrr hours_to_hmss  rcCstjtj|S)z1 Convert an angle in Radians to Degrees. )rrrrZrrrrradians_to_degrees srcCstjtj|S)z/ Convert an angle in Radians to Hours. )rrrrrrrrradians_to_hourssrcCst|}t|S)zM Convert an angle in Radians to an ``(hour, minute, second)`` tuple. )rr)rZhoursrrrradians_to_hmssrcCstjtj|}t|S)zY Convert an angle in Radians to an ``(degree, arcminute, arcsecond)`` tuple. )rrrrZr)rZdegreesrrrradians_to_dms srr=rBc Cs~td|d}dd|D}|r6|dkr0d}q:d}nd}t|tsLt|}|dks\|dkrdtd |snd }nht|dkr|dkr||dd f}q|dkr|d }qd }n*t|dkr|d }nt|dkrtd|durd}ndd| }|dkr$|d|kr$d|d<|dd7<n(|dkrL|ddkrL|dd7<|dkr~|ddkr~d|d<|dd7<n(|dkr|ddkr|dd7<g}d }|d|dkr|d|dkrF|durt|dd}|dd}ndj t|d|d}t|dks4|ddkr9z)sexagesimal_to_string..rBrCrzfields must be 1, 2, or 3)rrrr)rr)rz?Invalid separator specification for converting angle to string.NgqM@rug$@gg>@z{0:0{pad}.0f}{sep[0]}z{1:02d}{sep[1]}z.8f0.z{0:.{precision}f}) precisionz{last_value}{sep[2]})seppad last_value) rprrDrEr?rJappendrrrstripformatr`r+) valuesrrrfieldsrGZrounding_threshliteralrrrrsexagesimal_to_string*sz               rrRrzcCs&t|\}}}t|||f||||dS)z Takes a decimal hour value and returns a string formatted as hms with separator specified by the 'sep' parameter. ``h`` must be a scalar. rrrr)rr)r{rrrrrwr|rrrhours_to_stringsrr=cCs&t|\}}}t|||f||||dS)z Takes a decimal hour value and returns a string formatted as dms with separator specified by the 'sep' parameter. ``d`` must be a scalar. r)rr)rrrrrrwr|rrrdegrees_to_stringsr)NF)N)N)NFrrB)rRFrzrB)rRFr=rB)*raosrmwarningsrZnumpyrperrorsrrrrrr Z astropy.utilsr r Zastropyr rr rsrxryr}r~rrrrrrrrrrrrrrrrrrrrsF      "      Z