Assets – ephemerista.assets

The assets.py module.

This module provides models for space and ground assets.

class ephemerista.assets.Asset(*, id=<factory>, name='Asset', model, comms=[], trackedObjectIds=[], trackedConstellationIds=[], constellationId=None, pointingError=0.1)

The Asset model.

This class is composed of a Spacecraft or GroundStation model and adds additional metadata and subsystem models.

comms_by_channel_id(channel_id)

Return the comms system associated to a given channel.

Return type:

CommunicationSystem | None

is_tracking(asset_id)

Check if this asset is tracking the given asset ID directly.

Return type:

bool

model_config: ClassVar[ConfigDict] = {'alias_generator': <function to_camel>, 'populate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

track(asset_ids=None, constellation_ids=None)

Track one or more assets and/or constellations.

Parameters:
  • asset_ids (Union[UUID, list[UUID], None]) – Asset IDs to track

  • constellation_ids (Union[UUID, list[UUID], None]) – Constellation IDs to track

class ephemerista.assets.GroundLocation(location=None, mask=None, *, body=Origin(name='Earth'), longitude, latitude, altitude=0, minimumElevation=Angle(degrees=0.0), polygonIds=[])

The GroundLocation model.

classmethod from_lla(longitude, latitude, **data)

Construct a GroundLocation from geodetic coordinates.

Return type:

Self

get_minimum_elevation(azimuth)

Return the minimum elevation for a given azimuth.

Return type:

float

model_config: ClassVar[ConfigDict] = {'alias_generator': <function to_camel>, 'populate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

observables(target)

Return the modelled observables for a given spacecraft state.

Return type:

Observables

observables_batch(targets)

Return the modelled observables for multiple spacecraft states.

Parameters:

targets (list[Cartesian]) – List of spacecraft states

Returns:

List of observables for each target state

Return type:

list[Observables]

propagate(time)

Propagate the ground station state.

Overloads:
Parameters:

time (Time | list[Time]) – Either a single Time or a list of Times.

Returns:

Either a single Cartesian state for a discrete input or a Trajectory for a list.

Return type:

Cartesian or Trajectory

rotation_to_topocentric()

Return the rotation matrix to the SEZ frame.

Return type:

ndarray

class ephemerista.assets.GroundStation(location=None, mask=None, *, body=Origin(name='Earth'), longitude, latitude, altitude=0, minimumElevation=Angle(degrees=0.0), polygonIds=[], type='groundstation')

The GroundStation model.

model_config: ClassVar[ConfigDict] = {'alias_generator': <function to_camel>, 'populate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class ephemerista.assets.Observables(*, azimuth, elevation, rng, rngRate)

The Observables model.

This class models a single observation of a spacecraft from a ground station.

model_config: ClassVar[ConfigDict] = {'alias_generator': <function to_camel>, 'populate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

class ephemerista.assets.Spacecraft(*, type='spacecraft', propagator)

The Spacecraft model.

model_config: ClassVar[ConfigDict] = {'alias_generator': <function to_camel>, 'populate_by_name': True}

Configuration for the model, should be a dictionary conforming to [ConfigDict][pydantic.config.ConfigDict].

propagate(time)

Propagate the spacecraft state.

Overloads:
Parameters:

time (Time | list[Time]) – Either a single Time or a list of Times.

Returns:

Either a single Cartesian state for a discrete input or a Trajectory for a list.

Return type:

Cartesian or Trajectory