Venus¶

Class to model Venus planet.

Venus examples

Venus - VSOP87-Parameters

class pyplanets.planets.venus.Venus(epoch)[source]¶

Class Venus models that planet.

__init__(epoch)[source]¶

Initializes an object of type planet for a given date (epoch) with: its orbital parameters (ephemeredes) given by VSOP87.

Parameters: epoch (Epoch) – Epoch to which all computations of this instance refer, as an Epoch object
Raises: TypeError if epoch is of wrong type.

aphelion() → pyplanets.core.epoch.Epoch [source]¶

This method computes the time of Aphelion closer to a given epoch.

Returns: The epoch of the desired Aphelion
Return type: Epoch

>>> epoch = Epoch(1979, 2, 1.0)
>>> e = Venus(epoch).aphelion()
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
1979
>>> print(m)
4
>>> print(d)
22
>>> print(h)
12

eastern_elongation() -> (<class 'pyplanets.core.epoch.Epoch'>, <class 'pyplanets.core.angle.Angle'>)[source]¶

This method computes the time of the eastern elongation closest to the given epoch, as well as the corresponding maximum elongation angle.

Returns: A tuple with the time when the eastern elongation happens, as an Epoch, and the maximum elongation angle, as an Angle
Return type: tuple
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(2019, 10, 1.0)
>>> time, elongation = Venus(epoch).eastern_elongation()
>>> y, m, d = time.get_date()
>>> print(y)
2020
>>> print(m)
3
>>> print(round(d, 4))
24.9179
>>> print(round(elongation, 4))
46.078

static illuminated_fraction(epoch: pyplanets.core.epoch.Epoch)[source]¶

This function computes an approximation of the illuminated fraction of Venus disk, as seen from Earth.

Parameters: epoch (Epoch) – Epoch to compute the illuminated fraction
Returns: Illuminated fraction of Venus disk
Return type: float
Raises: TypeError if input values are of wrong type.

>>> epoch = Epoch(1992, 12, 20)
>>> k = Venus.illuminated_fraction(epoch)
>>> print(round(k, 2))
0.64

inferior_conjunction() → pyplanets.core.epoch.Epoch [source]¶

This method computes the time of the inferior conjunction closest to the given epoch.

Returns: The time when the inferior conjunction happens, as an Epoch
Return type: Epoch
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(1882, 12, 1.0)
>>> conjunction = Venus(epoch).inferior_conjunction()
>>> y, m, d = conjunction.get_date()
>>> print(y)
1882
>>> print(m)
12
>>> print(round(d, 1))
6.7

static magnitude(sun_dist, earth_dist, phase_angle)[source]¶

This function computes the approximate magnitude of Venus.

Parameters

sun_dist (float) – Distance from Venus to the Sun, in Astronomical Units
earth_dist (float) – Distance from Venus to Earth, in Astronomical Units
phase_angle (float, Angle) – Venus phase angle

Returns

Venus’ magnitude

Return type

float

Raises

TypeError if input values are of wrong type.

>>> sun_dist = 0.724604
>>> earth_dist = 0.910947
>>> phase_angle = Angle(72.96)
>>> m = Venus.magnitude(sun_dist, earth_dist, phase_angle)
>>> print(m)
-3.8

perihelion() → pyplanets.core.epoch.Epoch [source]¶

This method computes the time of Perihelion closer to a given epoch.

Returns: The epoch of the desired Perihelion
Return type: Epoch

>>> epoch = Epoch(1978, 10, 15.0)
>>> e = Venus(epoch).perihelion()
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
1978
>>> print(m)
12
>>> print(d)
31
>>> print(h)
4

station_longitude_1() → pyplanets.core.epoch.Epoch [source]¶

This method computes the time of the 1st station in longitude (i.e. when the planet is stationary and begins to move westward - retrograde - among the starts) closest to the given epoch.

Returns: Time when the 1st station in longitude happens, as an Epoch
Return type: Epoch
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(2018, 12, 1.0)
>>> sta1 = Venus(epoch).station_longitude_1()
>>> y, m, d = sta1.get_date()
>>> print(y)
2018
>>> print(m)
10
>>> print(round(d, 4))
5.7908

station_longitude_2() → pyplanets.core.epoch.Epoch [source]¶

This method computes the time of the 1st station in longitude (i.e. when the planet is stationary and begins to move eastward - prograde - among the starts) closest to the given epoch.

Returns: Time when the 2nd station in longitude happens, as an Epoch
Return type: Epoch
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(2018, 12, 1.0)
>>> sta2 = Venus(epoch).station_longitude_2()
>>> y, m, d = sta2.get_date()
>>> print(y)
2018
>>> print(m)
11
>>> print(round(d, 4))
16.439

superior_conjunction() → pyplanets.core.epoch.Epoch [source]¶

This method computes the time of the superior conjunction closest to the given epoch.

Returns: The time when the superior conjunction happens, as an Epoch
Return type: Epoch
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(1993, 10, 1.0)
>>> conjunction = Venus(epoch).superior_conjunction()
>>> y, m, d = conjunction.get_date()
>>> print(y)
1994
>>> print(m)
1
>>> print(round(d, 2))
17.05

western_elongation() -> (<class 'pyplanets.core.epoch.Epoch'>, <class 'pyplanets.core.angle.Angle'>)[source]¶

This method computes the time of the western elongation closest to the given epoch, as well as the corresponding maximum elongation angle.

Returns: A tuple with the time when the western elongation happens, as an Epoch, and the maximum elongation angle, as an Angle
Return type: tuple
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(2019, 1, 1.0)
>>> time, elongation = Venus(epoch).western_elongation()
>>> y, m, d = time.get_date()
>>> print(y)
2019
>>> print(m)
1
>>> print(round(d, 4))
6.1895
>>> print(round(elongation, 4))
46.9571