AscentAutopilot

public class AscentAutopilot

This module controls the Ascent Guidance in MechJeb 2.

Note

See MechJeb2 wiki for more guidance on how to optimally set up this autopilot.

boolean getEnabled()
void setEnabled(boolean value)
Game Scenes:

Flight

String getStatus()

The autopilot status; it depends on the selected ascent path.

Game Scenes:

Flight

int getAscentPathIndex()
void setAscentPathIndex(int value)

The selected ascent path.

0 = AscentClassic (Classic Ascent Profile)

1 = AscentGT (Stock-style GravityTurn)

2 = AscentPVG (Primer Vector Guidance (RSS/RO))

Game Scenes:

Flight

AscentClassic getAscentPathClassic()

Get Classic Ascent Profile settings.

Game Scenes:

Flight

AscentGT getAscentPathGT()

Get Stock-style GravityTurn profile settings.

Game Scenes:

Flight

AscentPVG getAscentPathPVG()

Get Powered Explicit Guidance (RSS/RO) profile settings.

Game Scenes:

Flight

double getDesiredInclination()
void setDesiredInclination(double value)

The desired inclination in degrees for the final circular orbit.

Game Scenes:

Flight

double getDesiredOrbitAltitude()
void setDesiredOrbitAltitude(double value)

The desired altitude in kilometres for the final circular orbit.

Game Scenes:

Flight

ThrustController getThrustController()
Game Scenes:

Flight

Note

Equivalent to getThrustController().

boolean getForceRoll()
void setForceRoll(boolean value)

The state of force roll.

Game Scenes:

Flight

double getTurnRoll()
void setTurnRoll(double value)

The turn roll used by the autopilot.

Game Scenes:

Flight

double getVerticalRoll()
void setVerticalRoll(double value)

The vertical/climb roll used by the autopilot.

Game Scenes:

Flight

boolean getLimitAoA()
void setLimitAoA(boolean value)

Whether to limit angle of attack.

Game Scenes:

Flight

double getMaxAoA()
void setMaxAoA(double value)

The maximal angle of attack used by the autopilot.

Game Scenes:

Flight

double getAoALimitFadeoutPressure()
void setAoALimitFadeoutPressure(double value)

The pressure value when AoA limit is automatically deactivated.

Game Scenes:

Flight

boolean getCorrectiveSteering()
void setCorrectiveSteering(boolean value)

Will cause the craft to steer based on the more accurate velocity vector rather than positional vector (large craft may actually perform better with this box unchecked).

Game Scenes:

Flight

double getCorrectiveSteeringGain()
void setCorrectiveSteeringGain(double value)

The gain of corrective steering used by the autopilot.

Game Scenes:

Flight

boolean getAutostage()
void setAutostage(boolean value)

The autopilot will automatically stage when the current stage has run out of fuel. Paramethers can be set in StagingController.

Game Scenes:

Flight

StagingController getStagingController()
Game Scenes:

Flight

Note

Equivalent to getStagingController().

boolean getAutodeploySolarPanels()
void setAutodeploySolarPanels(boolean value)

Whether to deploy solar panels automatically when the ascent finishes.

Game Scenes:

Flight

boolean getAutoDeployAntennas()
void setAutoDeployAntennas(boolean value)

Whether to deploy antennas automatically when the ascent finishes.

Game Scenes:

Flight

boolean getSkipCircularization()
void setSkipCircularization(boolean value)

Whether to skip circularization burn and do only the ascent.

Game Scenes:

Flight

int getWarpCountDown()
void setWarpCountDown(int value)
Game Scenes:

Flight

double getLaunchLANDifference()
void setLaunchLANDifference(double value)
Game Scenes:

Flight

double getLaunchPhaseAngle()
void setLaunchPhaseAngle(double value)
Game Scenes:

Flight

AscentLaunchMode getLaunchMode()

Current autopilot mode. Useful for determining whether the autopilot is performing a timed launch or not.

Game Scenes:

Flight

void abortTimedLaunch()

Abort a known timed launch when it has not started yet

Game Scenes:

Flight

void launchToRendezvous()

Launch to rendezvous with the selected target.

Game Scenes:

Flight

void launchToTargetPlane()

Launch into the plane of the selected target.

Game Scenes:

Flight

public enum AscentLaunchMode
public AscentLaunchMode NORMAL

The autopilot is not performing a timed launch.

public AscentLaunchMode RENDEZVOUS

The autopilot is performing a timed launch to rendezvous with the target vessel.

public AscentLaunchMode TARGET_PLANE

