SeitenAusgabebereich · 19 / 29

Ausgabebereich

Der Ausgabebereich liegt am unteren Rand des QuantCraft-Arbeitsbereichs und zeigt alles, was Ihr Code ausgibt oder zeichnet — print()-Anweisungen, Fehlermeldungen, Plots und den Fortschritt lang laufender Backtests.

Er wird von Run und Test gemeinsam genutzt: Jede Ausführung leert ihn und schreibt im Verlauf des Laufs neue Ausgabe. Strukturierte Kennzahlen und Charts erscheinen unter Testergebnisse.

Öffnen, Einklappen und Größe ändern

Der Bereich öffnet sich automatisch, sobald etwas Neues protokolliert oder geplottet wird, damit Sie keine Ausgabe verpassen.
Klicken Sie auf den Titel Output (oder den Pfeil daneben), um den Bereich ein- oder auszuklappen.
Die horizontale Trennlinie über dem Bereich lässt sich nach oben oder unten ziehen, um ihm mehr oder weniger Bildschirmplatz zu geben. Sie können die Trennlinie auch fokussieren und mit den Pfeiltasten Auf / Ab verschieben.
Die Höhe des Ausgabebereichs (und die Aufteilung des Editors) bleibt zwischen Sitzungen erhalten.

Logs (`stdout` und Laufmeldungen)

Alles, was Ihr Skript auf die Standardausgabe schreibt, erscheint als Log-Zeile mit Zeitstempel im Bereich:

[14:32:11] Loaded 480 bars
[14:32:11] Entering position at 192.40
[14:32:13] Final equity: 102450.13

Gut zu wissen:

Jeder Eintrag trägt den Zeitstempel Ihrer lokalen Uhr.
Log-Text verwendet eine Festbreitenschrift und bricht um, sodass lange Zeilen ohne horizontales Scrollen lesbar bleiben.
Der Bereich scrollt automatisch zur neuesten Meldung, sobald neue Ausgabe eintrifft – sowohl während des Laufs als auch direkt nach dessen Ende.
Ein kurzer Platzhalter (no output) erscheint, wenn Ihr Skript ohne Ausgabe beendet wurde.
Sind Kalenderdaten aktiviert, schreibt die Engine pro angewandter Kapitalmaßnahme (Split oder Dividende) eine [calendar]-Zeile sowie am Ende eine Zusammenfassung, zum Beispiel:
[calendar] 2024-01-10 AAPL — SPLIT 4:1 applied to 1 position(s): 100 -> 400 shares (cost basis unchanged; bars stay unadjusted) [calendar] 2024-02-09 AAPL — DIVIDEND $0.2400/share on 400 share(s): +$96.00 cash … [calendar] corporate actions — 1 split(s) applied; 1 dividend(s) applied (0 exact ex-date, 1 estimated +/-7d)
Erscheinen überhaupt keine [calendar]-Zeilen, prüfen Sie, ob Include calendar data im Ausführungsdialog aktiviert ist — siehe Kalenderdaten.
Bei einem Screener-Backtest erscheint neben Logs ein Tab Screener Output, der jedes Rebalancing-Datum und die in diesem Zeitfenster gehandelten Symbole auflistet — siehe Screener.

Pro Tab gilt eine Obergrenze von etwa 200 Einträgen; ältere Zeilen werden verworfen, wenn sie erreicht ist. Bei Läufen mit riesigen Ausgabemengen sollten Sie im Code zusammenfassen oder nur jeden N-ten Balken ausgeben.

Fehler (`stderr`)

Alles, was auf die Standardfehlerausgabe geschrieben wird — Exception-Tracebacks, Warnungen, die Ihr Code über stderr leitet, oder Framework-Meldungen — wird rot hervorgehoben und in der Kopfzeile des Bereichs gezählt:

Neben dem Titel Output erscheint ein kleines Badge N error / N errors, das zeigt, wie viele Fehlerzeilen protokolliert wurden.
Fehler behalten wie normale Log-Zeilen ihren Zeitstempel, sodass Sie sie den umgebenden Ereignissen zuordnen können.
Endet ein Lauf mit einem Exit-Code ungleich null, ohne selbst auf stderr geschrieben zu haben, sehen Sie eine einzelne Fehlerzeile (exit code N), damit Sie wissen, dass der Lauf fehlgeschlagen ist.

