Class to model Jupiter planet.
Class Jupiter models that planet.
list of weak references to the object (if defined)
This method computes the apparent heliocentric position of planet Jupiter for a given epoch, using the VSOP87 theory.
Parameters: | epoch (Epoch) – Epoch to compute Jupiter position, as an Epoch object |
---|---|
Returns: | A tuple with the heliocentric longitude and latitude (as Angle objects), and the radius vector (as a float, in astronomical units), in that order |
Return type: | tuple |
Raises: | TypeError if input values are of wrong type. |
This method computes the time of the conjunction closest to the given epoch.
Parameters: | epoch (Epoch) – Epoch close to the desired conjunction |
---|---|
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(1993, 10, 1.0)
>>> conj = Jupiter.conjunction(epoch)
>>> y, m, d = conj.get_date()
>>> print(y)
1993
>>> print(m)
10
>>> print(round(d, 4))
18.3341
This method computes the geocentric position of Jupiter (right ascension and declination) for the given epoch, as well as the elongation angle.
Parameters: | epoch (Epoch) – Epoch to compute geocentric position, as an Epoch object |
---|---|
Returns: | A tuple containing the right ascension, the declination and the elongation angle as Angle objects |
Return type: | tuple |
Raises: | TypeError if input value is of wrong type. |
>>> epoch = Epoch(1992, 12, 20.0)
>>> ra, dec, elon = Jupiter.geocentric_position(epoch)
>>> print(ra.ra_str(n_dec=1))
12h 47' 9.6''
>>> print(dec.dms_str(n_dec=1))
-3d 41' 55.3''
>>> print(elon.dms_str(n_dec=1))
76d 2' 26.0''
This method computes the geometric heliocentric position of planet Jupiter for a given epoch, using the VSOP87 theory.
Parameters: |
|
---|---|
Returns: | A tuple with the heliocentric longitude and latitude (as Angle objects), and the radius vector (as a float, in astronomical units), in that order |
Return type: | tuple |
Raises: | TypeError if input values are of wrong type. |
>>> epoch = Epoch(2018, 10, 27.0)
>>> l, b, r = Jupiter.geometric_heliocentric_position(epoch)
>>> print(round(l.to_positive(), 4))
241.5873
>>> print(round(b, 4))
0.8216
>>> print(round(r, 5))
5.36848
This function computes the approximate magnitude of Jupiter.
Parameters: |
|
---|---|
Returns: | Jupiter’s magnitude |
Return type: | float |
Raises: | TypeError if input values are of wrong type. |
This method computes the time of the opposition closest to the given epoch.
Parameters: | epoch (Epoch) – Epoch close to the desired opposition |
---|---|
Returns: | The time when the opposition 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(-6, 9, 1.0)
>>> oppo = Jupiter.opposition(epoch)
>>> y, m, d = oppo.get_date()
>>> print(y)
-6
>>> print(m)
9
>>> print(round(d, 4))
15.2865
This method computes the orbital elements of Jupiter for the standard equinox J2000.0 for a given epoch.
Parameters: | epoch (Epoch) – Epoch to compute orbital elements, as an Epoch object |
---|---|
Returns: | A tuple containing the following six orbital elements: - Mean longitude of the planet (Angle) - Semimajor axis of the orbit (float, astronomical units) - eccentricity of the orbit (float) - inclination on the plane of the ecliptic (Angle) - longitude of the ascending node (Angle) - argument of the perihelion (Angle) |
Return type: | tuple |
Raises: | TypeError if input values are of wrong type. |
>>> epoch = Epoch(2065, 6, 24.0)
>>> l, a, e, i, ome, arg = Jupiter.orbital_elements_j2000(epoch)
>>> print(round(l, 6))
221.518802
>>> print(round(a, 8))
5.20260333
>>> print(round(e, 7))
0.0486046
>>> print(round(i, 6))
1.30198
>>> print(round(ome, 5))
100.58051
>>> print(round(arg, 6))
-86.107875
This method computes the orbital elements of Jupiter for the mean equinox of the date for a given epoch.
Parameters: | epoch (Epoch) – Epoch to compute orbital elements, as an Epoch object |
---|---|
Returns: | A tuple containing the following six orbital elements: - Mean longitude of the planet (Angle) - Semimajor axis of the orbit (float, astronomical units) - eccentricity of the orbit (float) - inclination on the plane of the ecliptic (Angle) - longitude of the ascending node (Angle) - argument of the perihelion (Angle) |
Return type: | tuple |
Raises: | TypeError if input values are of wrong type. |
>>> epoch = Epoch(2065, 6, 24.0)
>>> l, a, e, i, ome, arg = Jupiter.orbital_elements_mean_equinox(epoch)
>>> print(round(l, 6))
222.433723
>>> print(round(a, 8))
5.20260333
>>> print(round(e, 7))
0.0486046
>>> print(round(i, 6))
1.29967
>>> print(round(ome, 5))
101.13309
>>> print(round(arg, 6))
-85.745532
This function computes the time of passage by the nodes (ascending or descending) of Jupiter, nearest to the given epoch.
Parameters: |
|
---|---|
Returns: | Tuple containing: - Time of passage through the node (Epoch) - Radius vector when passing through the node (in AU, float) |
Return type: | tuple |
Raises: | TypeError if input values are of wrong type. |
>>> epoch = Epoch(2019, 1, 1)
>>> time, r = Jupiter.passage_nodes(epoch)
>>> year, month, day = time.get_date()
>>> print(year)
2025
>>> print(month)
9
>>> print(round(day, 1))
15.6
>>> print(round(r, 4))
5.1729
This method computes the time of Perihelion (or Aphelion) closer to a given epoch.
Parameters: |
|
---|---|
Returns: | The epoch of the desired Perihelion (or Aphelion) |
Return type: | Epoch |
Raises: | TypeError if input values are of wrong type. |
>>> epoch = Epoch(2019, 2, 23.0)
>>> e = Jupiter.perihelion_aphelion(epoch)
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
2023
>>> print(m)
1
>>> print(d)
20
>>> print(h)
11
>>> epoch = Epoch(1981, 6, 1.0)
>>> e = Jupiter.perihelion_aphelion(epoch, perihelion=False)
>>> y, m, d, h, mi, s = e.get_full_date()
>>> print(y)
1981
>>> print(m)
7
>>> print(d)
28
>>> print(h)
6
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.
Parameters: | epoch (Epoch) – Epoch close to the desired opposition |
---|---|
Returns: | Time when the 1st station in longitude 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(2018, 11, 1.0)
>>> sta1 = Jupiter.station_longitude_1(epoch)
>>> y, m, d = sta1.get_date()
>>> print(y)
2018
>>> print(m)
3
>>> print(round(d, 4))
9.1288
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.
Parameters: | epoch (Epoch) – Epoch close to the desired opposition |
---|---|
Returns: | Time when the 1st station in longitude 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(2018, 11, 1.0)
>>> sta2 = Jupiter.station_longitude_2(epoch)
>>> y, m, d = sta2.get_date()
>>> print(y)
2018
>>> print(m)
7
>>> print(round(d, 4))
10.6679
This table contains the parameters to compute Jupiter’s orbital elements for the mean equinox of date. Based in Table 31.A, page 213
This table contains the parameters to compute Jupiter’s orbital elements for the standard equinox J2000.0. Based on Table 31.B, page 215
This table contains Jupiter’s periodic terms (all of them) from the planetary theory VSOP87 for the heliocentric latitude at the equinox of date (taken from the ‘D’ solution). In Meeus’ book a shortened version can be found in pages 430-432.
This table contains Jupiter’s periodic terms (all of them) from the planetary theory VSOP87 for the heliocentric longitude at the equinox of date (taken from the ‘D’ solution). In Meeus’ book a shortened version can be found in pages 426-430.
This table contains Jupiter’s periodic terms (all of them) from the planetary theory VSOP87 for the radius vector at the equinox of date (taken from the ‘D’ solution). In Meeus’ book a shortened version can be found in pages 432-434.