BulletinA#
- class spacekernel.iers.BulletinA#
Bases:
objectIERS 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#
Modified Julian Date (UTC) |
|
Julian Date (UTC) in SOFA internal format |
|
Julian Date (UT1) in SOFA internal format |
|
Modified Julian Date (UT1) |
|
Gregorian Date (UTC) |
Polar motion#
Polar motion prediction flag |
|
Polar motion x (in radians) |
|
Polar motion x error (in radians) |
|
Polar motion y (in radians) |
|
Polar motion y error (in radians) |
DUT ( = UT1 - UTC)#
DUT prediction flag |
|
DUT = UT1 - UTC (in seconds) |
|
DUT error (in seconds) |
Length of Day (LOD)#
Length of day (LOD) (in seconds) |
|
LOD error |
Nutation#
Nutation prediction flag |
|
Nutation x (in radians) |
|
Nutation x error (in radians) |
|
Nutation y (in radians) |
|
Nutation y error (in radians) |
Methods#
|
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)
- classmethod BulletinA.update(cls) None#
Download and parse the latest IERS Bulletin A data, then cache it.
- This method:
Fetches the raw bulletin text from the remote URL in cls.url.
Streams the response to a temporary file.
Parses each line via _stream_data_from_file, extracting numeric fields.
Applies unit conversions to SI: - arcseconds → radians (polar motion) - milliseconds → seconds (LOD) - milliarcseconds → radians (nutation)
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!