Skip to main content

A Python package for M. Müller implementation of the 'Equation of Time - Problem in Astronomy' to calculate EOT and the effect of eccentricity/obliquity

Project description

Muller-EOT

PyPi license

A Python package for M. Müller implementation of the "Equation of Time - Problem in Astronomy" to calculate EOT and the effect of eccentricity/obliquity

The combined effect of eccentricity and obliquity create the Equation of Time components.

Effect of Eccentricity Effect of Obliquity
effect_eccentricity effect_obliquity

Combined Effect of the Eccentricity and Obliquity = Equation of Time effect_eot

Overview

There are only four times of year where the length of the day is almost exactly 24 hours. The rest of the year when the sun is at its highest point (solar noon), a clock can run as much as 16 minutes ahead (12:16pm) or 13 minutes behind (11:47am). This discrepency is the result of combined effect of a planet's obliquity (axial tilt) and its eccentricity (as well as other smaller gravitional forces like moons that are ignored here). Both of thsee features form two sine curves that oscillate throughout the year. The combined sum of these two curves form the Equation of Time, a non-uniform change in time to fix to a clock. A planet with an obliquity of 0° and perfectly circular orbit (zero eccentricity) would have no difference in the Expected Solar Noon and the Actual Solar Noon.

Equation of Time = (Apparent Solar Time) - (Mean Solar Time)

Effect of Eccentricity:

Effect of Obliquity:

"Equation of time is determined by the following parameters: the eccentricity of the orbit of the Earth, the angle between the ecliptic and the equatorial planes, the angle P between the winter solstice and the perihelion relative to the sun or: the time span ∆t from the beginning of winter to the passage through periehlion" (Müller, 1995)

The effect of obliquity and eccentricity are the caused as a result of Kepler's law:

"Two well-known features of our solar system are at the basis of the variations in the apparent motion of the sun: 1.) According to Kepler's second law, the angular velocity of the Earth relative to the sun varies throughout a year. 2) Equal angles which the sun in its apparent movement goes through in the eclipitic do not correspond to equal angles we measure on the equatorial plane. However, it is these latter angles which are relevant for the measure of time, since the daily movement of the sun is parallel to the equatorial plane" (Müller, 1995)

Effect on Angular Velocity:

As a result of Kepler's law, planets moving in an ellipitc orbit will have variable angular velocity as a result of the second law where the area swept during a constant period of time is constant (=dA/dt)

"1.) parameter: the eccentricity. If e = 0 a regular variation results that is caused by the inclination of the ecliptic plane. The deviations of the apparent solar time from the mean solar time increase with growing e in winter and autumn. Thus, the yearly variation becomes dominant. Since at the perihelion and aphelion the equation of time is only a function of the ecliptic inclination and the angle P, all plots have the same value at these two points. 2.) parameter: the inclination of the ecliptic. ε = 0 yields a plot which is symmetric to the passage through the aphelion. The greater ε the more dominant the variation with a period of half a year. All plots have four common points at the beginning of each season, for the equation of time depends only on the two other parameters there (eccentricity and P). As the projection from the ecliptic plane onto the equatorial plane does not change the polar angle relative to the winter solstice, ε does not influence the value of the equation of time at the beginning of a season. 3.) parameter: the time interval between the beginning of winter and the passage through the perihelion. If ∆t = 0 the two main variations vanish both at the beginning of winter and summer (because winter begins when the earth passes the perihelion; the aphelion is the summer solstice). Therefore, the resulting function is symmetric and the extreme values are in autumn and winter. If ∆t increases, the two components tend to compensate each other in winter whereas the negative value in summer begins to dominate." (Müller, 1995)

Equation of Time is the combination of the effect of eccentricity and obliquity

To calculate the difference in time for an individual day:

Documentation

Calculate the difference in time (in minutes) based on orbital period, eccentricity, and obliquity. Returns a list of differences in time for each day in the orbital year

calculateDifferenceEOTMinutes(eccentricity=None,
				obliquity_deg=None,
				orbit_period=None)

Plot the differences in time for the EOT as well as the individual effect of obliquity and eccentricity

plotEOT(planet_name=None,
	eot_dict={},
	effect_title_str=None,
	plot_title=None,
	plot_x_title=None,
	plot_y_title=None,
	showPlot=True,
	fig_plot_color="C0",
	figsize_n=12,
	figsize_dpi=100,
	save_plot_name=None)

Dependencies

Python 3.7

pip3 install -r requirements.txt

Install

PyPi pip install at pypi.org/project/muller-eot/

pip install muller-eot

Examples

Get a list of differences in time for each day of the Earth's orbit and then plot it as a function of days in orbit

import muller_eot

# Get a list of time differences for each day
eot_combined_dict = muller_eot.calculateDifferenceEOTMinutes(eccentricity=0.0167,
															obliquity_deg=23.45,
															orbit_period=365.25)

# Plot differences in time as a function of days
muller_eot.plotEOT(planet_name="Earth",
					eot_dict=eot_combined_dict,
					effect_title_str="Eccentricity (0.0167) and Obliquity (23.45)")

Tests

TODO

TODO:

calculateOrbitalPeriod(semimajor_axis) function

calculateDistanceBetweenSolisticePerhelion() function

calculatePerihelionDay() function

calculateWinterSolsticeDay() function

calculateEccentricity() function

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

muller-eot-1.3.1.tar.gz (8.9 kB view details)

Uploaded Source

Built Distribution

muller_eot-1.3.1-py3-none-any.whl (9.7 kB view details)

Uploaded Python 3

File details

Details for the file muller-eot-1.3.1.tar.gz.

File metadata

  • Download URL: muller-eot-1.3.1.tar.gz
  • Upload date:
  • Size: 8.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.3

File hashes

Hashes for muller-eot-1.3.1.tar.gz
Algorithm Hash digest
SHA256 ee686b5072360546a5737edf6e4036d53109093c19084366bcd9db7c16c9d7ac
MD5 0595fd5a97f142b8589d18974c95aa2f
BLAKE2b-256 0c7b2a6d6994bb40e0352af3c5c64b8f8056ec62ae569bde2f4552fe4c0c5691

See more details on using hashes here.

Provenance

File details

Details for the file muller_eot-1.3.1-py3-none-any.whl.

File metadata

  • Download URL: muller_eot-1.3.1-py3-none-any.whl
  • Upload date:
  • Size: 9.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.1 CPython/3.7.3

File hashes

Hashes for muller_eot-1.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 cc667dd7d188cc35d499945abae38dbdac9260e75b344c8cfd9aca7f4a05ddd3
MD5 2411fe8c27d1d42db202d6e33a87aa29
BLAKE2b-256 f1eff5d391c7dfc6b57e1f80120b9503e23407149f95d72c6b6df41b99ebdef8

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page