14. Iniciar QTEASY

Administrar qteasy configuraciones de inicio

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

Ejecute el Operator proporcionado de acuerdo con la configuración actual e ingrese a diferentes modos de trabajo, como backtesting, optimización o comercio en vivo.

Esta función es el punto de entrada unificado de qteasy: basado en la configuración global QT_CONFIG['mode'] (which can be temporarily overridden via qt.configure(mode=...)), it selects live trading mode, backtest mode, optimization mode, etc., automatically prepares the required data sources and log objects, and calls Operator.run() para ejecutar el flujo de trabajo completo. Para conocer el comportamiento detallado y la estructura de salida de cada modo, consulte las secciones relevantes en la documentación «Ejecución de qteasy y modos de trabajo».

Parámetros:

• op (Operator) – Un objeto Operator con estrategias y parámetros de tiempo de ejecución ya configurados.

• **kwargs – Elementos de configuración anulados temporalmente para esta ejecución; los nombres de las claves deben ser claves de configuración qteasy válidas, como mode, asset_pool, invest_start, invest_end, etc.

Devuelve:

Cuando mode == 1 (backtest mode), it usually returns a dict containing backtest results; when mode == 2 (modo de optimización), generalmente devuelve una lista que contiene resultados para múltiples conjuntos de parámetros; Para conocer la estructura de retorno exacta en el modo de negociación real y otros modos, consulte Operator.run() y la documentación relacionada.

Tipo del valor devuelto:

dict or list

Ejemplos

run normalmente toca estados externos, como fuentes de datos, rutas de registro y modos de ejecución. El siguiente ejemplo muestra la configuración mínima de llamada «visible y estable»:

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

Si ha configurado correctamente la fuente de datos y el grupo de activos, puede ejecutar más (la estructura de salida varía según el modo)::

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

qteasy.info(**kwargs)

Función de entrada para la información de ayuda del módulo qteasy (reservada).

Parámetros:

**kwargs – Parámetro reservado (no utilizado en la versión actual).

Devuelve:

No implementado en la versión actual; llamarlo generará NotImplementedError.

Tipo del valor devuelto:

None

Muestra:

NotImplementedError – No implementado en la versión actual.

Ejemplos

Esta función es un punto de entrada reservado. Se recomienda utilizar la documentación de Sphinx o help(qteasy) para obtener información de ayuda:

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

Referencia rápida de modos de ejecución y constantes

qteasy utiliza un conjunto de constantes globales para representar los modos de ejecución (comercio en vivo/prueba retrospectiva/optimización/previsión). Puede anularlos temporalmente antes o después de llamar a qt.run via qt.configure(mode=...), or within qt.run(op, mode=...).

Ejemplo (los valores constantes producen una salida estable):

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

Constantes de ruta de registro y directorio raíz (los valores se ven afectados por la configuración y, en particular, la ruta de registro admite actualizaciones en caliente en tiempo de ejecución):

>>> 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