torque

None

Functions

aerodynamic()

Creates the settings for the aerodynamic torque.

spherical_harmonic_gravitational(…)

Creates the settings for the spherical harmonic torque.

second_degree_gravitational()

Creates the settings for the second-degree gravitational torque.

custom(torque_function, …)

Creates the settings for a custom torque.

aerodynamic() tudatpy.kernel.simulation.propagation_setup.torque.TorqueSettings

Creates the settings for the aerodynamic torque.

Creates the settings for the aerodynamic torque exerted by a body with an atmosphere model and shape model on another body. The body exerting the torque needs to have both an atmosphere model and a shape model defined. Furthermore, the body undergoing the torque needs to have the aerodynamic coefficient interface and its moment coefficients defined. In the case that the aerodynamic coefficients are defined as a function of the vehicle orientation (e.g. angle of attack and sideslip angle), these angles can be manually or automatically defined.

Returns

Torque settings object.

Return type

TorqueSettings

spherical_harmonic_gravitational(maximum_degree: int, maximum_order: int) tudatpy.kernel.simulation.propagation_setup.torque.TorqueSettings

Creates the settings for the spherical harmonic torque.

Torque exerted by a point mass on a body with an arbitrary degree/order spherical harmonics mass distribution. The body exerting the torque only needs to have a gravitational model defined (point-mass or spherical harmonic), while the body undergoing the torque needs to have a spherical harmonic gravity field defined.

Parameters
  • maximum_degree (int) – Maximum degree of the spherical harmonic expansion.

  • maximum_order (int) – Maximum order of the spherical harmonic expansion.

Returns

Torque settings object.

Return type

TorqueSettings

second_degree_gravitational() tudatpy.kernel.simulation.propagation_setup.torque.TorqueSettings

Creates the settings for the second-degree gravitational torque.

Torque exerted by a point mass on a body with a degree two spherical harmonics mass distribution. A degree two spherical harmonics mass distribution can be represented by an inertia tensor; thus, for this torque model, the body undergoing the torque needs to have an inertia tensor defined. The body exerting the torque only needs to have a gravitational model defined (either point-mass or spherical harmonics).

Returns

Torque settings object.

Return type

TorqueSettings

custom(torque_function: Callable[[float], numpy.ndarray[numpy.float64[3, 1]]], scaling_function: Callable[[float], float] = None) tudatpy.kernel.simulation.propagation_setup.torque.TorqueSettings

Creates the settings for a custom torque.

Torque exerted by a point mass on a body with a degree two spherical harmonics mass distribution. A degree two spherical harmonics mass distribution can be represented by an inertia tensor; thus, for this torque model, the body undergoing the torque needs to have an inertia tensor defined. The body exerting the torque only needs to have a gravitational model defined (either point-mass or spherical harmonics).

Parameters
  • torque_function (Callable[[float], list]) – Custom torque function with time as an independent variable.

  • scaling_function (Callable[[float], float], default=None) – Scaling function with time as an independent variable to be multiplied by the custom torque function.

Returns

Torque settings object.

Return type

TorqueSettings

Classes

class TorqueSettings

Functional base class to define settings for torques.

class SphericalHarmonicTorqueSettings

TorqueSettings-derived class to define settings for torques caused by spherical harmonic gravity.