PáginasPanel de salida · 19 / 29

Panel de salida

El panel de salida está en la parte inferior del espacio de trabajo de QuantCraft y es donde aparece todo lo que tu código dice o dibuja: instrucciones print(), mensajes de error, gráficos y el progreso de los backtests largos.

Se comparte entre Run y Test: cada ejecución lo borra y escribe salida nueva a medida que avanza. Las métricas y los gráficos estructurados aparecen en Resultados de las pruebas.

Abrir, contraer y cambiar el tamaño

El panel se abre automáticamente en cuanto se registra o dibuja algo nuevo, para que no te pierdas ninguna salida.
Haz clic en el título Output (o en la flecha junto a él) para contraer o expandir el panel.
El divisor horizontal sobre el panel se puede arrastrar hacia arriba o hacia abajo para darle más o menos espacio en pantalla. También puedes enfocar el divisor y usar las flechas Arriba / Abajo para ajustarlo.
La altura del panel de salida (y la división del editor) se recuerda entre sesiones.

Registros (`stdout` y mensajes de ejecución)

Todo lo que tu script escribe en la salida estándar aparece como una línea de registro con marca de tiempo en el panel:

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

Conviene saber:

Cada entrada lleva la marca de tiempo de tu reloj local.
El texto del registro usa una fuente monoespaciada y se ajusta para que las líneas largas sigan siendo legibles sin desplazamiento horizontal.
El panel se desplaza automáticamente hasta el último mensaje a medida que llega salida nueva, tanto durante la ejecución como justo después de que termine.
Se muestra un breve marcador (no output) si tu script terminó sin nada que imprimir.
Cuando los datos de calendario están activados, el motor escribe una línea [calendar] por cada acción corporativa aplicada (split o dividendo), además de un resumen al final, por ejemplo:
[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)
Si no aparece ninguna línea [calendar], comprueba que Include calendar data esté activado en el cuadro de ejecución — consulta Datos de calendario.
En un backtest con Screener, aparece una pestaña Screener Output junto a Logs, que lista cada fecha de rebalanceo y los símbolos operados en esa ventana — consulta Screener.

Hay un límite de unas 200 entradas por pestaña; las líneas más antiguas se descartan al alcanzarlo. Para ejecuciones que producen enormes cantidades de salida, es preferible resumir en el código o imprimir una de cada N barras.

Errores (`stderr`)

Todo lo escrito en la salida de error estándar — trazas de excepciones, advertencias que tu código envía por stderr o mensajes del framework — se resalta en rojo y se cuenta en la cabecera del panel:

Una pequeña insignia N error / N errors aparece junto al título Output e indica cuántas líneas de error se registraron.
Los errores conservan su marca de tiempo como las líneas de registro normales, para que puedas relacionarlos con los eventos de alrededor.
Si una ejecución termina con un código de salida distinto de cero pero no escribió nada en stderr, verás una única línea de error (exit code N) para saber que la ejecución falló.

El recuento de errores es un contador en vivo: borrar la salida (lo que ocurre al comienzo de cada Run / Test) lo reinicia, y si la nueva ejecución instala un paquete o se recupera de un fallo anterior, el recuento se elimina.

Gráficos

El panel de salida renderiza figuras integradas de tu código, así que no necesitas un visor externo.

Matplotlib

Cualquier figura de Matplotlib que tu código muestre durante la ejecución aparece como una imagen PNG ajustada al ancho del panel. Son ideales para gráficos exploratorios rápidos.

Plotly

Las figuras de Plotly se renderizan como gráficos totalmente interactivos dentro del panel:

Pasa el cursor sobre una serie para ver los valores exactos.
Haz zoom y desplázate con el ratón / el tacto.
Usa la barra de herramientas de Plotly para descargar, autoajustar la escala y otras acciones.
El gráfico cambia de tamaño con el panel.

Cada gráfico — de Matplotlib o de Plotly — aparece en su propio bloque enmarcado en la línea de tiempo del panel junto a las líneas de registro, para que veas exactamente dónde se produjo respecto a tu salida de print().

Los gráficos y los registros comparten el mismo límite por pestaña, así que secuencias muy largas de figuras acabarán desplazando de la vista la salida anterior.

Progreso de ejecuciones largas

Cuando hay un backtest en ejecución, la cabecera del panel muestra dos elementos adicionales para que puedas vigilar el progreso sin mirar registros que se desplazan:

Una barra de progreso con una etiqueta como:
- Bar 1234 / 5000 — cuántas barras simuladas se han procesado.
- Run 3 / 10 — en una optimización en curso, la ejecución actual sobre el total.
- Gen 2/5 · 7/16 — en la optimización genética, generación/individuo actual.
- Backtest running mientras el motor ha empezado pero aún no hay un progreso exacto disponible.
La barra crece a medida que el motor informa del progreso y desaparece en cuanto termina la ejecución.

Puedes contraer el panel y la barra de progreso sigue visible en la cabecera, de modo que el estado de la ejecución está siempre a un vistazo, aunque estés concentrado en el editor.

Botón Disclaimer

La cabecera tiene un botón Disclaimer que abre un breve aviso sobre cómo QuantCraft ejecuta Python en tu máquina. Es la misma explicación que ves antes de tu primer Run, disponible en cualquier momento por si quieres releerla. Cerrar este cuadro no cambia tu configuración.

Consejos

print() es tu aliado para depurar rápido. Mantén los mensajes cortos y etiquétalos (f"[ENTRY] {symbol} {qty} @ {price}") para escanearlos fácilmente.
Envía los detalles largos a un archivo desde tu código en lugar de imprimir miles de líneas: solo las últimas ~200 entradas permanecen visibles.
Los errores son rojos y se cuentan en la insignia: cuando veas subir el recuento, desplázate al final; el último error suele ser lo que detuvo la ejecución.
Para Plotly, usa el divisor de cambio de tamaño del panel para darle más altura al gráfico; se escala automáticamente.
El panel está compartido entre archivos: si cambias de pestaña durante una ejecución, la salida que ves corresponde a la última ejecución / la activa.

6 min de lecturaSugerir una edición ↗