SmartASS

class MechJeb.SmartASS

The Smart A.S.S. module provides aids for vessel pitch control.

interface_mode: MechJeb.SmartASSInterfaceMode

GUI mode; doesn’t do anything except changing SmartASS GUI buttons to a specified mode.

Attribute:: Can be read or written
Return type:: MechJeb.SmartASSInterfaceMode

autopilot_mode: MechJeb.SmartASSAutopilotMode

Current autopilot mode.

Attribute:: Can be read or written
Return type:: MechJeb.SmartASSAutopilotMode

update(reset_pid)

Update SmartASS position to use new values.

Parameters:: reset_pid (boolean) – False most of the time, use true only if it doesn’t work.

force_yaw: boolean

Enable yaw control for MechJeb.SmartASS.surface_heading, MechJeb.SmartASSAutopilotMode.surface_prograde and MechJeb.SmartASSAutopilotMode.surface_retrograde.

Attribute:: Can be read or written
Return type:: boolean

force_pitch: boolean

Enable pitch control for MechJeb.SmartASS.surface_pitch, MechJeb.SmartASSAutopilotMode.surface_prograde and MechJeb.SmartASSAutopilotMode.surface_retrograde.

Attribute:: Can be read or written
Return type:: boolean

force_roll: boolean

Enable roll control.

Attribute:: Can be read or written
Return type:: boolean

surface_heading: number

Heading; Also called or azimuth, or the direction where you want to go.

Attribute:: Can be read or written
Return type:: number

Note

Works only in MechJeb.SmartASSAutopilotMode.surface mode.

surface_pitch: number

Pitch or inclination; 0 is horizontal and 90 is straight up. Can be negative.

Attribute:: Can be read or written
Return type:: number

Note

Works only in MechJeb.SmartASSAutopilotMode.surface mode.

surface_roll: number

Roll; 0 is top side up.

Attribute:: Can be read or written
Return type:: number

Note

Works only in MechJeb.SmartASSAutopilotMode.surface mode.

surface_vel_yaw: number

Attribute:: Can be read or written
Return type:: number

Note

Works only in MechJeb.SmartASSAutopilotMode.surface_prograde and MechJeb.SmartASSAutopilotMode.surface_retrograde mode.

surface_vel_pitch: number

Pitch or inclination; 0 is horizontal and 90 is straight up. Can be negative.

Attribute:: Can be read or written
Return type:: number

Note

Works only in MechJeb.SmartASSAutopilotMode.surface_prograde and MechJeb.SmartASSAutopilotMode.surface_retrograde mode.

surface_vel_roll: number

Roll; 0 is top side up.

Attribute:: Can be read or written
Return type:: number

Note

Works only in MechJeb.SmartASSAutopilotMode.surface_prograde and MechJeb.SmartASSAutopilotMode.surface_retrograde mode.

advanced_reference: MechJeb.AttitudeReference

Attribute:: Can be read or written
Return type:: MechJeb.AttitudeReference

Note

Works only in MechJeb.SmartASSAutopilotMode.advanced mode.

advanced_direction: MechJeb.Direction

Attribute:: Can be read or written
Return type:: MechJeb.Direction

Note

Works only in MechJeb.SmartASSAutopilotMode.advanced mode.

class MechJeb.SmartASSInterfaceMode

orbital

surface

target

advanced

automatic: Internal mode, do not set.

class MechJeb.SmartASSAutopilotMode

off: Switch off Smart A.S.S.

kill_rot: “Kill” the spacecraft’s rotation (counters rotation/tumbling).

node: Point the vessel to a maneuver node.

advanced: Advanced mode.

automatic: Automatic mode (internal mode, only for getting status).

prograde: ORBIT: Orient to orbital prograde.

retrograde: ORBIT: Orient to orbital retrograde.

normal_plus: ORBIT: Orient to orbital normal (change inclination).

normal_minus: ORBIT: Orient to orbital anti-normal (change inclination).

radial_plus: ORBIT: Orient to radial outward (away from SOI).

radial_minus: ORBIT: Orient to radial inward (towards SOI).

surface_prograde: SURFACE: Orient in the direction of movement relative to the ground. Useful during lift-off for rockets which don’t have fins or are otherwise instable.

surface_retrograde: SURFACE: Orient in the opposite direction of movement relative to the ground. Useful during reentry or aerobraking with an aerodynamically unstable craft.

horizontal_plus: SURFACE: Orient in the direction of horizontal movement relative to the ground.

horizontal_minus: SURFACE: Orient in the opposite direction of horizontal movement relative to the ground.

surface: SURFACE: Orient the vessel in specific direction relative to surface.

vertical_plus: SURFACE: Orient “up”, perpendicular to the surface.

target_plus: TARGET: Orient towards the target.

target_minus: TARGET: Orient away from the target.

relative_plus: TARGET: Orient toward your relative velocity. Burning this direction will increase your relative velocity.

relative_minus: TARGET: Orient away from your relative velocity. Burning this direction will decrease your relative velocity.

parallel_plus: TARGET: Orient parallel to the target’s orientation. If the target is a docking node it orients the ship along the docking axis, pointing away from the node.

parallel_minus: TARGET: Orient antiparallel to the target’s orientation. If the target is a docking node it orients the ship along the docking axis, pointing toward the node.

class MechJeb.AttitudeReference

inertial: World coordinate system.

orbit: forward = prograde, left = normal plus, up = radial plus

orbit_horizontal: forward = surface projection of orbit velocity, up = surface normal

surface_north: forward = north, left = west, up = surface normal

surface_velocity: forward = surface frame vessel velocity, up = perpendicular component of surface normal

target: forward = toward target, up = perpendicular component of vessel heading

relative_velocity: forward = toward relative velocity direction, up = tbd

target_orientation: forward = direction target is facing, up = target up

maneuver_node: forward = next maneuver node direction, up = tbd

sun: forward = orbit velocity of the parent body orbiting the sun, up = radial plus of that orbit

surface_horizontal: forward = surface velocity horizontal component, up = surface normal

class MechJeb.Direction

forward

back

up

down

right

left