IR-e dZddlZddlmZmZddlmZddlmZddlZddl Z ddl m Z ddl mZddl mZdd lmZmZdd lmZmZdd lmZmZmZmZdd lmZdd lmZgdZ dZ!dZ"dZ#edZ$edZ%dZ&edZ'edZ(dZ)dZ*dZ+dZ,dZ-dZ.dZ/dZ0dZ1gdZ2Gd d!eZ3Gd"d#eZ4Gd$d%e3Z5d&Z6d'Z7Gd(d)e j8Z9e9Z:Gd*d+e;Z<Gd,d-eZ=Gd.d/e=Z>Gd0d1e=Z?Gd2d3e>Z@Gd4d5eZAGd6d7eZBdS)8a The astropy.utils.iers package provides access to the tables provided by the International Earth Rotation and Reference Systems Service, in particular allowing interpolation of published UT1-UTC values for given times. These are used in `astropy.time` to provide UT1 values. The polar motions are also used for determining earth orientation for celestial-to-terrestrial coordinate transformations (in `astropy.coordinates`). N)datetimetimezone)urlparse)warn)config)units)utils) MaskedColumnQTable)Time TimeDelta)clear_download_cacheget_pkg_data_filenameget_readable_fileobjis_url_in_cache)AstropyWarning) ScienceState)Confconfearth_orientation_tableIERSIERS_BIERS_A IERS_Auto FROM_IERS_B FROM_IERS_AFROM_IERS_A_PREDICTIONTIME_BEFORE_IERS_RANGETIME_BEYOND_IERS_RANGE IERS_A_FILE IERS_A_URLIERS_A_URL_MIRROR IERS_A_README IERS_B_FILE IERS_B_URL IERS_B_READMEIERSRangeErrorIERSStaleWarning IERSWarningIERSDegradedAccuracyWarning LeapSecondsIERS_LEAP_SECOND_FILEIERS_LEAP_SECOND_URLIETF_LEAP_SECOND_URLzfinals2000A.allz2https://datacenter.iers.org/data/9/finals2000A.allz/https://maia.usno.navy.mil/ser7/finals2000A.allzdata/ReadMe.finals2000Azdata/eopc04.1962-nowz7https://hpiers.obspm.fr/iers/eop/eopc04/eopc04.1962-nowzdata/ReadMe.eopc04zdata/Leap_Second.datz5https://hpiers.obspm.fr/iers/bul/bulc/Leap_Second.datz7https://data.iana.org/time-zones/data/leap-seconds.listg@OBAainterpolating from IERS_Auto using predictive values that are more than {0} days old. Normally you should not see this error because this class automatically downloads the latest IERS-A table. Perhaps you are offline? If you understand what you are doing then this error can be suppressed by setting the auto_max_age configuration variable to ``None``: from astropy.utils.iers import conf conf.auto_max_age = None ) JanFebMarAprMayJunJulAugSepOctNovDecceZdZdZdS)r)z) Generic warning class for IERS. N__name__ __module__ __qualname____doc__7lib/python3.11/site-packages/astropy/utils/iers/iers.pyr)r)wrFr)ceZdZdZdS)r*z IERS time conversion has degraded accuracy normally due to setting ``conf.auto_download = False`` and ``conf.iers_degraded_accuracy = 'warn'``. Nr@rErFrGr*r*}srFr*ceZdZdZdS)r(z- Downloaded IERS table may be stale. Nr@rErFrGr(r(rHrFr(c|ddddtjjdtj5tjj|i|cdddS#1swxYwYdS)a Overload astropy.utils.data.download_file within iers module to use a custom (longer) wait time. This just passes through ``*args`` and ``**kwargs`` after temporarily setting the download_file remote timeout to the local ``iers.conf.remote_timeout`` value. http_headersz astropy/iersz*/*)z User-AgentAcceptremote_timeoutN) setdefaultr datarset_temprN download_file)argskwargss rGrRrRs (    ! !"2D4G H H99z'888999999999999999999s A,,A03A0cF||ntjtjS)z` Convert None to a valid floating point value. Especially for auto_max_age = None. )npfinfofloatmax)values rG_none_to_floatr[s %5528E??+>>rFcHeZdZdZejddZejddZejedZ eje dZ ejdd Z ejgd d Z ejd d ZejedZejedZdS)rz< Configuration parameters for `astropy.utils.iers`. TagEnable auto-downloading of the latest IERS data. If set to False then the local IERS-B file will be used by default (even if the full IERS file with predictions was already downloaded and cached). This parameter also controls whether internet resources will be queried to update the leap second table if the installed version is out of date. Default is True.g>@zMaximum age (days) of predictive data before auto-downloading. See "Auto refresh behavior" in astropy.utils.iers documentation for details. Default is 30.z(URL for auto-downloading IERS file data.z/Mirror URL for auto-downloading IERS file data.g$@z4Remote timeout downloading IERS file data (seconds).)errorrignorezIERS behavior if the range of available IERS data does not cover the times when converting time scales, potentially leading to degraded accuracy.zSystem file with leap seconds.z&URL for auto-downloading leap seconds.z0Alternate URL for auto-downloading leap seconds.N)rArBrCrD_config ConfigItem auto_download auto_max_ager! iers_auto_urlr"iers_auto_url_mirrorrNiers_degraded_accuracysystem_leap_second_filer-iers_leap_second_auto_urlr.ietf_leap_second_auto_urlrErFrGrrs 'G&  (M&7%  L 'G&>M.7-L(W' DN0W/###  1g05UVV 2 2F!!!3 2P!!rFrceZdZdZdS)r'zK Any error for when dates are outside of the valid range for IERS. Nr@rErFrGr'r'rHrFr'ceZdZdZdZ eddZedZddZddZ dd Z dd Z d Z dd Z d ZdZdZdZedZfdZxZS)rzGeneric IERS table class, defining interpolation functions. Sub-classed from `astropy.table.QTable`. The table should hold columns 'MJD', 'UT1_UTC', 'dX_2000A'/'dY_2000A', and 'PM_x'/'PM_y'. NFc *||j|Pt|jr&|t ||n|||t urt jdi||_n|jdi||_|jS)aOpen an IERS table, reading it from a file if not loaded before. Parameters ---------- file : str or None full local or network path to the ascii file holding IERS data, for passing on to the ``read`` class methods (further optional arguments that are available for some IERS subclasses can be added). If None, use the default location from the ``read`` class method. cache : bool Whether to use cache. Defaults to False, since IERS files are regularly updated. Returns ------- IERS An IERS table class instance Notes ----- On the first call in a session, the table will be memoized (in the ``iers_table`` class attribute), and further calls to ``open`` will return this stored table if ``file=None`` (the default). If a table needs to be re-read from disk, pass on an explicit file location or use the (sub-class) close method and re-open. If the location is a network location it is first downloaded via download_file. For the IERS class itself, an IERS_B sub-class instance is opened. NcachefilerE) iers_tablernetlocupdaterRrrread)clsrprnrTs rGopenz IERS.opensF  s~5D>>(-MM}T'G'G'GMHHHHMMtM,,,d{{!'!6!6v!6!6!)!3!3F!3!3~rFcd|_dS)zRemove the IERS table from the class. This allows the table to be re-read from disk during one's session (e.g., if one finds it is out of date and has updated the file). N)rq)rus rGclosez IERS.closesrFc |jj|jj}}n#t$rYnwxYwt j|t z |z}|t |zz |z}||fS)aTurn a time to MJD, returning integer and fractional parts. Parameters ---------- jd1 : float, array, or `~astropy.time.Time` first part of two-part JD, or Time object jd2 : float or array, optional second part of two-part JD. Default is 0., ignored if jd1 is `~astropy.time.Time`. Returns ------- mjd : float or array integer part of MJD utc : float or array fractional part of MJD )utcjd1jd2 ExceptionrVfloorMJD_ZERO)selfr|r}mjdr{s rGmjd_utcz IERS.mjd_utc"sp$ w{CGKCC    D hsX~+,,X^$s*Cxs  ((cF|||dg|r|jndS)aInterpolate UT1-UTC corrections in IERS Table for given dates. Parameters ---------- jd1 : float, array of float, or `~astropy.time.Time` object first part of two-part JD, or Time object jd2 : float or float array, optional second part of two-part JD. Default is 0., ignored if jd1 is `~astropy.time.Time`. return_status : bool Whether to return status values. If False (default), raise ``IERSRangeError`` if any time is out of the range covered by the IERS table. Returns ------- ut1_utc : float or float array UT1-UTC, interpolated in IERS Table status : int or int array Status values (if ``return_status``=``True``):: ``iers.FROM_IERS_B`` ``iers.FROM_IERS_A`` ``iers.FROM_IERS_A_PREDICTION`` ``iers.TIME_BEFORE_IERS_RANGE`` ``iers.TIME_BEYOND_IERS_RANGE`` UT1_UTCN) _interpolateut1_utc_sourcerr|r} return_statuss rGut1_utcz IERS.ut1_utc=s46  yk-#Q4#6#6T   rFcH|||ddg|r|jndS)aVInterpolate CIP corrections in IERS Table for given dates. Parameters ---------- jd1 : float, array of float, or `~astropy.time.Time` object first part of two-part JD, or Time object jd2 : float or float array, optional second part of two-part JD (default 0., ignored if jd1 is Time) return_status : bool Whether to return status values. If False (default), raise ``IERSRangeError`` if any time is out of the range covered by the IERS table. Returns ------- D_x : `~astropy.units.Quantity` ['angle'] x component of CIP correction for the requested times. D_y : `~astropy.units.Quantity` ['angle'] y component of CIP correction for the requested times status : int or int array Status values (if ``return_status``=``True``):: ``iers.FROM_IERS_B`` ``iers.FROM_IERS_A`` ``iers.FROM_IERS_A_PREDICTION`` ``iers.TIME_BEFORE_IERS_RANGE`` ``iers.TIME_BEYOND_IERS_RANGE`` dX_2000AdY_2000AN)r dcip_sourcers rGdcip_xyz IERS.dcip_xy\s:8     $ - 7D  4    rFcH|||ddg|r|jndS)atInterpolate polar motions from IERS Table for given dates. Parameters ---------- jd1 : float, array of float, or `~astropy.time.Time` object first part of two-part JD, or Time object jd2 : float or float array, optional second part of two-part JD. Default is 0., ignored if jd1 is `~astropy.time.Time`. return_status : bool Whether to return status values. If False (default), raise ``IERSRangeError`` if any time is out of the range covered by the IERS table. Returns ------- PM_x : `~astropy.units.Quantity` ['angle'] x component of polar motion for the requested times. PM_y : `~astropy.units.Quantity` ['angle'] y component of polar motion for the requested times. status : int or int array Status values (if ``return_status``=``True``):: ``iers.FROM_IERS_B`` ``iers.FROM_IERS_A`` ``iers.FROM_IERS_A_PREDICTION`` ``iers.TIME_BEFORE_IERS_RANGE`` ``iers.TIME_BEYOND_IERS_RANGE`` PM_xPM_yN)r pm_sourcers rGpm_xyz IERS.pm_xys5:  vv&-(QT   rFctj||krJtjdkrd}t |tjdkrd}t |t dSdSdS)z Check that the indices from interpolation match those after clipping to the valid table range. This method gets overridden in the IERS_Auto class because it has different requirements. r]a(some) times are outside of range covered by IERS table. Cannot convert with full accuracy. To allow conversion with degraded accuracy set astropy.utils.iers.conf.iers_degraded_accuracy to "warn" or "silent". For more information about setting this configuration parameter or controlling its value globally, see the Astropy configuration system documentation https://docs.astropy.org/en/stable/config/index.html.rzN(some) times are outside of range covered by IERS table, accuracy is degraded.N)rVanyrrfr'rr*)r indices_origindices_clipped max_input_mjdmsgs rG_check_interpolate_indiceszIERS._check_interpolate_indicess 6,/1 2 2 7*g55M%S))),66,S566666% 7 776rFc|||\}}t|d p |jdk}|r+tj|g}tj|g}n|jdkrtjgS||tj|dj|d}tj |dt|dz } | dz } |d| j|d| j} } g} |D]}||| ||| }}||z }|dkr|| z}||| z |z| | z z |zz}||d||dk<||d||t|k<|r|d}| ||rU|| }t||dk<t||t|k<|r|d}| || S|| |tj|t| dkr| dn| S) N __array__rMJDrightsider/rr1)rhasattrndimrVarraysize_refresh_table_as_needed searchsortedrZcliplenroundappendrrrrY)rr|r}columnssourcerr{ is_scalarii1i0mjd_0mjd_1resultscolumnval_0val_1d_valvalstatuss rGrzIERS._interpolatesb<<S))S[111BSX]  (C5//C(C5//CC X]]8B<<  %%c*** ODK-s A A AWQ3t99q= ) ) !VE{2,d5k"o.Cu  F<+T&\"-=5EEME""& 3;,?%GGCv,q/CQK"&v,r"2CSYY  !f NN3      @VBZZF3F16N%;F1D > " # NN6 " " "N  + +B26#;; ? ? ?!$W!2!271:: ?rFcdS)z Potentially update the IERS table in place depending on the requested time values in ``mdj`` and the time span of the table. The base behavior is not to update the table. ``IERS_Auto`` overrides this method. NrE)rrs rGrzIERS._refresh_table_as_neededs rFc*tj|S)z2Source for UT1-UTC. To be overridden by subclass.rV zeros_likerrs rGrzIERS.ut1_utc_source}QrFc*tj|S)z9Source for CIP correction. To be overridden by subclass.rrs rGrzIERS.dcip_sourcerrFc*tj|S)z7Source for polar motion. To be overridden by subclass.rrs rGrzIERS.pm_sourcerrFcX |jS#t$rtjcYSwxYw)z Property to provide the current time, but also allow for explicitly setting the _time_now attribute for testing purposes. ) _time_nowr~r nowrs rGtime_nowz IERS.time_now s<  > !   8::    s  ))ct|dd4t|tr|tj}t |S)Nunit)getattr isinstancer filledrVnansuper_convert_col_for_table)rcol __class__s rGrzIERS._convert_col_for_tablesQ 3 % % 1jl6S6S 1**RV$$Cww--c222rFNF)ry)ryFN)rArBrCrDrq classmethodrvrxrrrrrrrrrrpropertyrr __classcell__rs@rGrrsW JI222[2h[6    >! ! ! ! F    B7776:@:@:@:@x            X333333333rFrcveZdZdZdZedZedZed fd ZdZ dZ dZ xZ S) ravIERS Table class targeted to IERS A, provided by USNO. These include rapid turnaround and predicted times. See https://datacenter.iers.org/eop.php Notes ----- The IERS A file is not part of astropy. It can be downloaded from ``iers.IERS_A_URL`` or ``iers.IERS_A_URL_MIRROR``. See ``iers.__doc__`` for instructions on use in ``Time``, etc. Nc|tj|d|ddkz}||}tj|d}tj||d|d|d<tj||dd|d<tj|d tj|d z}tj||d |d |d <tj||d |d |d<tj||dd|d<tj|dtj|dz}tj||d|d|d<tj||d|d|d<tj||dd|d<t tj|ddtj|dd}||jd<|d|j|jd<|S)zZ Return a new table with appropriate combination of IERS_A and B columns. UT1_UTC_A PolPMFlag_Ar_ UT1_UTC_Br UT1Flag_ABUT1FlagPM_X_BPM_Y_BPM_x_ArPM_y_Ar PolPMFlag dX_2000A_B dY_2000A_B dX_2000A_Ar dY_2000A_Ar NutFlag_ANutFlagPpredictive_indexrpredictive_mjd) rVisfinite_substitute_iers_bisnanwhereminrmetarZ)ruiers_atableb_badp_indexs rG_combine_a_b_columnszIERS_A._combine_a_b_columns0sr{6+#6776-;PTV;VWX&&u--{+,,8E5+=u[?QRRi8E5+=sCCix))BHU8_,E,EEhxIIf hxIIf XeU=-A3GGk|,--|9L0M0MMHUE,,?|ATUUjHUE,,?|ATUUj8E5+=sCCi OE+. 4 4 OE-0# 6 6  *1 %&',U|G'<'B #$ rFc|SrrE)rurs rGrzIERS_A._substitute_iers_b^s  rFc|t}|t}t|d|}||}||jd<||jd<|S)aRead IERS-A table from a finals2000a.* file provided by USNO. Parameters ---------- file : str full path to ascii file holding IERS-A data. Defaults to ``iers.IERS_A_FILE``. readme : str full path to ascii file holding CDS-style readme. Defaults to package version, ``iers.IERS_A_README``. Returns ------- ``IERS_A`` class instance Ncds)formatreadme data_path readme_path)r r#rrtrr)rurprrrrs rGrtz IERS_A.readcsf" <D >"Fd5@@((00"& ;$* =! rFc|d|}tj|tz}t||dk<t||dk<|S)2Set UT1-UTC source flag for entries in IERS table.rIrrV ones_likerrr)rrut1flagrs rGrzIERS_A.ut1_utc_sourceCy/!$a;.!,w#~!7w#~ rFc|d|}tj|tz}t||dk<t||dk<|S)9Set CIP correction source flag for entries in IERS table.rrrr)rrnutflagrs rGrzIERS_A.dcip_sourcerrFc|d|}tj|tz}t||dk<t||dk<|S)z7Set polar motion source flag for entries in IERS table.rrrr)rrpmflagrs rGrzIERS_A.pm_sourcesDk"1%a;. +v} 6v} rF)NN) rArBrCrDrqrrrrtrrrrrs@rGrr!s  J++[+Z[[<rFrcJeZdZdZdZedfd ZdZdZdZ xZ S) raIERS Table class targeted to IERS B, provided by IERS itself. These are final values; see https://www.iers.org/IERS/EN/Home/home_node.html Notes ----- If the package IERS B file (```iers.IERS_B_FILE``) is out of date, a new version can be downloaded from ``iers.IERS_B_URL``. See `~astropy.utils.iers.IERS_B.read` for instructions on how to read a pre-2023 style IERS B file (usually named ``eopc04_IAU2000.62-now``). Nc|t}|t}t|d||}||jd<||jd<|S)a<Read IERS-B table from a eopc04.* file provided by IERS. Parameters ---------- file : str full path to ascii file holding IERS-B data. Defaults to package version, ``iers.IERS_B_FILE``. readme : str full path to ascii file holding CDS-style readme. Defaults to package version, ``iers.IERS_B_README``. data_start : int Starting row. Default is 6, appropriate for standard IERS files. Returns ------- ``IERS_B`` class instance Notes ----- To read a pre-2023 style IERS B file (usually named something like ``eopc04_IAU2000.62-now``), do something like this example with an excerpt that is used for testing:: >>> from astropy.utils.iers import IERS_B >>> from astropy.utils.data import get_pkg_data_filename >>> old_style_file = get_pkg_data_filename( ... "tests/data/iers_b_old_style_excerpt", ... package="astropy.utils.iers") >>> iers_b = IERS_B.read( ... old_style_file, ... readme=get_pkg_data_filename("data/ReadMe.eopc04_IAU2000", ... package="astropy.utils.iers"), ... data_start=14) Nr)rr data_startrr)r$r&rrtr)rurprrrrs rGrtz IERS_B.readsTJ <D >"F T%: VV"& ;$* =! rFc:tj|tzS)rrVrrrs rGrzIERS_B.ut1_utc_source|A,,rFc:tj|tzS)rrrs rGrzIERS_B.dcip_sourcerrFc:tj|tzS)z-Set PM source flag for entries in IERS table.rrs rGrzIERS_B.pm_sourcerrF)NNr ) rArBrCrDrqrrtrrrrrs@rGrrs  J-----[-^-------------rFrcNeZdZdZdZedZdZdZedZ dS)rzp Provide most-recent IERS data and automatically handle downloading of updated values as necessary. Nctjs%t|_|jStjtjf}|j(|jjd|vr|jS|D]} t|d}n2#t$r%}td|d|tYd}~?d}~wwxYw | ||_n2#t$r%}td|d|tYd}~d}~wwxYw||jjd<n3td tt|_|jS) aIf the configuration setting ``astropy.utils.iers.conf.auto_download`` is set to True (default), then open a recent version of the IERS-A table with predictions for UT1-UTC and polar motion out to approximately one year from now. If the available version of this file is older than ``astropy.utils.iers.conf.auto_max_age`` days old (or non-existent) then it will be downloaded over the network and cached. If the configuration setting ``astropy.utils.iers.conf.auto_download`` is set to False then ``astropy.utils.iers.IERS()`` is returned. This is normally the IERS-B table that is supplied with astropy. On the first call in a session, the table will be memoized (in the ``iers_table`` class attribute), and further calls to ``open`` will return this stored table. Returns ------- `~astropy.table.QTable` instance With IERS (Earth rotation) data columns Ndata_urlTrmfailed to download : rozmalformed IERS table from z6unable to download valid IERS file, using local IERS-B)rrbrrvrqrdrergetrRr~rr)rt)ruall_urlsurlfilenameerrs rGrvzIERS_Auto.opens.! "#[[]]CN> !&(AB > %~"&&z22h>>~% + +C (D999   7377#77EEE  !$x!8!8   >#>>>> LLL /2CN  + E I; W W W#[[]]CN~s0>B B?B::B?C D)D  Dc|jd}ttj}||kr:|jj|z |kr)t t|dSdS)aFCheck that the indices from interpolation match those after clipping to the valid table range. The IERS_Auto class is exempted as long as it has sufficiently recent available data so the clipped interpolation is always within the confidence bounds of current Earth rotation knowledge. rN) rr[rrcrr ValueErrorINTERPOLATE_ERRORr)rrrrrrcs rGrz$IERS_Auto._check_interpolate_indices,sn#34&d&788 N * * !N2\AA.55lCCDD D + *AArFc tj|}|jj}|jd}|jd}t t j}|dkrtd||kr||z |krt j t j f} t|d|d}nN#t$rA} ttdd |d | d Yd } ~ d Sd } ~ wwxYw|j| } t%|d| jd<| dd|ddkrtj| dj|d} t+||z } | | | | z||d <| d| | z|ddz dt,jzkrtd| | | zd D]} || |j| jd Stt5dt jdd Sd Sd S)aPotentially update the IERS table in place depending on the requested time values in ``mjd`` and the time span of the table. For IERS_Auto the behavior is that the table is refreshed from the IERS server if both the following apply: - Any of the requested IERS values are predictive. The IERS-A table contains predictive data out for a year after the available definitive values. - The first predictive values are at least ``conf.auto_max_age days`` old. In other words the IERS-A table was created by IERS long enough ago that it can be considered stale for predictions. rr zAIERS auto_max_age configuration value must be larger than 10 daysrrs)sourcesrnrz and rz. A coordinate or time-related calculation might be compromised or fail because the dates are not covered by the available IERS file. See the "IERS data access" section of the astropy documentation for additional information on working offline.Nrorrr1rrg?z0unexpected gap in MJD when refreshing IERS tablez+IERS_Auto predictive values are older than z@ days but downloading the latest table did not find newer values)rVrYrrrr[rrcr rdrerRr~rrjoinrrtstrrrZrudadd_rowrsr()rrrnow_mjdfpirrcrrr new_tablenew_fpi n_replacerows rGrz"IERS_Auto._refresh_table_as_needed=ss -#i*+#34&d&788  "  S  > ) )w/G<.W.W*D,EFH (!hhWWW   "$gll8.D.D$$$$$     +++::I),Xa[)9)9IN: &#d5k"o55/e$*N IIO &w91D'DESTT U#Gi$784;r?JcTUTWiWW$%WXXX%Wy%8%:%:;&&CLL%%%%   00000$5 -555] * ).W.WsB,, C766C22C7c|t}|dtj|d}tj|d|dd}tj|d|dd}|||}t |}|dkrt j|dd||dstd |d |dd|<|d |d d|<|d |dd|<|d|dd|<|d|dd|<|S)aMSubstitute IERS B values with those from a real IERS B table. IERS-A has IERS-B values included, but for reasons unknown these do not match the latest IERS-B values (see comments in #4436). Here, we use the bundled astropy IERS-B table to overwrite the values in the downloaded IERS-A table. rrrleftrr1rNzAunexpected mismatch when copying IERS-B values into IERS-A table.rrrrrrrrr) rrvrVrrrr'allcloser )ruriers_bmjd_brrn_iers_bs rGrzIERS_Auto._substitute_iers_bs@e R[{);<<= _VE]E!H6 B B B _VE]E"IG D D D2v;; a<<:eEl9H95ve}EE  W-39,=E+ yy ))/E(OIXI &)/E(OIXI &-3J-?E,   *-3J-?E,   * rF) rArBrCrDrqrrvrrrrErFrGrrs J99[9vEEE"TTTl[rFrc,eZdZdZdZedZdS)raDefault IERS table for Earth rotation and reference systems service. These tables are used to calculate the offsets between ``UT1`` and ``UTC`` and for conversion to Earth-based coordinate systems. The state itself is an IERS table, as an instance of one of the `~astropy.utils.iers.IERS` classes. The default, the auto-updating `~astropy.utils.iers.IERS_Auto` class, should suffice for most purposes. Examples -------- To temporarily use the IERS-B file packaged with astropy:: >>> from astropy.utils import iers >>> from astropy.time import Time >>> iers_b = iers.IERS_B.open(iers.IERS_B_FILE) >>> with iers.earth_orientation_table.set(iers_b): ... print(Time('2000-01-01').ut1.isot) 2000-01-01T00:00:00.355 To use the most recent IERS-A file for the whole session:: >>> iers_a = iers.IERS_A.open(iers.IERS_A_URL) # doctest: +SKIP >>> iers.earth_orientation_table.set(iers_a) # doctest: +SKIP ...> To go back to the default (of `~astropy.utils.iers.IERS_Auto`):: >>> iers.earth_orientation_table.set(None) # doctest: +SKIP ...> Nc|t}t|tst d|S)Nz/earth_orientation_table requires an IERS Table.)rrvrrr )rurZs rGvalidatez earth_orientation_table.validates= =NN$$E%&& PNOO O rF)rArBrCrD_valuerr8rErFrGrrs?BF[rFrceZdZdZejdZdZdedddgZ e dd Z e d Z e dd Zed Ze d Ze efdZe dZe ddZddZdS)r+aLeap seconds class, holding TAI-UTC differences. The table should hold columns 'year', 'month', 'tai_utc'. Methods are provided to initialize the table from IERS ``Leap_Second.dat``, IETF/ntp ``leap-seconds.list``, or built-in ERFA/SOFA, and to update the list used by ERFA. Notes ----- Astropy has a built-in ``iers.IERS_LEAP_SECONDS_FILE``. Up to date versions can be downloaded from ``iers.IERS_LEAP_SECONDS_URL`` or ``iers.LEAP_SECONDS_LIST_URL``. Many systems also store a version of ``leap-seconds.list`` for use with ``ntp`` (e.g., on Debian/Ubuntu systems, ``/usr/share/zoneinfo/leap-seconds.list``). To prevent querying internet resources if the available local leap second file(s) are out of date, set ``iers.conf.auto_download = False``. This must be done prior to performing any ``Time`` scale transformations related to UTC (e.g. converting from UTC to TAI). z,^#.*File expires on[:\s]+(\d+\s\w+\s\d+)\s*$NerfargrhriFcF||S|dkr|St|jrt ||} ||S#t$r||cYSwxYw)aOpen a leap-second list. Parameters ---------- file : path-like or None Full local or network path to the file holding leap-second data, for passing on to the various ``from_`` class methods. If 'erfa', return the data used by the ERFA library. If `None`, use default locations from file and configuration to find a table that is not expired. cache : bool Whether to use cache. Defaults to False, since leap-second files are regularly updated. Returns ------- leap_seconds : `~astropy.utils.iers.LeapSeconds` Table with 'year', 'month', and 'tai_utc' columns, plus possibly others. Notes ----- Bulletin C is released about 10 days after a possible leap second is introduced, i.e., mid-January or mid-July. Expiration days are thus generally at least 150 days after the present. For the auto-loading, a list comprised of the table shipped with astropy, and files and URLs in `~astropy.utils.iers.Conf` are tried, returning the first that is sufficiently new, or the newest among them all. Nr;rm) auto_openlower from_erfarrrrRfrom_iers_leap_secondsr~from_leap_seconds_list)rurprns rGrvzLeapSeconds.opens> <==?? " ::<<6 ! !==?? " D>>  4 U333D 4--d33 3 4 4 4--d33 3 3 3 4s)A>>B B cdtjtj}t |dddS)N&{0.year:04d}-{0.month:02d}-{0.day:02d})tztaiisodate)scaler out_subfmt)rrrrr{r )ss rG_todayzLeapSeconds._today4sD 5 ; ; LHL ) ) )  AU5VDDDDrFcdtjdn tjz }|t|dz}|d|jD}d|D}d|D}tjr|d |Dz }d}g}|D]\}}|st | ||d } n,#t$r} | | Yd} ~ Sd} ~ wwxYw|| j |j kr&| }t||j d <|j |krn|td ||j |kr!tjtdt|S)akAttempt to get an up-to-date leap-second list. The routine will try the files in sequence until it finds one whose expiration date is "good enough" (see below). If none are good enough, it returns the one with the most recent expiration date, warning if that file is expired. For remote files that are cached already, the cached file is tried first before attempting to retrieve it again. Parameters ---------- files : list of path-like, optional List of files/URLs to attempt to open. By default, uses ``cls._auto_open_files``. Returns ------- leap_seconds : `~astropy.utils.iers.LeapSeconds` Up to date leap-second table Notes ----- Bulletin C is released about 10 days after a possible leap second is introduced, i.e., mid-January or mid-July. Expiration days are thus generally at least 150 days after the present. We look for a file that expires more than 180 - `~astropy.utils.iers.Conf.auto_max_age` after the present. Njd)rc:g|]}tt||SrE)rr.0fs rG z)LeapSeconds.auto_open..bs$GGGQWT1a((GGGrFcg|]}||SrErErQs rGrTz)LeapSeconds.auto_open..es'''qQ''''rFc\g|])}t|jrt|%|df*S)T)rrrrrQs rGrTz)LeapSeconds.auto_open..jsK   HQKK,> BQRSBTBT I   rFc>g|]}t|j|dfSF)rrrrQs rGrTz)LeapSeconds.auto_open..ps*GGGaHQKK4FG5zGGGrFTrmrzDnone of the files could be read. The following errors were raised: zleap-second file is expired.)rrcrKr _auto_open_filesrbrrvr~rexpiresr&rr rr() rufilesoffset good_enoughtrialsrerr_listrS allow_cachetrialexcs rGr=zLeapSeconds.auto_open=s>d/7T=NOjjllYvd%C%C%CC =HG#2FGGGE('E'''   $      H GG5GGG GF%  NA{ ($Q''' $//   $$$ |u}t|;;(+A *%<+--E <>3;>>  <$++-- ' 'D,=,I /1A B B B s'B?? C( C##C(c|jS)z#The limit of validity of the table.)_expiresrs rGrZzLeapSeconds.expiress }rFc d}t|5}|}|D]}|j|}|rr|d\}} } t | dddz} t| d| dd|dd }ntd | dddn #1swxYwY|j |fd d i|} || _ | S) z?Read a file, identifying expiration by matching 'File expires'.Nrr/-02drErG)rHrIz did not find expiration date in rzascii.no_header) r readlines _re_expiresmatchgroupssplit MONTH_ABBRindexr r rtrd) rurprTrZfhlineslinerkdaymonthyearmonth_nbrs rG_read_leap_secondszLeapSeconds._read_leap_secondss !$ ' ' L2LLNNE L L--d33',||~~a'8'>'>'@'@$C)//bqb ::Q>H"66(66666ePVGE !!JD!J!JKKK L L L L L L L L L L L L L L LsxBB&7B6BB  sB:CC Cc4||gdS)aCreate a table from a file like the IERS ``Leap_Second.dat``. Parameters ---------- file : path-like, optional Full local or network path to the file holding leap-second data in a format consistent with that used by IERS. By default, uses ``iers.IERS_LEAP_SECOND_FILE``. Notes ----- The file *must* contain the expiration date in a comment line, like '# File expires on 28 June 2020' )rrsrtrutai_utc)names)rw)rurps rGr@z"LeapSeconds.from_iers_leap_secondss- %% BBB&   rFc lddlm}gd}||||ddd|tjgi}|ddz d z|d <t |d d d j}tjd |D}|j \|d<|d<|d<|S)aCreate a table from a file like the IETF ``leap-seconds.list``. Parameters ---------- file : path-like, optional Full local or network path to the file holding leap-second data in a format consistent with that used by IETF. Up to date versions can be retrieved from ``iers.IETF_LEAP_SECOND_URL``. Notes ----- The file *must* contain the expiration date in a comment line, like '# File expires on: 28 June 2020' r) convert_numpy) ntp_secondsrycommentrsrtruNr0r})rz include_names convertersiQi:rrE)rrHc~g|]:}d|dddD;S)c,g|]}t|SrE)int)rRparts rGrTzALeapSeconds.from_leap_seconds_list...s C C CDc$ii C C CrFTrrg) partitionrm)rRts rGrTz6LeapSeconds.from_leap_seconds_list..sF R R R C CAKK$4$4Q$7$=$=c$B$B C C C R R RrFrurtrs) astropy.io.asciir|rwrVint64rr isotrr)rurpr|rzrrymds rGrAz"LeapSeconds.from_leap_seconds_lists 322222MMM%% )% bh(?(?'@A &   M*U2U:AACCU DKU;;;@h R RT R R R  4750V d7mT%[ rFc|tj}tdtjjd|_|s|S tjd|dtj|S#tj|wxYw)a)Create table from the leap-second list in ERFA. Parameters ---------- built_in : bool If `False` (default), retrieve the list currently used by ERFA, which may have been updated. If `True`, retrieve the list shipped with erfa. rCrE)rHNF)built_in) r; leap_secondsrr rrZrdsetr?)rurcurrents rGr?zLeapSeconds.from_erfas#d'++--.. 4 ; ;D   [ &!![!F+++[+0+.+.+.+.+.+.rFr+)CrDrrr urllib.parserwarningsrr;numpyrVastropyrr`rr'r astropy.tabler r astropy.timer r astropy.utils.datarrrrastropy.utils.exceptionsrastropy.utils.stater__all__r r!r"r#r$r%r&r,r-r.rrrrrrr!rnr)r*r(rRr[ConfigNamespacerr IndexErrorr'rrrrrr+rErFrGrs" ''''''''!!!!!! %%%%%%........(((((((( 433333,,,,,,   > A E%%&?@@ $#$:;; F %%&:;; .-.DEENP        . .{ 999&???)))))7 ")))X tvvZ D3D3D3D3D36D3D3D3N wwwwwTwwwtJ-J-J-J-J-TJ-J-J-ZIIIIIIIIX*****l***ZH.H.H.H.H.&H.H.H.H.H.rF