BulletinC#

class spacekernel.iers.BulletinC#

Bases: object

IERS Bulletin C

Singleton class providing IERS Bulletin C (Leap Second) data (TAI–UTC).

BulletinC downloads, parses, caches, and exposes IERS Bulletin C time series.

Summary#

Attributes#

BulletinC.url

Properties#

Dates#

BulletinC.mjd_utc

Modified Julian Date (UTC)

BulletinC.jd12_utc

Julian Date (UTC) in SOFA internal format

BulletinC.jd12_ut1

Julian Date (UT1) in SOFA internal format

BulletinC.mjd_ut1

Modified Julian Date (UT1)

BulletinC.date_utc

Gregorian Date (UTC)

DAT (= TAI - UTC)#

BulletinC.dat

DAT = TAI - UTC (in seconds)

Methods#

BulletinC.update(cls)

Download and parse the latest IERS Bulletin C (leap-second) data, then cache and load it.

Members#

property BulletinC.mjd_utc: ndarray[double]#

Modified Julian Date (UTC)

property BulletinC.date_utc: ndarray['datetime64']#

Gregorian Date (UTC)

property BulletinC.dat: ndarray[int]#

DAT = TAI - UTC (in seconds)

BulletinC.url: str = 'https://hpiers.obspm.fr/iers/bul/bulc/Leap_Second.dat'#
classmethod BulletinC.update(cls) → BulletinC#

Download and parse the latest IERS Bulletin C (leap-second) data, then cache and load it.

Steps:

  1. Fetch the raw leap-second file from cls.url.

  2. Write the downloaded text into a temporary in-memory buffer.

  3. Parse each non-comment line via _stream_data_from_file to extract fields.

  4. Construct a pandas DataFrame and write it as CSV to cls.path.

  5. Reload self.data from the updated CSV file.

Raises:
requests.HTTPError

If the HTTP request to download the bulletin fails.

Examples

>>> BulletinC.update()
Downloading IERS bulletin C from https://hpiers.obspm.fr/iers/bul/bulc/Leap_Second.dat ... done!