DotNet.Ships.Class.Mobility

EliteDangerousAlmanac / Ships / Mobility

Class: Mobility

Defined in: dotnet/src/EliteDangerousAlmanac/Ships/Mobility.cs:125

The data-free speed and handling arithmetic for a loaded ship, at full ENG. The figures are the hull's four-pip endpoints with the fitted thruster mass curves applied.

Remarks

The ENG capacitor is a separate story with its own entry point, MobilityCapacitor, which interpolates the hull's zero-pip endpoints towards the four-pip ones before the same curves are applied.

Ported from EDCD/Coriolis and cross-checked against EDSY's mass-curve calculation. See ATTRIBUTIONS.md for credit and licence terms.

Methods

Metrics()

static Metrics(input): MobilityMetrics?

Defined in: dotnet/src/EliteDangerousAlmanac/Ships/Mobility.cs:165

Calculates a loaded ship's top speed, boost speed and rotation rates at full ENG.

Parameters

input

MobilityInput

The hull figures, the loaded mass and the fitted thrusters.

Returns

MobilityMetrics?

The build's metrics, or null when no thrusters are fitted. A mass above the thrusters' maximum answers zero performance rather than a fabricated curve value.

Remarks

Speed, pitch, roll and yaw are the hull's four-pip endpoints with the fitted thruster's speed and rotation mass-curve multipliers applied. Boost is independent of the ENG allocation and uses the speed curve at the loaded mass, so it is the same figure whatever the pips.

A lower allocation is MobilityCapacitor.Metrics. It interpolates each figure from the hull's zero-pip endpoint towards the endpoint used here, and applies the same curves.

Exceptions

ArgumentNullException

input is null.

ArgumentOutOfRangeException

An input is not finite or is outside its documented range, or a thruster curve is not in the order IMassCurve documents.

ThrusterMassCurveMultiplier()

static ThrusterMassCurveMultiplier(mass, thrusters): double

Defined in: dotnet/src/EliteDangerousAlmanac/Ships/Mobility.cs:138

Resolves a thruster's performance multiplier at a loaded mass.

Parameters

mass

double

The loaded mass, in tonnes.

thrusters

ThrusterCurveParams

The fitted thruster curve, post-engineering.

Returns

double

The curve multiplier, and zero above the thrusters' maximum supported mass.

Exceptions

ArgumentNullException

thrusters is null.

ArgumentOutOfRangeException

The mass or a curve value is not finite and zero or more, or the curve masses or multipliers are not in the order IMassCurve documents.