Hi there - I am releasing an update to this module today:
v. 4.05. - 21 May 2021: improved visibility definitions and USB definitions, added altitude listing, improved layout
From the help:
Sun's Beams
USB = Under the Sun's Beams
Two definitions of being under the Sun's beams are offered.
One is a fixed definition where any planet between 8 and 15 degrees of the Sun, measured in longitude, is considered to be 'under the Sun's beams'. A planet beyond 15 degrees of longitude beyond the Sun is considered to be 'free of beams'.
A planet less than 8 degrees from the Sun, but beyond about 16 minutes from the Sun, is considered to be combust. In general this is taken as a malefic state for the planet.
A planet within +/- 16 minutes of the Sun is called 'cazimi', a benefic state where the planet is strongly dignified by its very close connection with the Sun.
A second option is included, where the various distances from the Sun vary as follows:
Free of Beams - Moon (12 degrees), Mercury (12 degrees), Venus (12 degrees), Mars (18 degrees), Jupiter (15 degrees), Saturn (15 degrees).
Under the Beams - Moon (7 degrees), all other planets (6 degrees), except Mercury and Venus when oriental and direct (7 degrees).
The definition of cazimi does not vary.
This option is taken from Al Biruni (The Book of Instructions in the Elements of the Art of Astrology), 481-484.
Visibility
V = Visible
I = Invisible
Various definitions of visibility are used in this module. The first is simply a planet being 'free of the Beams' whether it can be seen visually or not. The symbolic implication of being free of the beams is that the planet has the potential to be seen, not being overwhelmed by the power of the light of the Sun.
Planets close to the Sun (within fifteen degrees) are identified as invisible. If the planet is beyond the Sun's longitude (+/- fifteen degrees) it is considered to be visible. This is a rough guide, and different planets have different thresholds for visibility because of their varying magnitudes and relationship to their synodic cycle with the Sun.
A second definition of visibility may be chosen. This considers whether a planet can actually be seen in the night sky. This is calculated by checking if the Sun is below the horizon, and whether any of the seven traditional planets are at least 2 degrees of altitude above the horizon. Due to the varying magnitudes of the planets, the negative altitude of the Sun is varied in the calculation as follows:
Moon: the sun below the horizon -4 degrees
Venus: the sun -4
Jupiter: sun -5
Mercury: the sun -8 (in the case of Mercury it actually ranges between -6 and -9 depending on the solar phase).
Saturn: sun -8
Mars: sun -9
Essentially if a planet is dim in the night sky, the more difficult it is to see the planet, and the darker the night sky needs to be before the visibility threshold is reached.
The application of 2 degrees of altitude allows for the obscuration of the light of the planet due to atmospheric extinction. The closer a planet lies to the horizon, the more its light is dimmed by its passage through the earth's atmosphere.
For further information see:
https://jcremers.com/forum/index.php/topic,147.0.html (Thanks to forum member AB for the information.)
A listing of planetary altitude for the visible planets has been included.
Thanks. Ed