astro.Function.ringParticleDensity

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

Function: ringParticleDensity()

ringParticleDensity(ringClass): number

Defined in: src/astro/body-rings.ts:108

The density assumed for the particles making up a ring of a given class, in kg/m³.

Parameters

ringClass

string

A ring's RingClass token. Matched case-insensitively on the material in the name, so both of the game's metallic spellings — "eRingClass_MetalRich" and the misspelt "eRingClass_Metalic" — resolve.

Returns

number

The assumed particle density in kg/m³: 4500 metallic, 3000 rocky, 1000 icy. An unrecognised class falls back to the icy figure, which is the game's commonest ring and its least dense — so a Roche limit computed from it is the conservative one.

Remarks

A scan reports what a ring is made of but never how dense its particles are, and the Roche limit that says where the material could have survived needs one. These are the standing assumptions the Canonn tooling uses: water ice, silicate rock, and iron-nickel metal.

Throws

If ringClass is not a string. This returns a density rather than reporting whether a class is known, so there is no miss for a nullish one to be.

Example

import { ringParticleDensity } from '@elite-dangerous-almanac/core/astro/body-rings';

ringParticleDensity('eRingClass_Rocky'); // -> 3000
ringParticleDensity('eRingClass_Metalic'); // -> 4500
ringParticleDensity('eRingClass_Something_New'); // -> 1000