space_ex v0.1.1 SpaceEx.SpaceCenter.Thruster

The component of an SpaceEx.SpaceCenter.Engine or SpaceEx.SpaceCenter.RCS part that generates thrust.

Can obtained by calling SpaceEx.SpaceCenter.Engine.get_thrusters/2 or SpaceEx.SpaceCenter.RCS.get_thrusters/2.

Engines can consist of multiple thrusters. For example, the S3 KS-25x4 "Mammoth" has four rocket nozzels, and so consists of four thrusters.

Link to this section Summary

Functions

The current gimbal angle in the pitch, roll and yaw axes, in degrees

Whether the thruster is gimballed

The SpaceEx.SpaceCenter.Part that contains this thruster

A reference frame that is fixed relative to the thruster and orientated with its thrust direction (SpaceEx.SpaceCenter.Thruster.thrust_direction/3)

Position around which the gimbal pivots

The direction of the force generated by the thruster, when the engine is in its initial position (no gimballing), in the given reference frame

The position at which the thruster generates thrust, when the engine is in its initial position (no gimballing), in the given reference frame

The direction of the force generated by the thruster, in the given reference frame

The position at which the thruster generates thrust, in the given reference frame

Link to this section Functions

Link to this function get_gimbal_angle(conn, this)

The current gimbal angle in the pitch, roll and yaw axes, in degrees.

Link to this function get_gimballed(conn, this)

Whether the thruster is gimballed.

Link to this function get_part(conn, this)

The SpaceEx.SpaceCenter.Part that contains this thruster.

Link to this function get_thrust_reference_frame(conn, this)

A reference frame that is fixed relative to the thruster and orientated with its thrust direction (SpaceEx.SpaceCenter.Thruster.thrust_direction/3).

For gimballed engines, this takes into account the current rotation of the gimbal.

  • The origin is at the position of thrust for this thruster (SpaceEx.SpaceCenter.Thruster.thrust_position/3).

  • The axes rotate with the thrust direction. This is the direction in which the thruster expels propellant, including any gimballing.

  • The y-axis points along the thrust direction.

  • The x-axis and z-axis are perpendicular to the thrust direction.

Link to this function gimbal_position(conn, this, referenceFrame)

Position around which the gimbal pivots.

Returns: The position as a vector.

  • referenceFrame — The reference frame that the returned position vector is in.
Link to this function initial_thrust_direction(conn, this, referenceFrame)

The direction of the force generated by the thruster, when the engine is in its initial position (no gimballing), in the given reference frame.

This is opposite to the direction in which the thruster expels propellant.

Returns: The direction as a unit vector.

  • referenceFrame — The reference frame that the returned direction is in.
Link to this function initial_thrust_position(conn, this, referenceFrame)

The position at which the thruster generates thrust, when the engine is in its initial position (no gimballing), in the given reference frame.

Returns: The position as a vector.

  • referenceFrame — The reference frame that the returned position vector is in.

This position can move when the gimbal rotates. This is because the thrust position and gimbal position are not necessarily the same.

Link to this function thrust_direction(conn, this, referenceFrame)

The direction of the force generated by the thruster, in the given reference frame.

This is opposite to the direction in which the thruster expels propellant. For gimballed engines, this takes into account the current rotation of the gimbal.

Returns: The direction as a unit vector.

  • referenceFrame — The reference frame that the returned direction is in.
Link to this function thrust_position(conn, this, referenceFrame)

The position at which the thruster generates thrust, in the given reference frame.

For gimballed engines, this takes into account the current rotation of the gimbal.

Returns: The position as a vector.

  • referenceFrame — The reference frame that the returned position vector is in.