Skip to content

Docs: explain the small dignity letters shown next to planet icons (r, d, e, E, f) #118

@afucher

Description

@afucher

Context

Issue #87 asks: "What is the meaning of the small letter at the bottom of planet icons when creating a transit chart? (e.g. t or d)"

These letters are astrological dignity indicators rendered next to each planet symbol on both radix and transit charts. They are not explained on any documentation page, which makes the chart confusing for users who do not already know the convention.

What is missing from the docs

The settings reference lists the DIGNITIES_* keys in a table, but:

  • It never explains what a dignity is or what the letters mean visually on the chart.
  • The Transit Chart guide never mentions dignities at all, even though transit planets show them.
  • There is no visual reference mapping letter to meaning.

What should be added

In the Settings Reference (api/settings.md) - Dignities section

Add a short explanation paragraph above the table:

Planet dignities are traditional astrological strength indicators. When SHOW_DIGNITIES_TEXT is true (the default), a small letter is rendered next to each planet symbol:

Letter (default) Dignity Meaning
r Rulership The planet rules this sign - strongest position
d Detriment The planet is in the opposite sign of its rulership - weakened
e Exaltation The planet is in its exalted sign - elevated strength
E Exact exaltation The planet is at its precise degree of exaltation
f Fall The planet is in the opposite sign of its exaltation - weakened

All five letter strings are configurable. Set SHOW_DIGNITIES_TEXT: false to hide them entirely.

In the Transit Chart guide (guides/transit-chart.mdx)

Add a short note explaining that transit planets show the same dignity letters as radix planets, based on the transiting planet's current sign position.

In the Custom Settings guide (guides/custom-settings.md)

Add a practical example:

// Hide dignity labels entirely
const chart = new Chart('chart', 600, 600, { SHOW_DIGNITIES_TEXT: false })

// Use different abbreviations
const chart = new Chart('chart', 600, 600, {
  DIGNITIES_RULERSHIP:  'rul',
  DIGNITIES_DETRIMENT:  'det',
  DIGNITIES_EXALTATION: 'exalt',
  DIGNITIES_FALL:       'fall',
})

Relevant links

  • Original question: I have a few questions. #87
  • Settings source: project/src/settings.ts (SHOW_DIGNITIES_TEXT, DIGNITIES_*)
  • Rendering logic: project/src/radix.ts drawPoints() and project/src/transit.ts drawPoints()

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions