Earth Orientation Parameters (EOP) Module

Earth orientation parameter data management and access.

eop

Earth Orientation Parameters (EOP) Module

Earth orientation parameter data management and access.

This module provides: - EOP data providers (static built-in data and file-based data) - EOP data download utilities (IERS C04 and standard files) - Global EOP provider management - Access to UT1-UTC, polar motion, and length-of-day data

EOP data is required for high-precision reference frame transformations between ECI (Earth-Centered Inertial) and ECEF (Earth-Centered Earth-Fixed) frames.

download_c04_eop_file builtin

download_c04_eop_file(filepath: str) -> None

Download latest C04 Earth orientation parameter file. Will attempt to download the latest parameter file to the specified location. Creating any missing directories as required.

The download source is the IERS Earth Orientation Data Products

Parameters:

Name	Type	Description	Default
filepath	str	Path of desired output file	required

download_standard_eop_file builtin

download_standard_eop_file(filepath: str) -> None

Download latest standard Earth orientation parameter file. Will attempt to download the latest parameter file to the specified location. Creating any missing directories as required.

The download source is the IERS Earth Orientation Data Products

Parameters:

Name	Type	Description	Default
filepath	str	Path of desired output file	required

get_global_dxdy builtin

get_global_dxdy(mjd: float) -> tuple[float, float]

Get celestial pole offsets from the global EOP provider.

Parameters:

Name	Type	Description	Default
mjd	float	Modified Julian Date	required

Returns:

Type	Description
tuple[float, float]	tuple[float, float]: Celestial pole offsets dx and dy in radians

get_global_eop builtin

get_global_eop(mjd: float) -> tuple[float, float, float, float, float, float]

Get all EOP parameters from the global EOP provider.

Parameters:

Name	Type	Description	Default
mjd	float	Modified Julian Date	required

Returns:

Type	Description
tuple[float, float, float, float, float, float]	tuple[float, float, float, float, float, float]: UT1-UTC, pm_x, pm_y, dx, dy, lod

get_global_eop_extrapolation builtin

get_global_eop_extrapolation() -> str

Get the extrapolation method of the global EOP provider.

Returns:

Name	Type	Description
str	str	Extrapolation method string

get_global_eop_initialization builtin

get_global_eop_initialization() -> bool

Check if the global EOP provider is initialized.

Returns:

Name	Type	Description
bool	bool	True if global EOP provider is initialized

get_global_eop_interpolation builtin

get_global_eop_interpolation() -> bool

Check if interpolation is enabled in the global EOP provider.

Returns:

Name	Type	Description
bool	bool	True if interpolation is enabled

get_global_eop_len builtin

get_global_eop_len() -> int

Get the number of EOP data points in the global provider.

Returns:

Name	Type	Description
int	int	Number of EOP data points

get_global_eop_mjd_last_dxdy builtin

get_global_eop_mjd_last_dxdy() -> float

Get the last Modified Julian Date with dx/dy data in the global provider.

Returns:

Name	Type	Description
float	float	Last MJD with dx/dy data

get_global_eop_mjd_last_lod builtin

get_global_eop_mjd_last_lod() -> float

Get the last Modified Julian Date with LOD data in the global provider.

Returns:

Name	Type	Description
float	float	Last MJD with LOD data

get_global_eop_mjd_max builtin

get_global_eop_mjd_max() -> float

Get the maximum Modified Julian Date in the global EOP dataset.

Returns:

Name	Type	Description
float	float	Maximum MJD

get_global_eop_mjd_min builtin

get_global_eop_mjd_min() -> float

Get the minimum Modified Julian Date in the global EOP dataset.

Returns:

Name	Type	Description
float	float	Minimum MJD

get_global_eop_type builtin

get_global_eop_type() -> str

Get the EOP data type of the global provider.

Returns:

Name	Type	Description
str	str	EOP type string

get_global_lod builtin

get_global_lod(mjd: float) -> float

Get length of day offset from the global EOP provider.

Parameters:

Name	Type	Description	Default
mjd	float	Modified Julian Date	required

Returns:

Name	Type	Description
float	float	Length of day offset in seconds

get_global_pm builtin

get_global_pm(mjd: float) -> tuple[float, float]

Get polar motion components from the global EOP provider.

Parameters:

Name	Type	Description	Default
mjd	float	Modified Julian Date	required

Returns:

Type	Description
tuple[float, float]	tuple[float, float]: Polar motion x and y components in radians

get_global_ut1_utc builtin

get_global_ut1_utc(mjd: float) -> float

Get UT1-UTC time difference from the global EOP provider.

Parameters:

Name	Type	Description	Default
mjd	float	Modified Julian Date	required

Returns:

Name	Type	Description
float	float	UT1-UTC time difference in seconds

set_global_eop_provider_from_file_provider builtin

set_global_eop_provider_from_file_provider(provider: FileEOPProvider) -> None

Set the global EOP provider using a file-based provider.

Parameters:

Name	Type	Description	Default
provider	FileEOPProvider	File-based EOP provider to set globally	required

set_global_eop_provider_from_static_provider builtin

set_global_eop_provider_from_static_provider(provider: StaticEOPProvider) -> None

Set the global EOP provider using a static provider.

Parameters:

Name	Type	Description	Default
provider	StaticEOPProvider	Static EOP provider to set globally	required