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

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

surface_vel_roll

Roll; 0 is top side up.

Attribute:

Can be read or written

Return type:

float

Game Scenes:

Flight

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