The autopilot is performing a timed launch to target plane.

public AscentLaunchMode UNKNOWN

The autopilot is performing an unknown timed launch.

AscentClassic

public class AscentClassic

The Classic Ascent Profile.

boolean getAutoPath()
void setAutoPath(boolean value)

Whether to enable automatic altitude turn.

Game Scenes:

Flight

float getAutoTurnPercent()
void setAutoTurnPercent(float value)

A value between 0 and 1.

Game Scenes:

Flight

float getAutoTurnSpeedFactor()
void setAutoTurnSpeedFactor(float value)

A value between 0 and 1.

Game Scenes:

Flight

double getAutoTurnStartAltitude()
Game Scenes:

Flight

double getAutoTurnStartVelocity()
Game Scenes:

Flight

double getAutoTurnEndAltitude()
Game Scenes:

Flight

double getTurnStartAltitude()
void setTurnStartAltitude(double value)

The turn starts when this altitude is reached.

Game Scenes:

Flight

double getTurnStartVelocity()
void setTurnStartVelocity(double value)

The turn starts when this velocity is reached.

Game Scenes:

Flight

double getTurnEndAltitude()
void setTurnEndAltitude(double value)

The turn ends when this altitude is reached.

Game Scenes:

Flight

double getTurnEndAngle()
void setTurnEndAngle(double value)

The final flight path angle.

Game Scenes:

Flight

double getTurnShapeExponent()
void setTurnShapeExponent(double value)

A value between 0 - 1 describing how steep the turn is.

Game Scenes:

Flight

AscentGT

public class AscentGT

This profile is similar to the gravity turn mod. It is a 3-burn to orbit style of launch that can get to orbit with about 2800 dV on stock Kerbin. If you want to have fun make a rocket that is basically a nose cone, a jumbo-64 a mainsail and some fairly big fins, have the pitch program flip it over aggressively (uncheck the AoA limiter, set the values to like 0.5 / 50 / 40 / 45 / 1) and let it rip.

Note

It’s not precisely the GT mod algorithm and it does not do any pitch-up during the intermediate burn right now, so it won’t handle low TWR upper stages.

double getHoldAPTime()
void setHoldAPTime(double value)

At the intermediate altitude with this much time-to-apoapsis left the engine will start burning prograde to lift the apoapsis. The engine will throttle down in order to burn closer to the apoapsis. This is very similar to the lead-time of a maneuver node in concept, but with throttling down in the case where the player has initiated the burn too early (the corollary is that if you see lots of throttling down at the start, you likely need less HoldAP time).

Game Scenes:

Flight

double getIntermediateAltitude()
void setIntermediateAltitude(double value)

Intermediate apoapsis altitude to coast to and then raise the apoapsis up to the eventual final target. May be set to equal the final target in order to skip the intermediate phase.

Game Scenes:

Flight

double getTurnStartAltitude()
void setTurnStartAltitude(double value)

Altitude in km to pitch over and initiate the Gravity Turn (higher values for lower-TWR rockets).

Game Scenes:

Flight

double getTurnStartPitch()
void setTurnStartPitch(double value)

Pitch that the pitch program immediately applies.

Game Scenes:

Flight

double getTurnStartVelocity()
void setTurnStartVelocity(double value)

Velocity in m/s which triggers pitch over and initiates the Gravity Turn (higher values for lower-TWR rockets).

Game Scenes:

Flight

AscentPVG

public class AscentPVG

The Primer Vector Guidance (RSS/RO) profile.

boolean getAttachAltFlag()
void setAttachAltFlag(boolean value)
Game Scenes:

Flight

double getDesiredApoapsis()
void setDesiredApoapsis(double value)

The target apoapsis in meters.

Game Scenes:

Flight

double getDesiredAttachAlt()
void setDesiredAttachAlt(double value)
Game Scenes:

Flight

double getDynamicPressureTrigger()
void setDynamicPressureTrigger(double value)
Game Scenes:

Flight

boolean getFixedCoast()
void setFixedCoast(boolean value)
Game Scenes:

Flight

double getFixedCoastLength()
void setFixedCoastLength(double value)
Game Scenes:

Flight

double getPitchRate()
void setPitchRate(double value)
Game Scenes:

Flight

double getPitchStartVelocity()
void setPitchStartVelocity(double value)
Game Scenes:

Flight

int getStagingTrigger()
void setStagingTrigger(int value)
Game Scenes:

Flight

boolean getStagingTriggerFlag()
void setStagingTriggerFlag(boolean value)
Game Scenes:

Flight