Stage

class SpaceCenter.Stage

A single stage of a vessel. Obtain activation (burn) stages from Vessel.Stages / Vessel.StageAt, and decouple stages from Vessel.DecoupleStages / Vessel.DecoupleStageAt.

Note

Delta-v, thrust, TWR, specific impulse, burn time and mass members are only available on activation stages. On decouple stages those members throw InvalidOperationException because stock delta-v data does not apply. Thrust is reported in newtons and masses in kilograms (stock values are converted from kilonewtons and tonnes).

number: number

The stage number (activation stage for burn stages, decouple stage otherwise).

Attribute:

Read-only, cannot be set

Return type:

number

parts: List

The parts that belong to this stage.

Attribute:

Read-only, cannot be set

Return type:

List

resources([cumulative = true])

Returns a SpaceCenter.Stage.resources() object for this stage.

Parameters:

cumulative (boolean) – When False, only resources assigned to this stage. When True, resources for this stage and all later activation or decouple stage numbers are included. On activation stages, unstaged resource containers (for example fuel tanks) are grouped with the first higher activation stage before they are detached.

Return type:

SpaceCenter.Resources

Note

This is an RPC method: call resources() (optional cumulative argument). For activation stages, unstaged resource containers (for example fuel tanks) are grouped with the first higher activation stage before they detach, matching the C# Resources() documentation.

delta_v: number

Delta-v for this stage in the current situation, in m/s.

Attribute:

Read-only, cannot be set

Return type:

number

Note

Delta-v is only defined for activation stages (decouple is false). Calling this on a decouple stage raises an error.

vacuum_delta_v: number

Vacuum delta-v for this stage, in m/s.

Attribute:

Read-only, cannot be set

Return type:

number

sea_level_delta_v: number

Sea-level delta-v for this stage, in m/s.

Attribute:

Read-only, cannot be set

Return type:

number

thrust: number

Thrust in the current situation, in newtons.

Attribute:

Read-only, cannot be set

Return type:

number

vacuum_thrust: number

Vacuum thrust, in newtons.

Attribute:

Read-only, cannot be set

Return type:

number

sea_level_thrust: number

Sea-level thrust, in newtons.

Attribute:

Read-only, cannot be set

Return type:

number

twr: number

Thrust-to-weight ratio in the current situation.

Attribute:

Read-only, cannot be set

Return type:

number

vacuum_twr: number

Vacuum thrust-to-weight ratio.

Attribute:

Read-only, cannot be set

Return type:

number

sea_level_twr: number

Sea-level thrust-to-weight ratio.

Attribute:

Read-only, cannot be set

Return type:

number

specific_impulse: number

Specific impulse in the current situation, in seconds.

Attribute:

Read-only, cannot be set

Return type:

number

vacuum_specific_impulse: number

Vacuum specific impulse, in seconds.

Attribute:

Read-only, cannot be set

Return type:

number

sea_level_specific_impulse: number

Sea-level specific impulse, in seconds.

Attribute:

Read-only, cannot be set

Return type:

number

burn_time: number

Burn time for this stage, in seconds.

Attribute:

Read-only, cannot be set

Return type:

number

start_mass: number

The mass of the vessel after the stage activates, in kg.

Attribute:

Read-only, cannot be set

Return type:

number

end_mass: number

The mass of the vessel when the stage burns out, in kg.

Attribute:

Read-only, cannot be set

Return type:

number

dry_mass: number

The dry mass of the vessel after the stage activates, in kg.

Attribute:

Read-only, cannot be set

Return type:

number

Note

Includes the parts of all later stages.

fuel_mass: number

The fuel mass of the vessel when the stage activates, in kg.

Attribute:

Read-only, cannot be set

Return type:

number

Note

Includes the fuel of all later stages, and the fuel left in the parts the stage decouples. The stage burns SpaceCenter.Stage.start_mass minus SpaceCenter.Stage.end_mass.