EliteDangerousAlmanac / Astronomy / CodexRegionMap

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:37

Which codex region one place in the galaxy belongs to.

A system's region follows from where it sits on a flat grid over the plane of the galaxy, whose cell is about 49 light years on a side. The cells of each region are held as runs in a shared data file, and this class rebuilds the row index it reads them through.

Two readings are offered, because the game calls two things the region. FindAt answers where a place is, which is what the codex records a find against and what the game shows on a jump into a system. FindForBoxel answers where the corner of a system's boxel is, which is what the journal and the codex front page show. The two differ near a border.

The reading is the EliteDangerousRegionMap algorithm. See ATTRIBUTIONS.md for credit and licence terms.

static LightYearsPerCell: double

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:54

The edge of one cell of the region grid, in light years.

static OriginX: double

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:45

The galactic X of the galaxy's corner, in light years.

static OriginY: double

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:48

The galactic Y of the galaxy's corner, in light years.

static OriginZ: double

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:51

The galactic Z of the galaxy's corner, in light years.

static FindAt(point): CodexRegion?

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:63

Finds the codex region at one place on the plane of the galaxy.

GalacticPlanePosition

The place in light years, with Sol at the origin.

CodexRegion?

The region there, or null where the place lies outside the mapped grid.

ArgumentNullException

The place is absent.

static FindAt(position): CodexRegion?

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:80

Finds the codex region at one place in the galaxy.

GalacticPosition

The position in light years, with Sol at the origin.

CodexRegion?

The region there, or null where the place lies outside the mapped grid.

The height is read and left alone. The region map is flat, so a region has no height to hold a place against.

ArgumentNullException

The position is absent.

static FindAt(x, z): CodexRegion?

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:93

Finds the codex region at one place on the plane of the galaxy.

double

The galactic X in light years, with Sol at the origin.

double

The galactic Z in light years.

CodexRegion?

The region there, or null where the place lies outside the mapped grid.

static FindForBoxel(id64): BoxelCodexRegion

Defined in: dotnet/src/EliteDangerousAlmanac/Astronomy/CodexRegionMap.cs:116

Finds the codex region of a system's boxel, from its address.

ulong

The system address.

BoxelCodexRegion

The corner of the system's boxel in light years, with Sol at the origin, and the region there.

This is the region the journal writes and the codex front page shows. It is read at the corner of the system's boxel, which near a border is not always the region at the system's own place. Those coordinates are also as near a position as an address alone reaches: they are true to one boxel edge, which MassCode.BoxelEdgeLy reads.