Jupiter¶

Class to model Jupiter planet.

Jupiter examples

Jupiter - VSOP87-Parameters

class pyplanets.planets.jupiter.Jupiter(epoch)[source]¶

Class Jupiter 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(1981, 6, 1.0)
>>> e = Jupiter(epoch).aphelion()
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
1981
>>> print(m)
7
>>> print(d)
28
>>> print(h)
6

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

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

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

>>> epoch = Epoch(1993, 10, 1.0)
>>> conj = Jupiter(epoch).conjunction()
>>> y, m, d = conj.get_date()
>>> print(y)
1993
>>> print(m)
10
>>> print(round(d, 4))
18.3341

static magnitude(sun_dist, earth_dist)[source]¶

This function computes the approximate magnitude of Jupiter.

Parameters

sun_dist (float) – Distance from Jupiter to Sun, in Astronomical Units
earth_dist (float) – Distance Jupiter to Earth, in Astronomical Units

Returns

Jupiter’s magnitude

Return type

float

Raises

TypeError if input values are of wrong type.

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

This method computes the time of the opposition closest to the given epoch.

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

>>> epoch = Epoch(-6, 9, 1.0)
>>> oppo = Jupiter(epoch).opposition()
>>> y, m, d = oppo.get_date()
>>> print(y)
-6
>>> print(m)
9
>>> print(round(d, 4))
15.2865

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 (or Aphelion)
Return type: Epoch

>>> epoch = Epoch(2019, 2, 23.0)
>>> e = Jupiter(epoch).perihelion()
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
2023
>>> print(m)
1
>>> print(d)
20
>>> print(h)
11

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, 11, 1.0)
>>> sta1 = Jupiter(epoch).station_longitude_1()
>>> y, m, d = sta1.get_date()
>>> print(y)
2018
>>> print(m)
3
>>> print(round(d, 4))
9.1288

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

This method computes the time of the 2nd 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 1st station in longitude happens, as an Epoch
Return type: Epoch
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(2018, 11, 1.0)
>>> sta2 = Jupiter(epoch).station_longitude_2()
>>> y, m, d = sta2.get_date()
>>> print(y)
2018
>>> print(m)
7
>>> print(round(d, 4))
10.6679