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
Assetmodel.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 trackconstellation_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
GroundLocationmodel.- 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_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:
time (
list[Time]) →Trajectory
- 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:
- 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
GroundStationmodel.- 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
Observablesmodel.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
Spacecraftmodel.- 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:
time (
list[Time]) →Trajectory
- 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: