shape
¶
This module contains a set of factory functions for setting up the shape models of celestial bodies in an environment.
Functions¶

Factory function for creating spherical body shape model settings. 
Factory function for creating spherical body shape model settings entirely from spice. 


Factory function for creating oblate spherical body shape model settings. 

Factory function for creating a polyhedron body shape model settings. 

Factory function for creating hybrid body shape model settings. 
 spherical(radius: float) tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings ¶
Factory function for creating spherical body shape model settings.
Factory function for settings object, defining strictly spherical body shape model entirely from single radius parameter.
 Parameters:
radius (float) – Radius specifying spherical body shape.
 Returns:
Instance of the
BodyShapeModel
derivedSphericalBodyShapeSettings
class Return type:
Examples
In this example, we create a
BodyShapeModel
using a perfectly spherical shape model:# define parameters describing perfectly spherical model body_radius = 6378.0E3 # create shape model settings body_settings.get( "Earth" ).shape_settings = environment_setup.shape.spherical( body_radius )
 spherical_spice() tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings ¶
Factory function for creating spherical body shape model settings entirely from spice.
Factory function for settings object, defining spherical body shape model entirely from spice parameters.
 Returns:
Instance of
BodyShapeModel
class Return type:
Examples
In this example, we create a
BodyShapeModel
using a perfectly spherical shape model and data from Spice:# create shape model settings body_settings.get( "Earth" ).shape_settings = environment_setup.shape.spherical_spice( )
 oblate_spherical(equatorial_radius: float, flattening: float) tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings ¶
Factory function for creating oblate spherical body shape model settings.
Factory function for settings object, defining oblate spherical body shape model from equatorial radius and flattening parameter.
 Parameters:
 Returns:
Instance of the
BodyShapeModel
derivedOblateSphericalBodyShapeSettings
class Return type:
Examples
In this example, we create a
BodyShapeModel
using a perfectly oblate spherical shape model:# define parameters describing oblate spherical model body_radius = 6378.0E3 body_flattening = 1.0 / 300.0 # create shape model settings body_settings.get( "Earth" ).shape_settings = environment_setup.shape.oblate_spherical( body_radius, body_flattening )
 polyhedron(vertices_coordinates: numpy.ndarray[numpy.float64[m, n]], vertices_defining_each_facet: numpy.ndarray[numpy.int32[m, n]], compute_altitude_with_sign: bool = True, just_compute_distance_to_vertices: bool = False) tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings ¶
Factory function for creating a polyhedron body shape model settings.
Factory function for settings object, defining a polyhedron shape model.
Note 1: The evaluation of the altitude with a polyhedron model tends to be computationally expensive. To reduce the computational time, it might be useful to instead define a hybrid shape model (see
hybrid()
), which allows using a highresolution polyhedron (with a large number of facets) at low altitudes and a lowresolution one (with smaller number of facets) at highaltitudes.Note 2: If the goal of using the shape model is only to detect collisions with the surface and not to explicitly obtain the altitude, it is instead recommended to use the Laplacian of the gravitational potential (see
gravity_field_laplacian_of_potential()
). This allows reducing the computational time, but is only valid if the same polyhedron model that is used to define the gravitational acceleration should also be used to detect the impacts. Parameters:
vertices_coordinates (numpy.ndarray) – Cartesian coordinates of each polyhedron vertex. Entry (i,j) denotes vertex i, coordinate j (one row per vertex, 3 columns).
vertices_defining_each_facet (numpy.ndarray) – Index (0 based) of the vertices constituting each facet. Entry (i,j) denotes facet i, and the jth vertex of the facet (one row per facet, 3 columns). In each row, the vertices’ indices should be ordered counterclockwise when seen from the outside of the polyhedron.
compute_altitude_with_sign (bool, default=True) – Flag indicating whether the altitude should be computed with sign (i.e. >0 if above surface, <0 otherwise) or having always a positive value. If the the sign of the altitude is not relevant, then setting it to false is recommended, as it reduces the CPU time.
just_compute_distance_to_vertices (bool, default=False) – Flag indicating whether the altitude should be computed just with respect to the polyhedron vertices (if flag is set to true) or to all polyhedron features (vertices, facets and edges; happens if flag is set to false). Depending on the application, it might be useful to set the flag to true for medium to high altitudes, as it allows significantly reducing the CPU time (the resulting altitude errors depend on the resolution of the used polyhedron and altitude itself).
 Returns:
