Earth Orientation Parameters¶
The Earth Orientation Parameters (EOP) — UT1 − UTC, polar motion, the excess
length of day and the celestial pole offsets — come from the IERS
finals2000A.all table (Bulletin A): observed values from 1973, then about a
year of predictions. They feed UT1 and every ITRF frame transform.
satkit.eop mirrors satkit.spaceweather: use
coverage and status to find
out where an epoch falls before relying on the result (see
Data coverage), and
init_from_path to pin satkit to a
finals2000A.all file of your own.
import satkit as sk
t = sk.time(2024, 1, 1)
print(sk.eop.status(t)) # "observed"
dut1, xp, yp, lod, dx, dy = sk.eop.get(t)
first, last_observed, last = sk.eop.coverage()
The older names in satkit.frametransform
(earth_orientation_params, eop_coverage, eop_status) remain and return
the same values; frametransform.disable_eop_time_warning silences the
one-time EOP warnings.
eop
¶
Earth Orientation Parameters (EOP)
The IERS finals2000A.all table (Bulletin A: observed values, then about a
year of predictions) behind UT1 and the ITRF frame transforms: UT1 - UTC,
polar motion, excess length of day and the celestial pole offsets. The table
is loaded from the data directory on first use and refreshed by update or
satkit.utils.update_datafiles.
These functions mirror satkit.spaceweather. The EOP functions in
satkit.frametransform (earth_orientation_params, eop_coverage,
eop_status, disable_eop_time_warning) remain.
get(time)
¶
Earth Orientation Parameters at the given time
Interpolated linearly between the two bracketing daily rows of the IERS
finals2000A.all table. Same values as
satkit.frametransform.earth_orientation_params.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time
|
time | datetime | datetime64
|
Time at which to
query the parameters (a single time; a list, even of one element,
raises |
required |
Returns:
| Type | Description |
|---|---|
float, float, float, float, float, float) | None
|
tuple with elements or None before the table's first row (1973-01-02) or when no table is
loaded. After the last row the last row's values are returned
unchanged; |
Raises:
| Type | Description |
|---|---|
TypeError
|
If |
coverage()
¶
Time bounds of the loaded Earth Orientation Parameters table
Returns:
| Type | Description |
|---|---|
tuple[time, time, time] | None
|
|
status(time)
¶
Where a time falls relative to the loaded Earth Orientation Parameters table
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
time
|
time | datetime | datetime64
|
Time to classify (a
single time; a list, even of one element, raises |
required |
Returns:
| Type | Description |
|---|---|
str
|
One of |
Raises:
| Type | Description |
|---|---|
TypeError
|
If |
update()
¶
Refresh the Earth Orientation Parameters file and reload the table
Downloads IERS finals2000A.all into the data directory unless the
copy there was fetched within the last 24 hours, then loads it. Run this
(or satkit.utils.update_datafiles) periodically for current values.
Raises:
| Type | Description |
|---|---|
RuntimeError
|
If the data directory is not writable, the download fails, or the downloaded file cannot be read |
init_from_path(path)
¶
Load the Earth Orientation Parameters table from a file, replacing whatever is loaded
The file must be an IERS finals2000A.all (Bulletin A) file. From the
next call on, everything that reads EOP (the ITRF frame transforms, UT1,
the propagators) uses this table. This is how to pin satkit to one fixed
input file when a comparison must not move with the daily refresh. The
one-time warnings are not re-armed for the new table.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
path
|
str | PathLike
|
File to load |
required |
Raises:
| Type | Description |
|---|---|
FileNotFoundError
|
If the file does not exist (other read failures
raise the matching |
RuntimeError
|
If the file is not a valid |
init_from_bytes(data)
¶
Load the Earth Orientation Parameters table from bytes, replacing whatever is loaded
Same format and effect as init_from_path.
Parameters:
| Name | Type | Description | Default |
|---|---|---|---|
data
|
bytes
|
File contents |
required |
Raises:
| Type | Description |
|---|---|
RuntimeError
|
If the bytes are not a valid |