Saturn¶

Class to model Saturn planet.

Saturn examples

Saturn - VSOP87-Parameters

class pyplanets.planets.saturn.Saturn(epoch)[source]¶

Class Saturn 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(2047, 1, 1.0)
>>> e = Saturn(epoch).aphelion()
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
2047
>>> print(m)
7
>>> print(d)
15
>>> print(h)
0

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: TypeError if input value is of wrong type.
Raises: ValueError if input epoch outside the -2000/4000 range.

>>> epoch = Epoch(2125, 6, 1.0)
>>> conj = Saturn(epoch).conjunction()
>>> y, m, d = conj.get_date()
>>> print(y)
2125
>>> print(m)
8
>>> print(round(d, 4))
26.4035

static magnitude(sun_dist, earth_dist, delta_u, b)[source]¶

This function computes the approximate magnitude of Saturn.

Parameters

sun_dist (float) – Distance from Saturn to the Sun, in Astronomical Units
earth_dist (float) – Distance from Saturn to Earth, in Astronomical Units
delta_u (float, Angle) – Difference between the Saturnicentric longitudes of the Sun and the Earth, measured in the plane of the ring
b (float, Angle) – Saturnicentric latitude of the Earth refered to the plane of the ring, positive towards the north

Returns

Saturn’s magnitude

Return type

float

>>> sun_dist = 9.867882
>>> earth_dist = 10.464606
>>> delta_u = Angle(16.442)
>>> b = Angle(4.198)
>>> m = Saturn.magnitude(sun_dist, earth_dist, delta_u, b)
>>> print(m)
1.9

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 = Saturn(epoch).opposition()
>>> y, m, d = oppo.get_date()
>>> print(y)
-6
>>> print(m)
9
>>> print(round(d, 4))
14.3709

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(1944, 1, 1.0)
>>> e = Saturn(epoch).perihelion()
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
1944
>>> print(m)
9
>>> print(d)
8
>>> print(h)
1

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 = Saturn(epoch).station_longitude_1()
>>> y, m, d = sta1.get_date()
>>> print(y)
2018
>>> print(m)
4
>>> print(round(d, 4))
17.9433

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 2nd 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 = Saturn(epoch).station_longitude_2()
>>> y, m, d = sta2.get_date()
>>> print(y)
2018
>>> print(m)
9
>>> print(round(d, 4))
6.4175