14. Starten Sie QTEASY

Verwalten Sie qteasy-Startkonfigurationen

qteasy.run(op: Operator, **kwargs) → Union[dict, list]

Führen Sie den angegebenen Operator gemäß der aktuellen Konfiguration aus und geben Sie verschiedene Arbeitsmodi ein, z. B. Backtesting, Optimierung oder Live-Handel.

Diese Funktion ist der einheitliche Einstiegspunkt von qteasy: Basierend auf der globalen Konfiguration „QT_CONFIG[‚mode‘]“ (die vorübergehend über „qt.configure(mode=…)“ überschrieben werden kann) wählt sie den Live-Handelsmodus, den Backtest-Modus, den Optimierungsmodus usw. aus, bereitet automatisch die erforderlichen Datenquellen und Protokollobjekte vor und ruft „Operator.run()“ auf, um den vollständigen Workflow auszuführen. Detaillierte Informationen zum Verhalten und zur Ausgabestruktur jedes Modus finden Sie in den entsprechenden Abschnitten in der Dokumentation „Ausführen von qteasy und Arbeitsmodi“.

Parameter:

• op (Operator) – Ein Operator-Objekt mit bereits konfigurierten Strategien und Laufzeitparametern.

• **kwargs – Konfigurationselemente werden für diesen Lauf vorübergehend überschrieben; Die Schlüsselnamen müssen gültige qteasy-Konfigurationsschlüssel sein, wie „mode“, „asset_pool“, „invest_start“, „invest_end“ usw.

Rückgabe:

Wenn „mode == 1“ (Backtest-Modus) ist, wird normalerweise ein Diktat zurückgegeben, das Backtest-Ergebnisse enthält. wenn „mode == 2“ (Optimierungsmodus) ist, wird normalerweise eine Liste mit Ergebnissen für mehrere Parametersätze zurückgegeben. Die genaue Renditestruktur im Live-Handelsmodus und anderen Modi finden Sie unter Operator.run() und der zugehörigen Dokumentation.

Rückgabetyp:

dict or list

Examples

„run“ berührt typischerweise externe Zustände wie Datenquellen, Protokollpfade und Ausführungsmodi. Das folgende Beispiel zeigt den minimalen „sichtbaren und stabilen“ Anrufaufbau:

>>> import qteasy as qt
>>> op = qt.Operator('dma')
>>> op.__class__.__name__
'Operator'

Wenn Sie die Datenquelle und den Asset-Pool richtig konfiguriert haben, können Sie weiter ausführen (die Ausgabestruktur variiert je nach Modus)::

qt.run(op, mode=qt.BACKTEST_MODE)

qteasy.info(**kwargs)

Eingabefunktion für Hilfeinformationen zum Modul qteasy (reserviert).

Parameter:

**kwargs – Reservierter Parameter (wird in der aktuellen Version nicht verwendet).

Rückgabe:

In der aktuellen Version nicht implementiert; Der Aufruf löst „NotImplementedError“ aus.

Rückgabetyp:

None

Verursacht:

NotImplementedError – In der aktuellen Version nicht implementiert.

Examples

Diese Funktion ist ein reservierter Einstiegspunkt. Es wird empfohlen, die Sphinx-Dokumentation oder „help(qteasy)“ zu verwenden, um Hilfeinformationen zu erhalten:

>>> import qteasy as qt
>>> qt.info.__name__
'info'

Kurzreferenz zu Betriebsmodi und Konstanten

qteasy verwendet eine Reihe globaler Konstanten zur Darstellung der Ausführungsmodi (Live-Handel/Backtest/Optimierung/Prognose). Sie können sie vorübergehend vor oder nach dem Aufruf von „qt.run“ über „qt.configure(mode=…)“ oder innerhalb von „qt.run(op, mode=…)“ überschreiben.

Beispiel (konstante Werte erzeugen eine stabile Ausgabe):

>>> import qteasy as qt
>>> qt.LIVE_MODE, qt.BACKTEST_MODE, qt.OPTIMIZE_MODE, qt.PREDICT_MODE
(0, 1, 2, 3)

Protokoll- und Stammverzeichnispfadkonstanten (Werte werden von der Konfiguration beeinflusst, und insbesondere unterstützt der Protokollpfad Hot-Updates zur Laufzeit):

>>> import qteasy as qt
>>> isinstance(qt.QT_ROOT_PATH, str)
True
>>> isinstance(qt.QT_SYS_LOG_PATH, str) and isinstance(qt.QT_TRADE_LOG_PATH, str)
True