SmartASS

class SmartASS

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

interface_mode

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

Attribute:: Can be read or written
Return type:: SmartASSInterfaceMode
Game Scenes:: Flight

autopilot_mode

Current autopilot mode.

Attribute:: Can be read or written
Return type:: SmartASSAutopilotMode
Game Scenes:: Flight

update(reset_pid)

Update SmartASS position to use new values.

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

force_yaw

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

Attribute:: Can be read or written
Return type:: bool
Game Scenes:: Flight

force_pitch

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

Attribute:: Can be read or written
Return type:: bool
Game Scenes:: Flight

force_roll

Enable roll control.

Attribute:: Can be read or written
Return type:: bool
Game Scenes:: Flight

surface_heading

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

Attribute:: Can be read or written
Return type:: float
Game Scenes:: Flight

Note

Works only in SmartASSAutopilotMode.surface mode.

surface_pitch

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

Attribute:: Can be read or written
Return type:: float
Game Scenes:: Flight

Note

Works only in SmartASSAutopilotMode.surface mode.

surface_roll

Roll; 0 is top side up.

Attribute:: Can be read or written
Return type:: float
Game Scenes:: Flight

Note

Works only in SmartASSAutopilotMode.surface mode.

surface_vel_yaw

Attribute:: Can be read or written
Return type:: float
Game Scenes:: Flight

Note

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

surface_vel_pitch

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

Attribute:: Can be read or written
Return type:: float
Game Scenes:: Flight

Note

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

surface_vel_roll

Roll; 0 is top side up.

Attribute:: Can be read or written
Return type:: float
Game Scenes:: Flight

Note

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

advanced_reference

Attribute:: Can be read or written
Return type:: AttitudeReference
Game Scenes:: Flight

Note

Works only in SmartASSAutopilotMode.advanced mode.

advanced_direction

Attribute:: Can be read or written
Return type:: Direction
Game Scenes:: Flight

Note

Works only in SmartASSAutopilotMode.advanced mode.

class SmartASSInterfaceMode

orbital

surface

target

advanced

automatic: Internal mode, do not set.

class 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 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 Direction

forward

back

up

down

right

left