Die Fehleranzahl ist ein Live-Zähler — das Leeren der Ausgabe (das zu Beginn jedes Run / Test geschieht) setzt ihn zurück, und installiert der neue Lauf ein Paket oder erholt sich von einem früheren Fehler, wird die Zählung entfernt.

Plots

Der Ausgabebereich stellt Inline-Abbildungen aus Ihrem Code dar, sodass Sie keinen externen Viewer brauchen.

Matplotlib

Jede Matplotlib-Abbildung, die Ihr Code während des Laufs anzeigt, erscheint als PNG-Bild in der Breite des Bereichs. Sie eignen sich gut für schnelle explorative Charts.

Plotly

Plotly-Abbildungen werden als voll interaktive Charts im Bereich dargestellt:

Fahren Sie mit der Maus über eine Serie, um exakte Werte zu sehen.
Zoomen und verschieben Sie mit Maus / Touch.
Nutzen Sie die Plotly-Symbolleiste für Download, automatische Skalierung und weitere Aktionen.
Der Chart passt sich der Größe des Bereichs an.

Jeder Plot — Matplotlib oder Plotly — erscheint in einem eigenen umrahmten Block im Verlauf des Bereichs neben den Log-Zeilen, sodass Sie genau sehen, wo er im Verhältnis zu Ihrer print()-Ausgabe erzeugt wurde.

Plots und Logs teilen sich dieselbe Obergrenze pro Tab, sodass sehr lange Abbildungsfolgen irgendwann frühere Ausgaben aus dem Sichtbereich verdrängen.

Fortschritt bei langen Läufen

Läuft ein Backtest, erhält die Kopfzeile des Bereichs zwei zusätzliche Elemente, damit Sie den Fortschritt im Blick behalten, ohne auf scrollende Logs zu starren:

Einen Fortschrittsbalken mit einer Beschriftung wie:
- Bar 1234 / 5000 — wie viele simulierte Balken verarbeitet wurden.
- Run 3 / 10 — bei einer laufenden Optimierung der aktuell ausgeführte Lauf von insgesamt.
- Gen 2/5 · 7/16 — bei genetischer Optimierung die aktuelle Generation/das aktuelle Individuum.
- Backtest running, solange die Engine gestartet ist, aber noch kein genauer Fortschritt vorliegt.
Der Balken wächst, während die Engine Fortschritt meldet, und verschwindet, sobald der Lauf endet.

Sie können den Bereich einklappen, und der Fortschrittsbalken bleibt in der Kopfzeile sichtbar, sodass der Zustand des Laufs immer einen Blick entfernt ist — auch wenn Sie auf den Editor konzentriert sind.

Schaltfläche Disclaimer

Die Kopfzeile enthält eine Schaltfläche Disclaimer, die einen kurzen Hinweis dazu öffnet, wie QuantCraft Python auf Ihrem Rechner ausführt. Es ist dieselbe Erklärung wie vor Ihrem ersten Run, jederzeit zum erneuten Lesen verfügbar. Das Schließen dieses Dialogs ändert Ihre Einstellungen nicht.

Tipps

print() ist Ihr Freund beim schnellen Debuggen. Halten Sie Meldungen kurz und versehen Sie sie mit Kennzeichen (f"[ENTRY] {symbol} {qty} @ {price}"), damit sie leicht zu überfliegen sind.
Schreiben Sie lange Details in eine Datei, statt Tausende Zeilen auszugeben — nur die letzten ~200 Einträge bleiben sichtbar.
Fehler sind rot und werden im Badge gezählt — steigt die Zahl, scrollen Sie ans Ende; der neueste Fehler ist meist der, der den Lauf gestoppt hat.
Bei Plotly geben Sie dem Chart mit der Größenänderungs-Trennlinie des Bereichs mehr Höhe; er skaliert automatisch.
Der Bereich wird von allen Dateien gemeinsam genutzt: Wechseln Sie mitten im Lauf den Tab, gehört die angezeigte Ausgabe zur letzten bzw. aktiven Ausführung.

5 Min. LesezeitÄnderung vorschlagen ↗