Resultados de las pruebas

Tras cada backtest (Test en Ejecución de código), el IDE abre Test Results para el archivo que ejecutaste. Es la segunda vista del selector Code Editor / Test Results del editor (Diseño del espacio de trabajo) y muestra todo lo que el motor produjo en esa ejecución: gráficos, estadísticas de rendimiento, operaciones y una exportación HTML. Los registros y gráficos durante la ejecución se transmiten al panel de salida.

Cada archivo abierto tiene sus propios Test Results: al cambiar de archivo se muestra el último resultado de ese archivo.

---

Dónde aparece

• Tras hacer clic en Test en la barra de herramientas, la vista cambia automáticamente a Test Results cuando los resultados están listos.
• Puedes alternar entre Code Editor y Test Results en cualquier momento con la pequeña tira de pestañas sobre el área del editor.
• Los banners de estado de la parte superior del panel indican en qué estado está la ejecución:
  • Running backtest — <file> mientras el motor está trabajando.
  • Backtest failed — <file> con la traza del error si algo salió mal.
  • Backtest result — <file> cuando una ejecución única terminó correctamente.
  • Optimization — <file> con una tira de pestañas cuando ejecutaste una optimización de parámetros (consulta Ejecuciones de optimización al final).

Si un archivo nunca se ha probado, verás un estado vacío amistoso que te remite al botón Test.

---

Estructura de una ejecución correcta

El resultado de un backtest correcto se divide de arriba abajo en tres regiones redimensionables y contraíbles:

1. Panel de gráfico — el gráfico de precios con marcadores (y pestañas por símbolo en ejecuciones con varios símbolos).
2. Performance — gráfico de capital y saldo, más la cuadrícula de métricas.
3. Trades — operaciones cerradas y (cuando corresponda) posiciones abiertas al final de la ejecución.

1. Panel de gráfico

La región superior muestra las barras OHLC usadas en la ejecución con las superposiciones de tu estrategia:

• Se dibujan marcadores de operaciones en los puntos de entrada y salida.
• Las superposiciones de indicadores aparecen aquí cuando tu código las añadió mediante chart_indicators (consulta la documentación de Series de indicadores). Las líneas y los histogramas se muestran en el panel principal o en un subpanel separado bajo las velas, exactamente como los configuraste.
• Las ejecuciones con varios símbolos tienen una tira de pestañas sobre el gráfico: una pestaña por ticker. Haz clic en una pestaña para cambiar el gráfico del símbolo que estás viendo. La carga útil del resultado incluye clock_symbol (qué ticker marca el calendario), ohlcv.bars_by_symbol (listas de barras por ticker) y entradas chart_indicator_series filtradas por symbol para cada pestaña.
• Una pequeña barra de herramientas del gráfico sobre el gráfico aloja el botón Export HTML (ver más abajo) y, en las vistas de optimización, la etiqueta de parámetros de la ejecución.

Si un resultado no tiene ohlcv.bars que dibujar, el área del gráfico se sustituye por una breve nota y la barra de exportación para que aún puedas guardar un informe HTML.

2. Performance

Haz clic en Performance para expandir el panel. Contiene dos partes:

Gráfico de capital y saldo

Un gráfico de líneas de tu cuenta durante la ejecución:

• Equity — valor de la cuenta a precio de mercado en cada paso.
• Balance — saldo en efectivo liquidado a lo largo de la misma línea de tiempo.

El gráfico se submuestrea automáticamente en ejecuciones muy largas y usa etiquetas de eje basadas en el tiempo para que puedas leer la línea temporal de un vistazo.

Cuadrícula de métricas

Una cuadrícula de estadísticas resumen generadas por account.refresh_metrics(...) al final de la ejecución. Insignias con código de color resaltan los valores con signo (ganancias en verde, pérdidas en rojo).

Las celdas muestran — cuando una métrica no está disponible para la ejecución (por ejemplo, sin operaciones cerradas no hay factor de beneficio).

3. Trades

La región inferior tiene hasta dos tablas:

Operaciones cerradas

