ships.Function.shieldMassCurveMultiplier

@elite-dangerous-almanac/core / ships / shieldMassCurveMultiplier

Function: shieldMassCurveMultiplier()

shieldMassCurveMultiplier(hullMass, generator): number

Defined in: src/ships/shields.ts:187

A shield generator's strength multiplier at a given hull mass.

Parameters

hullMass

number

The hull's mass, in tonnes (not the loaded ship's).

generator

ShieldGeneratorParams

The generator's mass/multiplier curve, post-engineering.

Returns

number

The multiplier to apply to the hull's base shield strength: minMultiplier for a hull sitting exactly on maxMass, no more than maxMultiplier for a featherweight one, and 0 past maxMass — a generator cannot raise a shield around a hull heavier than it is rated for. Also 0 for a generator whose record is missing part of its curve.

Remarks

The curve is a power law fitted through the generator's three declared points: normalize the mass into [0, 1] between maxMass and minMass, raise it to the exponent that makes the curve pass through (optMass, optMultiplier), then interpolate between minMultiplier and maxMultiplier.

Example

import { shieldMassCurveMultiplier } from '@elite-dangerous-almanac/core/ships/shields';

// A 6A generator (opt 540 t) on a 400 t Anaconda performs slightly above spec
shieldMassCurveMultiplier(400, {
  minMass: 270, optMass: 540, maxMass: 1350,
  minMultiplier: 0.7, optMultiplier: 1.2, maxMultiplier: 1.7,
}); // -> 1.434…