README.de-DE.md

Marketstack Plotter

Ein erweitertes Plotter-Programm, welches Finanzdaten entweder über die Marketstack-API oder aus einer lokalen JSON-/CSV-Datei lädt und diese in zwei verschiedenen Plot-Bereichen visualisiert.

Inhaltsverzeichnis

• Über die App
• Features
• Installation
• Benutzung
• Screenshots

Über die App

Der Modern Data Plotter bietet zwei verschiedene Plotbereiche:

• Standard-Plot: Visualisiert den Standardverlauf von date gegen close.
• Benutzerdefinierter Plot: Hier können Benutzer individuell aus den geladenen Daten die x- und y-Achse wählen sowie weitere Plot-Einstellungen wie Titel, Achsenbeschriftungen, Diagrammtyp, Farbe, Legende und Colorbar festlegen.

Zudem können die geladenen Daten als JSON oder CSV gespeichert werden. Über die benutzerfreundliche Oberfläche lassen sich zudem Daten über die Marketstack-API abrufen oder lokal aus Dateien laden.

Features

• 📃 Datenquelle:
  • Laden von Finanzdaten über die Marketstack-API.
  • Laden von lokalen JSON- oder CSV-Dateien.
• 📈 Ploting📊:
  • Standardplot: date vs. close.
  • Benutzerdefinierter Plot mit frei wählbaren Achsen.
  • Unterstützung von Liniendiagrammen, Scatter-Plots und Balkendiagrammen.
• ⌨ UI-Elemente:
  • Dropdown-Menü für die 30 gängigsten Aktien-Symbole.
  • Textfeld zur Eingabe eigener Aktien-Symbole.
  • Farbauswahl, Legenden- und Colorbar-Option.
  • Menü- und Toolbar-Elemente mit Icons.
• 🖨 Datenexport:
  • Speichern des Plots als Bild (PNG/JPEG).
  • Export der Daten als JSON oder CSV.
• 🌙 Modernes Design:
  • Verwendung des qdarkstyle-Themes für ein modernes, dunkles Interface.

Installation

Empfolen ist eine venv (virtual environment) zu erstellen. Klicke hier um mehr zu erfahren:

python -m venv market-plotter

venv aktivieren:

Windows:

.market-plotter\Scripts\activate

Linux/macOS:

source market-plotter/bin/activate

deaktivieren von virtual environment

```bash deactivate ```

entfernen der virtual environment:

Windows:

rmdir /S /Q market-plotter

Linux/macOS:

rm -rf market-plotter

virtual environment umbenennen:

First, deactivate if active

deactivate

Windows (CMD):

 ren market-plotter new_name

Linux/macOS:

  mv market-plotter new_name

Nach dem Umbenennen, überprüfe und aktualisiere absolute Pfade in den Aktivierungsskripten, falls notwendig.

Stelle sicher, dass Python 3 installiert ist. Anschließend können die benötigten Pakete via pip installiert werden:

pip install PySide6 matplotlib qdarkstyle pandas requests

Alternativ kann auch das requirements.txt-File genutzt werden:

pip install -r requirements.txt

Falls gewünscht, kann das Programm auch als ausführbare Datei exe für Windows-Systeme erstellt werden. Hierfür wird das Paket pyinstaller benötigt:

pip install pyinstaller

Anschließend kann das Programm mit folgendem Befehl kompiliert werden:

pyinstaller --onefile --windowed --icon=icon.ico MarketDataAPIv3.py

Benutzung

❗ Vor der Programmstart sollte ein marketstack.com Key in den .env hinzugefügt werden.

Das Programm kann über die Kommandozeile gestartet werden:

python MarketDataAPIv3.py

Nach dem Start des Programms kann entweder ein Aktien-Symbol aus dem Dropdown-Menü ausgewählt oder ein eigenes Symbol eingegeben werden. Anschließend kann entweder über die API oder über eine lokale Datei die Daten geladen werden.

Custom-Plot-Optionen können über die GUI eingestellt werden. Der Plot kann als Bild gespeichert oder die Daten exportiert werden.

Screenshots

UI PySide6

Quellen

• SVGREPO
• Marketstack