Constellation Design – ephemerista.constellation.design

The design.py module.

This module provides several classes for modelling various types of satellite constellations.

class ephemerista.constellation.design.AbstractConstellation(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time)

Abstract base class for all constellation types.

abstractmethod define_satellites()

Return a list of Keplerian objects that define the constellation’s satellites.

Return type:

dict[str, Keplerian]

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].

property satellites: dict[str, Keplerian]

Method to return the satellites to the user, with results cached for future gets.

to_dataframe(data='satellites')

Return a dataframe of the Keplerian elements of each satellite.

Parameters:

data (str) – Flag to return plane or satellite data. Defaults to “satellites”

Returns:

Dataframe of Keplerian elements of each satellite

Return type:

DataFrame

class ephemerista.constellation.design.AbstractWalker(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time, nsats, nplanes, semiMajorAxis, eccentricity, phasing=0)

Abstract base class for Walker Star or Delta constellations.

define_planes()

Generate constellation planes based on the user-provided parameters.

Return type:

dict[int, Plane]

define_satellites()

Generate constellation satellites based on the user-provided parameters.

Return type:

dict[str, Keplerian]

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.constellation.design.AbstractWalkerOrSocConstellation(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time, nsats, nplanes, semiMajorAxis, eccentricity)

Abstract base class for Walker or streets-of-coverage constellations.

abstractmethod define_planes()

Return a list of Plane objects that define the constellation.

Return type:

dict[int, Plane]

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].

property planes: dict[int, Plane]

Method to return the planes to the user, with results cached for future gets.

to_dataframe(data='planes')

Return a data frame of the constellation parameters.

This will either be the Keplerian elements of each plane in the constellation, or the satellites in each plane, depending on the input.

Parameters:

data (str) – Flag to return plane or satellite data. Defaults to “planes”

Returns:

Dataframe of Keplerian elements of each constellation, or the satellites in each plane, depending on the input

Return type:

DataFrame

class ephemerista.constellation.design.Constellation(*, id=<factory>, model, name='Default Constellation', propagator='semi-analytical', params=OrekitPropagatorParams(prop_min_step=0.001, prop_max_step=3600.0, prop_init_step=60.0, prop_position_error=10.0, mass=1000.0, cross_section=1.0, grav_degree_order=(4, 4), third_bodies=[], c_r=0.75, enable_srp=False, c_d=2.0, enable_drag=False), comms=[])

The main class for modelling constellations.

property assets: list[Asset]

list of spacecraft of the constellation.

Type:

list[Asset]

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.constellation.design.Flower(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time, type='flower', perigeeAltitude, nPetals, nDays, nsats, phasingN, phasingD)

The Flower class.

This class models a Flower constellation.

References

[1] M. P. Wilkins, The Flower Constellations: Theory, design process, and applications. Texas A&M University, 2004. https://search.proquest.com/openview/d2a1245a4defb3f086c797b56e1a5b22/1?pq-origsite=gscholar&cbl=18750&diss=y

[2] https://gitlab.com/open-galactic/satellite-constellation

define_satellites()

Return a list of Keplerian objects that define the constellation’s satellites.

Return type:

dict[str, Keplerian]

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.constellation.design.StreetOfCoverage(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time, nsats, nplanes, semiMajorAxis, eccentricity, type='street_of_coverage', coverage_fold=1)

The StreetOfCoverage class.

This class models a streets-of-coverage constellation.

References

[1] S. Huang, C. Colombo, and F. Bernelli-Zazzera,

“Multi-criteria design of continuous global coverage Walker and Street-of-Coverage constellations through property assessment” Acta Astronautica, vol. 188, pp. 151-170, Nov. 2021, doi: 10.1016/j.actaastro.2021.07.002.

define_planes()

Return a list of Plane objects that define the constellation.

Return type:

dict[int, Plane]

define_satellites()

Return a list of Keplerian objects that define the constellation’s satellites.

Return type:

dict[str, Keplerian]

get_nu_bounds()

Compute initial bounds of the central angle of coverage in radians.

Return type:

tuple[float, 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].

class ephemerista.constellation.design.WalkerDelta(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time, nsats, nplanes, semiMajorAxis, eccentricity, phasing=0, type='walker_delta')

The WalkerDelta class.

This class models a Walker Delta constellation.

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.constellation.design.WalkerStar(*, inclination, periapsisArgument, name='My Constellation', origin=Origin(name='Earth'), time, nsats, nplanes, semiMajorAxis, eccentricity, phasing=0, type='walker_star')

The WalkerStar class.

This class models a Walker Star constellation.

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].

ephemerista.constellation.design.c_j(nu, s, j)

Compute the minimum half-width of Street-of-Coverage required for j-fold continuous global coverage.

Parameters:
  • nu (float) – Central angle of coverage in radians, variable that will be optimized

  • s (float) – number of satellites per plane

  • j (int) – coverage fold

Return type:

float

Ref: Equation 3 of [1]