Cada ida y vuelta ejecutada por account.open_trade(...) + account.close_trade(...). Las columnas incluyen side, quantity, entry price, exit price, entry time, exit time y realized P/L (con código de color).

Cuando los datos de calendario están activados, aparecen filas de Split y Dividend intercaladas entre las filas de operaciones — una por cada acción corporativa aplicada durante la ejecución — y la tarjeta se titula Closed trades & events. Una fila de Split muestra la fecha, la proporción (p. ej. 4:1) y el cambio en el número de acciones; una fila de Dividend muestra la fecha, el importe por acción y el efectivo total abonado (o cargado, en el caso de una posición corta). Una fecha ex-dividendo estimada se marca como est. Estas filas no llevan marcador # en el gráfico y se excluyen de la exportación CSV, que sigue siendo un registro limpio de operaciones.

• Haz clic en Closed trades para contraer o expandir la tabla.
• Haz clic en la hora de entrada/salida de cualquier fila para saltar a ese evento en el gráfico.
• Usa Export CSV en la parte superior de esta sección para guardar las operaciones cerradas en un archivo .csv (con un cuadro Save As del sistema cuando se admita).

Posiciones abiertas (fin de la ejecución)

Se muestran solo cuando la estrategia terminó la ejecución con posiciones abiertas todavía en los libros. Mismas convenciones de columnas que las operaciones cerradas, además del identificador de posición que usa tu código.

Consejo: el panel de operaciones se redimensiona automáticamente al contraerlo; contráelo para dar más espacio vertical al gráfico y a Performance.

---

Exportación HTML

Usa Export HTML (arriba a la derecha de la barra de herramientas del gráfico) para guardar un único archivo .html autónomo con todo lo que ves en pantalla:

• Cada panel de gráfico (una imagen por símbolo en ejecuciones con varios símbolos).
• El gráfico de capital y saldo.
• Las métricas de Performance.
• La tabla de operaciones cerradas.
• El título del informe (tomado del nombre del archivo) y la hora en que se generó.

Cómo funciona:

1. El IDE expande brevemente el panel Performance para poder capturar el gráfico de capital.
2. Recorre cada pestaña de gráfico y captura el gráfico como PNG.
3. El resultado se empaqueta en un único archivo HTML y se ofrece mediante un cuadro de guardado (nombre de archivo como backtest-report-<timestamp>.html).

Abre el archivo en cualquier navegador para compartir la ejecución con alguien que no tenga el IDE; no hace falta conexión a Internet.

El botón muestra Exporting… mientras trabaja. No cambies de pestaña ni cierres el IDE durante la exportación, o podrían faltar algunos paneles en el archivo guardado.

---

Estados de la ejecución (referencia rápida)

---

Ejecuciones de optimización

Cuando probaste con Optimize script parameters activado, Test Results muestra una tira de pestañas — una pestaña por combinación de parámetros — y cualquier información de resumen, como el número total de ejecuciones, la métrica de aptitud en las ejecuciones genéticas y el progreso mientras aún terminan ejecuciones.

• Haz clic en una pestaña para cargar el gráfico, el Performance y las operaciones de esa ejecución igual que en una ejecución única.
• La etiqueta de parámetros de la ejecución seleccionada se muestra junto a la barra de herramientas del gráfico para que siempre sepas qué combinación estás viendo.
• Export HTML usa los datos de la ejecución activa, con la etiqueta de la ejecución como título del informe.
• Si la optimización se detuvo antes de tiempo, un banner lo resalta y solo se muestran las ejecuciones completadas.

---

Consejos

• Contrae los paneles que no necesites (gráfico, Performance o Trades) para centrarte en el resto.
• Cambiar de archivo carga los últimos resultados de prueba de ese archivo; tus otras pestañas no se pierden.
• En backtests muy largos, el gráfico de capital se submuestrea para mayor fluidez; los números subyacentes de la cuadrícula de métricas no se ven afectados.
• El CSV es para las operaciones cerradas; el HTML es para todo. Usa el que mejor se ajuste a cómo quieras compartir o analizar la ejecución.