EPHEMERIDENRECHNUNG VENUS – PYTHON
===================================

LIZENZ
======

Alle in diesem Archiv enthaltenen Dateien sind unter der Lizenz

Creative Commons Namensnennung – Weitergabe unter gleichen Bedingungen
3.0 Deutschland (CC BY-SA 3.0 DE)

lizenziert.

Dies betrifft insbesondere:

- das Python-Programm
- die Datei LIESMICH.txt
- eventuell enthaltene Grafiken und weitere Begleitdateien

Lizenz:
CC BY-SA 3.0 DE


PROGRAMM
===================================

Dieses Programm ist die Python-Portierung der ursprünglichen MATLAB-
Ephemeridenrechnung zum Artikel

"Himmelsmechanik – Bahnelemente und Ephemeriden"
auf https://www.skywatch-blog.de/

Das Programm berechnet die Position der Venus auf Grundlage der im
Artikel verwendeten historischen Bahnelemente nach Montenbruck.

Die ursprüngliche MATLAB-Version stammt aus dem Jahr 2015/2016.
Die Python-Version wurde 2026 überarbeitet und enthält insbesondere
eine korrigierte Grad-/Radiant-Behandlung sowie das Newton-Raphson-
Verfahren zur Lösung der Keplergleichung.


VERWENDETE PYTHON-BIBLIOTHEKEN
==============================

1. math
-------

Python-Standardbibliothek.

Verwendet für mathematische Funktionen und Konstanten, unter anderem:

- sin()
- cos()
- atan2()
- sqrt()
- radians()
- degrees()
- pi

Eine zusätzliche Installation ist nicht erforderlich.


2. datetime
-----------

Python-Standardbibliothek.

Verwendet zur Verarbeitung von Datum und Uhrzeit sowie zur Berechnung
der seit der Referenzepoche vergangenen Zeit.

Eine zusätzliche Installation ist nicht erforderlich.


3. matplotlib
-------------

Externe Python-Bibliothek.

Verwendet zur grafischen Darstellung der berechneten Planetenpositionen
und Umlaufbahnen in einem dreidimensionalen Koordinatensystem.

Installation:

    pip install matplotlib

Empfohlene Version:

    matplotlib >= 3.7


INSTALLATION
============

Eine aktuelle Python-3-Version muss installiert sein.

Anschließend kann die benötigte externe Bibliothek mit

    pip install -r requirements.txt

installiert werden.

Alternativ:

    pip install matplotlib


PROGRAMMSTART
=============

Das Programm wird über die Kommandozeile gestartet:

    python ephemeriden.py

Unter Windows kann je nach Python-Installation auch

    py ephemeriden.py

verwendet werden.


PROGRAMMAUSGABE
===============

Das Programm erzeugt:

- numerische Ergebnisse im Terminal
- die heliozentrischen Koordinaten der Erde und Venus
- geozentrische Koordinaten der Venus
- Entfernung Erde–Venus
- ekliptische Länge und Breite
- Rektaszension und Deklination
- ein dreidimensionales Matplotlib-Diagramm der Umlaufbahnen


DATUM UND UHRZEIT
=================

Das gewünschte Datum und die Uhrzeit können im oberen Bereich des
Python-Skripts angepasst werden.

Das Standardbeispiel entspricht der Rechnung aus dem Artikel:

    11.06.2016
    13:30:00


MATHEMATISCHES MODELL
=====================

Die Berechnung basiert auf einer vereinfachten Keplerbahn mit den im
Artikel verwendeten Bahnelementen nach Montenbruck.

Die Keplergleichung

    E - e*sin(E) = M

wird numerisch mit dem Newton-Raphson-Verfahren gelöst.

Innerhalb der numerischen Iteration werden Winkel im Bogenmaß
verarbeitet. Für die weitere Darstellung werden sie anschließend
wieder in Grad umgerechnet.


DATEIEN
=======

ephemeriden.py
    Hauptprogramm der Ephemeridenrechnung

requirements.txt
    Liste der extern benötigten Python-Bibliotheken

LIESMICH.txt
    Beschreibung des Programms und der verwendeten Bibliotheken


ABHÄNGIGKEITEN
===============

Externe Abhängigkeit:

    matplotlib>=3.7

Die Module "math" und "datetime" sind Bestandteil der
Python-Standardbibliothek und müssen nicht separat installiert werden.


LIZENZ
======

CC BY-SA 3.0 DE


