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.
- 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 optimizeds (
float) – number of satellites per planej (
int) – coverage fold
- Return type:
float
Ref: Equation 3 of [1]