Skip to content

Earth Orientation Parameters API

EarthOrientationData(mjds, xpoles, ypoles, ut1dutcs, dpsis, depss, final_date_range, predicted_date_range=None)

Bases: Module

Interpolation container for Earth Orientation Parameter (EOP) data.

Parameters:

Name Type Description Default
tt_jds Float[Array, n]

Sample JD values in TT.

required
xpoles Float[Array, n]

Polar-motion coordinate xp in arcseconds.

required
ypoles Float[Array, n]

Polar-motion coordinate yp in arcseconds.

required
ut1dutcs Float[Array, n]

UT1-UTC offsets in seconds.

required
ut1dtts Float[Array, n]

UT1-TT offsets in seconds.

required
dpsis Float[Array, n]

Additive dPsi correction to the model nutation in longitude, in arcseconds.

required
depss Float[Array, n]

Additive dEps correction to the model nutation in obliquity, in arcseconds.

required
final_date_range Float[Array, 2]

Covered time range of the final data.

required
predicted_date_range Optional[Float[Array, 2]]

Covered time range of the predicted data, if present.

None

xpole(tt_jd1, tt_jd2)

Interpolate the polar-motion coordinate xp.

Parameters:

Name Type Description Default
tt_jd1 Float[Array, '']

Split Julian date of the UTC epoch.

required
tt_jd2 Float[Array, '']

Split Julian date of the UTC epoch.

required

Returns:

Type Description
Float[Array, ...]

Interpolated value in arcseconds.

ypole(tt_jd1, tt_jd2)

Interpolate the polar-motion coordinate yp.

Parameters:

Name Type Description Default
tt_jd1 Float[Array, '']

Split Julian date of the UTC epoch.

required
tt_jd2 Float[Array, '']

Split Julian date of the UTC epoch.

required

Returns:

Type Description
Float[Array, ...]

Interpolated value in arcseconds.

ut1dtt(tt_jd1, tt_jd2)

Interpolate the UT1-TT offset.

Parameters:

Name Type Description Default
tt_jd1 Float[Array, '']

Split Julian date of the UTC epoch.

required
tt_jd2 Float[Array, '']

Split Julian date of the UTC epoch.

required

Returns:

Type Description
Float[Array, ...]

Interpolated value in seconds.

ut1dutc(tt_jd1, tt_jd2)

Interpolate the UT1-UTC offset.

Parameters:

Name Type Description Default
tt_jd1 Float[Array, '']

Split Julian date of the UTC epoch.

required
tt_jd2 Float[Array, '']

Split Julian date of the UTC epoch.

required

Returns:

Type Description
Float[Array, ...]

Interpolated value in seconds.

cor_delta_longitude(tt_jd1, tt_jd2)

Interpolate the additive dPsi correction to nutation in longitude.

Parameters:

Name Type Description Default
tt_jd1 Float[Array, '']

Split Julian date of the UTC epoch.

required
tt_jd2 Float[Array, '']

Split Julian date of the UTC epoch.

required

Returns:

Type Description
Float[Array, ...]

Interpolated value in arcseconds.

cor_delta_obliquity(tt_jd1, tt_jd2)

Interpolate the additive dEps correction to nutation in obliquity.

Parameters:

Name Type Description Default
tt_jd1 Float[Array, '']

Split Julian date of the UTC epoch.

required
tt_jd2 Float[Array, '']

Split Julian date of the UTC epoch.

required

Returns:

Type Description
Float[Array, ...]

Interpolated value in arcseconds.

load_default_eop_file()

Return the cached default EOP table without performing network access.

load_iers_eopc04 = _eop_loaders.load_iers_eopc04 module-attribute

update_eop()

Download the latest default EOP table and replace the cached table.