Celestine API Documentation - v0.2.0
    Preparing search index...

    Function getPlanetaryDignity

    • Get planetary dignity for a planet in a given sign

      Determines the essential dignity state of a planet based on the sign it occupies. Checks in order: domicile, detriment, exaltation, fall, then defaults to peregrine.

      Dignity hierarchy:

      1. Domicile (+5): Planet rules the sign
      2. Detriment (-5): Planet in sign opposite its rulership
      3. Exaltation (+4): Planet exalted in the sign
      4. Fall (-4): Planet in sign opposite its exaltation
      5. Peregrine (0): No special dignity

      Parameters

      • planet: Planet

        The planet to evaluate

      • sign: Sign

        The sign the planet is in

      • Optionaldegree: number

        Optional: degree within sign (0-29) for exact exaltation check

      Returns Dignity

      Dignity information including state, strength, and description

      // Mars in Aries: Domicile
      const marsAries = getPlanetaryDignity(Planet.Mars, Sign.Aries);
      // marsAries.state = DignityState.Domicile
      // marsAries.strength = +5
      // Mars in Libra: Detriment (opposite Aries)
      const marsLibra = getPlanetaryDignity(Planet.Mars, Sign.Libra);
      // marsLibra.state = DignityState.Detriment
      // marsLibra.strength = -5
      // Mars in Capricorn at 28°: Exaltation at exact degree
      const marsCap = getPlanetaryDignity(Planet.Mars, Sign.Capricorn, 28);
      // marsCap.state = DignityState.Exaltation
      // marsCap.exaltationDegree = 28
      // Mars in Taurus: Peregrine (no special dignity)
      const marsTaurus = getPlanetaryDignity(Planet.Mars, Sign.Taurus);
      // marsTaurus.state = DignityState.Peregrine
      // marsTaurus.strength = 0