StaticEOPProvider¶

Module: brahe.eop

Built-in Earth Orientation Parameters for testing and offline use.

StaticEOPProvider ¶

StaticEOPProvider()

Static Earth Orientation Parameter provider with constant values.

Provides EOP data using fixed values that don't change with time. Useful for testing or scenarios where time-varying EOP data is not needed.

Example

import brahe as bh

# Create static EOP provider with default values
eop = bh.StaticEOPProvider()

# Create static EOP provider with zero values
eop_zero = bh.StaticEOPProvider.from_zero()

# Create with custom values
eop_custom = bh.StaticEOPProvider.from_values(0.1, 0.0, 0.0, 0.0, 0.0, 0.0)

# Set as global provider
bh.set_global_eop_provider_from_static_provider(eop_custom)

Initialize instance.

eop_type `method descriptor` ¶

eop_type() -> str

Get the EOP data type.

Returns:

Name	Type	Description
`str`	`str`	EOP type string

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"EOP type: {eop.eop_type()}")

extrapolation `method descriptor` ¶

extrapolation() -> str

Get the extrapolation method.

Returns:

Name	Type	Description
`str`	`str`	Extrapolation method string

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Extrapolation method: {eop.extrapolation()}")

from_values `builtin` ¶

from_values(ut1_utc: float, pm_x: float, pm_y: float, dx: float, dy: float, lod: float) -> StaticEOPProvider

Create a static EOP provider with specified values.

Parameters:

Name	Type	Description	Default
`ut1_utc`	`float`	UT1-UTC time difference in seconds	required
`pm_x`	`float`	Polar motion x-component in radians	required
`pm_y`	`float`	Polar motion y-component in radians	required
`dx`	`float`	Celestial pole offset dx in radians	required
`dy`	`float`	Celestial pole offset dy in radians	required
`lod`	`float`	Length of day offset in seconds	required

Returns:

Name	Type	Description
`StaticEOPProvider`	`StaticEOPProvider`	Provider with specified EOP values

Example

import brahe as bh

# Create EOP provider with custom values
eop = bh.StaticEOPProvider.from_values(
    ut1_utc=0.1,
    pm_x=1e-6,
    pm_y=2e-6,
    dx=1e-7,
    dy=1e-7,
    lod=0.001
)
bh.set_global_eop_provider_from_static_provider(eop)

from_zero `builtin` ¶

from_zero() -> StaticEOPProvider

Create a static EOP provider with all values set to zero.

Returns:

Name	Type	Description
`StaticEOPProvider`	`StaticEOPProvider`	Provider with all EOP values set to zero

Example

import brahe as bh

# Create EOP provider with all zeros (no corrections)
eop = bh.StaticEOPProvider.from_zero()
bh.set_global_eop_provider_from_static_provider(eop)

get_dxdy `method descriptor` ¶

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

Get celestial pole offsets for a given MJD.

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

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
dx, dy = eop.get_dxdy(58849.0)
print(f"Celestial pole offsets: dx={dx} rad, dy={dy} rad")

get_eop `method descriptor` ¶

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

Get all EOP parameters for a given MJD.

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

Example

import brahe as bh

eop = bh.StaticEOPProvider()
ut1_utc, pm_x, pm_y, dx, dy, lod = eop.get_eop(58849.0)
print(f"EOP: UT1-UTC={ut1_utc}s, PM=({pm_x},{pm_y})rad")

get_lod `method descriptor` ¶

get_lod(mjd: float) -> float

Get length of day offset for a given MJD.

Parameters:

Name	Type	Description	Default
`mjd`	`float`	Modified Julian Date	required

Returns:

Name	Type	Description
`float`	`float`	Length of day offset in seconds

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
lod = eop.get_lod(58849.0)
print(f"Length of day offset: {lod} seconds")

get_pm `method descriptor` ¶

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

Get polar motion components for a given MJD.

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

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
pm_x, pm_y = eop.get_pm(58849.0)
print(f"Polar motion: x={pm_x} rad, y={pm_y} rad")

get_ut1_utc `method descriptor` ¶

get_ut1_utc(mjd: float) -> float

Get UT1-UTC time difference for a given MJD.

Parameters:

Name	Type	Description	Default
`mjd`	`float`	Modified Julian Date	required

Returns:

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

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
ut1_utc = eop.get_ut1_utc(58849.0)
print(f"UT1-UTC: {ut1_utc} seconds")

interpolation `method descriptor` ¶

interpolation() -> bool

Check if interpolation is enabled.

Returns:

Name	Type	Description
`bool`	`bool`	True if interpolation is enabled

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Interpolation enabled: {eop.interpolation()}")

is_empty `method descriptor` ¶

is_empty() -> bool

Check if the provider contains no EOP data points.

Returns:

Name	Type	Description
`bool`	`bool`	True if the provider has no EOP data points

is_initialized `method descriptor` ¶

is_initialized() -> bool

Check if the provider is initialized.

Returns:

Name	Type	Description
`bool`	`bool`	True if initialized

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Is initialized: {eop.is_initialized()}")

len `method descriptor` ¶

len() -> int

Get the number of EOP data points.

Returns:

Name	Type	Description
`int`	`int`	Number of EOP data points

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"EOP data points: {eop.len()}")

mjd_last_dxdy `method descriptor` ¶

mjd_last_dxdy() -> float

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

Returns:

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

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Last MJD with dx/dy: {eop.mjd_last_dxdy()}")

mjd_last_lod `method descriptor` ¶

mjd_last_lod() -> float

Get the last Modified Julian Date with LOD data.

Returns:

Name	Type	Description
`float`	`float`	Last MJD with LOD data

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Last MJD with LOD: {eop.mjd_last_lod()}")

mjd_max `method descriptor` ¶

mjd_max() -> float

Get the maximum Modified Julian Date in the dataset.

Returns:

Name	Type	Description
`float`	`float`	Maximum MJD

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Maximum MJD: {eop.mjd_max()}")

mjd_min `method descriptor` ¶

mjd_min() -> float

Get the minimum Modified Julian Date in the dataset.

Returns:

Name	Type	Description
`float`	`float`	Minimum MJD

Example

import brahe as bh

eop = bh.StaticEOPProvider.from_zero()
print(f"Minimum MJD: {eop.mjd_min()}")

StaticEOPProvider¶