Instance of the
BodyShapeModel
derivedPolyhedronBodyShapeSettings
class Return type:
 hybrid(low_resolution_body_shape_settings: tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings, high_resolution_body_shape_settings: tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings, switchover_altitude: float) tudatpy.kernel.numerical_simulation.environment_setup.shape.BodyShapeSettings ¶
Factory function for creating hybrid body shape model settings.
Factory function for settings object, defining a hybrid shape model.
The hybrid shape model is constituded by two shape models: a lowresolution model which is used at high altitudes (above the switchover altitude) and a highresolution model used at low altitudes (below the switchover altitude). In each computation of the altitude, the altitude is first computed with the lowresolution model. The lowresolution altitude is then compared to the switchover altitude to decide whether to compute the highresolution altitude.
The hybrid shape model is useful when the evaluation of the highresolution model is computationally expensive (e.g. polyhedron model).
 Parameters:
low_resolution_body_shape_settings (BodyShapeSettings) – Settings of the shape model that is to be used to compute the altitude at high altitudes (above the switchover altitude).
high_resolution_body_shape_settings (BodyShapeSettings) – Settings of the shape model that is to be used to compute the altitude at low altitudes (below the switchover altitude).
switchover_altitude (float) – Altitude at which the model used to compute the altitude is changed. The highresolution model is used for altitudes below the switchover altitude, the lowresolution model for altitudes above it.
 Returns:
Instance of the
BodyShapeModel
derivedHybridBodyShapeSettings
class Return type:
Classes¶
Base class for providing settings for body shape model. 

Class for defining model settings of a strictly spherical body shape. 

Class for defining model settings of a oblate spherical body shape. 

Class for defining model settings of a polyhedron body shape. 

Class for defining model settings of a hybrid body shape. 
 class BodyShapeSettings¶
Base class for providing settings for body shape model.
Functional (base) class for settings of body shape models that require no information in addition to their type. Body shape model settings requiring additional information must be defined using an object derived from this class.
 class SphericalBodyShapeSettings¶
Class for defining model settings of a strictly spherical body shape.
BodyShapeSettings derived class for strictly spherical body shape model settings.
 class OblateSphericalBodyShapeSettings¶
Class for defining model settings of a oblate spherical body shape.
BodyShapeSettings derived class for oblate spherical body shape model settings.
 property equatorial_radius¶
readonly
Equatorial radius of the oblate spherical body shape.
 Type:
 class PolyhedronBodyShapeSettings¶
Class for defining model settings of a polyhedron body shape.
BodyShapeSettings derived class for polyhedron body shape model settings.
 property compute_altitude_with_sign¶
Flag indicating whether the altitude should be computed with sign (i.e. >0 if above surface, <0 otherwise) or having always a positive value. If the the sign of the altitude is not relevant, then setting it to false is recommended, as it reduces the CPU time for computing the altitude.
 Type:
bool, default=True
 property just_compute_distance_to_vertices¶
Flag indicating whether the altitude should be computed just with respect to the polyhedron vertices (if flag is set to true) or to all polyhedron features (vertices, facets and edges; happens if flag is set to false). Depending on the application, it might be useful to set the flag to true for medium to high altitudes, as it allows significantly reducing the CPU time (the resulting altitude errors depend on the resolution of the used polyhedron and altitude itself).
 Type:
bool, default=False
 property vertices_coordinates¶
Cartesian coordinates of each polyhedron vertex. Entry (i,j) denotes vertex i, coordinate j (one row per vertex, 3 columns).
 Type:
 property vertices_defining_each_facet¶
Index (0 based) of the vertices constituting each facet. Entry (i,j) denotes facet i, and the jth vertex of the facet (one row per facet, 3 columns). In each row, the vertices’ indices should be ordered counterclockwise when seen from the outside of the polyhedron.
 Type:
 class HybridBodyShapeSettings¶
Class for defining model settings of a hybrid body shape.
BodyShapeSettings derived class for hybrid body shape model settings.
 property high_resolution_body_shape_settings¶
No documentation found.
 property low_resolution_body_shape_settings¶
No documentation found.
 property switchover_altitude¶
No documentation found.