BulletinA#

class spacekernel.iers.BulletinA#

Bases: object

IERS Bulletin A

Singleton class providing IERS Bulletin A data with rapid determinations for earth orientation parameters (polar motion, UT1-UTC, LOD, nutation).

BulletinA downloads, parses, caches, and exposes IERS Bulletin A time series. This includes:

  • Polar motion (pm_x, pm_y), with prediction flags (pm_pred)

  • UT1‒UTC difference (dut), with prediction flags (dut_pred)

  • Length-of-day (lod)

  • Nutation corrections (dX_IAU2000A, dY_IAU2000A), with prediction flags (nutation_pred)

Summary#

Attributes#

Properties#

Dates#

BulletinA.mjd_utc

Modified Julian Date (UTC)

BulletinA.jd12_utc

Julian Date (UTC) in SOFA internal format

BulletinA.jd12_ut1

Julian Date (UT1) in SOFA internal format

BulletinA.mjd_ut1

Modified Julian Date (UT1)

BulletinA.date_utc

Gregorian Date (UTC)

Polar motion#

BulletinA.pm_pred

Polar motion prediction flag

BulletinA.pm_x

Polar motion x (in radians)

BulletinA.pm_x_error

Polar motion x error (in radians)

BulletinA.pm_y

Polar motion y (in radians)

BulletinA.pm_y_error

Polar motion y error (in radians)

DUT ( = UT1 - UTC)#

BulletinA.dut_pred

DUT prediction flag

BulletinA.dut

DUT = UT1 - UTC (in seconds)

BulletinA.dut_error

DUT error (in seconds)

Length of Day (LOD)#

BulletinA.lod

Length of day (LOD) (in seconds)

BulletinA.lod_error

LOD error

Nutation#

BulletinA.nutation_pred

Nutation prediction flag

BulletinA.dX_IAU2000A

Nutation x (in radians)

BulletinA.dX_IAU2000A_error

Nutation x error (in radians)

BulletinA.dY_IAU2000A

Nutation y (in radians)

BulletinA.dY_IAU2000A_error

Nutation y error (in radians)

Methods#

BulletinA.update(cls)

Download and parse the latest IERS Bulletin A data, then cache it.

Members#

property BulletinA.mjd_utc: ndarray[double]#

Modified Julian Date (UTC)

property BulletinA.jd12_utc: ndarray[double]#

Julian Date (UTC) in SOFA internal format

property BulletinA.jd12_ut1: ndarray[double]#

Julian Date (UT1) in SOFA internal format

property BulletinA.mjd_ut1: ndarray[double]#

Modified Julian Date (UT1)

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

Gregorian Date (UTC)

property BulletinA.pm_pred: ndarray[bint]#

Polar motion prediction flag

property BulletinA.pm_x: ndarray[double]#

Polar motion x (in radians)

property BulletinA.pm_x_error: ndarray[double]#

Polar motion x error (in radians)

property BulletinA.pm_y: ndarray[double]#

Polar motion y (in radians)

property BulletinA.pm_y_error: ndarray[double]#

Polar motion y error (in radians)

property BulletinA.dut_pred: ndarray[bint]#

DUT prediction flag

property BulletinA.dut: ndarray[double]#

DUT = UT1 - UTC (in seconds)

property BulletinA.dut_error: ndarray[double]#

DUT error (in seconds)

property BulletinA.lod: ndarray[double]#

Length of day (LOD) (in seconds)

property BulletinA.lod_error: ndarray[double]#

LOD error

property BulletinA.nutation_pred: ndarray[bint]#

Nutation prediction flag

property BulletinA.dX_IAU2000A: ndarray[double]#

Nutation x (in radians)

property BulletinA.dX_IAU2000A_error: ndarray[double]#

Nutation x error (in radians)

property BulletinA.dY_IAU2000A: ndarray[double]#

Nutation y (in radians)

property BulletinA.dY_IAU2000A_error: ndarray[double]#

Nutation y error (in radians)

BulletinA.url: str = 'https://maia.usno.navy.mil/ser7/finals2000A.daily.extended'#
classmethod BulletinA.update(cls) None#

Download and parse the latest IERS Bulletin A data, then cache it.

This method:
  1. Fetches the raw bulletin text from the remote URL in cls.url.

  2. Streams the response to a temporary file.

  3. Parses each line via _stream_data_from_file, extracting numeric fields.

  4. Applies unit conversions to SI: - arcseconds → radians (polar motion) - milliseconds → seconds (LOD) - milliarcseconds → radians (nutation)

  5. Saves the resulting pandas DataFrame to CSV at cls.path.

Raises:
requests.HTTPError

If the HTTP request to download the bulletin fails.

Examples

>>> BulletinA.update()
Downloading IERS bulletin A from https://maia.usno.navy.mil/ser7/finals2000A.daily.extended ... done!