Planetary Tokens

Navigation:  Tokens > Astronomical Tokens >

Planetary Tokens

Previous pageReturn to chapter overviewNext page

Planetary tokens are used to display information about events that involve individual planets daily (planets' rising, setting and upper transit).

 

You can use the various planetary macro functions to calculate events that occur either between 2 planets (nearness), events that occur between a planet and the Sun (min/max distance), and events that occur between the Earth, the Sun, and another planet (occultation, transit, elongation, lower/upper conjunction, opposition, eclipses).

 

Planetary Rising, Setting and Transit

 

To display the times when a planet rises, sets or is in upper transit, use the following tokens, where the index X refers to the planet index as given in the table above (note that theses tokens can also be used to display times of sunrises, sunsets, moonrise and moonset, as these 2 bodies are treated as "regular planets" in the above table).

 

rising

[plXrt]

The time when planet X rises.

[plXrr]

The right ascension (R.A.) of planet X when it rises (equatorial coordinate system).

[plXrz]

The azimuth of planet X when it rises (horizontal coordinate system)

setting

[plXst]

The time when planet X sets.

[plXsr]

The right ascension (R.A.) of planet X when it sets (equatorial coordinate system).

[plXsz]

The azimuth of planet X when it sets (horizontal coordinate system)

transit

[plXtt]

The time when planet X is in upper transit (ie. is at the highest point that it will reach during the day).

[pl0to]

The time offset of the Sun's upper transit as compared to when local noon would be expected (applies to the Sun only).

[plXtr]

The right ascension (R.A.) of planet X when it is in upper transit (equatorial coordinate system).

[plXtd]

The declination of planet X when it is in upper transit (equatorial coordinate system).

[plXtz]

The azimuth of planet X when it is in upper transit (horizontal coordinate system)

[plXta]

The altitude of planet X when it is in upper transit (horizontal coordinate system)

 

Some remarks:

 

In the planetary tokens above, the X index referring to the "planet" are specified here.

The planetary tokens can also be used for the Sun, the Moon, as well as more than a dozen stars and galaxies.

By default, the above tokens are calculated for the 1st Sun Data Source of the current script. If you want to have any planetary token calculated based on another source, just append :sY to the token, where Y is a number corresponding to the Nth Sun Source of the script (ie. append :s2 to any planetary token to have it calculated based on the coordinates of the 2nd Sun Data Source of the current script.

 

Note that the times obtained from the above tokens will all be formatted using the planetary times formatting options. The same is true for the text to be displayed in cases when a planet does not rise or set or transit in a given day. The calculations that determine the above times are performed based on the geographical locations selected in the Sun Data ScriptLine property.

 

Planetary Always Above or Below the Horizon

 

Use the tokens below, to display some text or symbol, if the date of the token corresponds to a date when a given planet is always above the horizon (ie. does not set) or always below the horizon (ie. does not rise).

 

[plXab]

Indicates by some text or symbol, whether planet X is always above or always below the horizon on the date of the token.

 

The text or symbols that are to be displayed, and when, are determined by the settings specified in the Planets tab of the Moon and Sun Options scriptline property, as shown below.

 

 

The calculations that determine on which dates the various planets are always above or below are performed based on the geographical locations selected in the Sun Data ScriptLine property. Here, again, by default, the above tokens are calculated for the 1st Sun Data Source of the current script. Append :sY to the token, where Y is a number corresponding to the Nth Sun Source of the script, to have it calculated based on the coordinates of the Nth Sun Data Source of the current script.

 

For information and events that relate to the Sun and the Moon only, see Sun tokens and Moon tokens.


Topic 176610 updated on 26-Sep-2016.
Topic URL: http://www.qppstudio.net/webhelp/index.html?planetarytokens.htm