Skip to content

astro.Function.absoluteBolometricMagnitude

github-actions[bot] edited this page Aug 28, 2026 · 1 revision

@elite-dangerous-almanac/core / astro / absoluteBolometricMagnitude

Function: absoluteBolometricMagnitude()

absoluteBolometricMagnitude(body): number | null

Defined in: src/astro/star-physics.ts:200

A star's absolute bolometric magnitude, worked out from how big and how hot it is.

Parameters

body

BodyProperties

The star. Needs Radius in metres and SurfaceTemperature in kelvin.

Returns

number | null

The absolute bolometric magnitude — smaller is brighter, and a luminous star is negative — or null when either field is missing.

Remarks

Stefan–Boltzmann gives the luminosity — L/L☉ = (R/R☉)² · (T/T☉)⁴ — and the magnitude follows as M☉ − 2.5 log₁₀(L/L☉).

The reason to compute one when the scan usually reports AbsoluteMagnitude directly is that some stars carry no magnitude at all: a white dwarf is written with a radius and a temperature and nothing else to place it by. The two figures are not interchangeable — this is bolometric, over all wavelengths, while a reported magnitude is closer to visual — so expect them to differ by a magnitude or so on a very hot or very cool star, and use this as the fallback rather than the correction.

Throws

If body is not an object.

Example

import { absoluteBolometricMagnitude } from '@elite-dangerous-almanac/core/astro/star-physics';

// A star the size and temperature of the Sun is the Sun's magnitude.
absoluteBolometricMagnitude({ Radius: 695_700_000, SurfaceTemperature: 5772 }); // -> 4.74

// An Earth-sized white dwarf at 15 000 K: faint despite being fiercely hot.
absoluteBolometricMagnitude({ Radius: 6_371_000, SurfaceTemperature: 15_000 }); // -> 10.78…

API

Guides
astro
Classes (1)
ProceduralSystem

Properties

Accessors

Methods

Interfaces (28)
Type Aliases (6)
Variables (22)
Functions (57)
Subpath modules (3)
commodities
Interfaces (1)
Type Aliases (1)
Variables (3)
Functions (3)
equipment
Interfaces (6)
Type Aliases (8)
Variables (3)
Functions (10)
Subpath modules (2)
i18n
Interfaces (1)
Type Aliases (1)
Functions (17)
materials
Enumerations (2)
Interfaces (2)
Type Aliases (2)
Variables (9)
Functions (9)
ships
Classes (3)
BuildMetrics

Methods

LoadoutEditError

Constructors

Properties

Methods

ShipLoadout

Accessors

Methods

Interfaces (125)
Type Aliases (44)
Variables (10)
Functions (85)
Subpath modules (8)

Clone this wiki locally