# MANUAL DE USUARIO - KICKER BY ĐIEGO
## Sistema de Análisis y Correlación de Estrategias de Trading

**Versión:** 1.2 (Estable)  
**Fecha:** Enero 2026  
**Autor:** Diego Tobón  
**Última Actualización:**   

---

## 📋 Tabla de Contenidos

1. [Introducción](#introducción)
2. [Instalación y Requisitos](#instalación-y-requisitos)
3. [Interfaz Principal](#interfaz-principal)
4. [Flujo de Trabajo Completo](#flujo-de-trabajo-completo)
5. [Análisis Simple vs Avanzado](#análisis-simple-vs-avanzado)
6. [Métricas Calculadas](#métricas-calculadas)
7. [Interpretación de Resultados](#interpretación-de-resultados)
8. [Gráficas de Equity](#gráficas-de-equity)
9. [Solución de Problemas](#solución-de-problemas)
10. [Preguntas Frecuentes](#preguntas-frecuentes)

---

## Introducción

**Kicker by Diego Tobón** es una herramienta profesional diseñada para comparar y validar estrategias de trading entre dos plataformas: **StrategyQuant (SQX)** y **MetaTrader 4/5 (MT4/MT5)**. El objetivo principal es determinar qué timeframe de MT produce resultados más similares a los backtests de SQX, calculando correlaciones y métricas estadísticas avanzadas.

### ¿Para Qué Sirve?

Cuando desarrollas una estrategia en StrategyQuant y quieres validarla en MetaTrader, necesitas saber:

- ¿El backtest de MT coincide con el de SQX?
- ¿Qué timeframe de MT (M5, H1, H4, D1) produce la mejor correlación?
- ¿Las métricas de profit, drawdown y win rate son comparables?
- ¿Hay diferencias significativas en el número de trades?

Kicker responde estas preguntas automáticamente, analizando hasta 500 estrategias en múltiples timeframes y generando un ranking ordenado por correlación.

### Características Principales

- **Análisis 1-1, 1-N, N-N:** Compara una estrategia SQX con múltiples MT, o múltiples SQX con múltiples MT
- **Matching Inteligente:** Solo compara estrategias con el mismo nombre base (ej: Strategy 2.3.6 vs Strategy_2.3.6_h1)
- **Filtrado de Fechas:** Los trades de SQX se filtran automáticamente al rango de fechas del backtest MT
- **37 Métricas Avanzadas:** Incluye Profit Factor, Sharpe Ratio, Calmar Ratio, Stability R², Skewness, Kurtosis, MAE/MFE
- **Gráficas Interactivas:** Visualiza curvas de equity y drawdown con colores distintos por estrategia
- **Modos Simple y Avanzado:** Elige entre análisis rápido (16 columnas) o completo (37 columnas)
- **Exportación de Gráficas:** Guarda gráficas en PNG de alta resolución (300 DPI)

---

## Instalación y Requisitos

### Requisitos del Sistema

| Componente | Requisito Mínimo | Recomendado |
|------------|------------------|-------------|
| **Sistema Operativo** | Windows 10 (64-bit) | Windows 11 |
| **RAM** | 4 GB | 8 GB o más |
| **Espacio en Disco** | 500 MB | 2 GB (para reportes) |
| **Python** | 3.8 o superior | 3.11 |
| **MetaTrader** | MT4 o MT5 instalado | Ambos |

### Dependencias de Python

El ejecutable incluye todas las dependencias, pero si ejecutas desde código fuente, necesitas:

```bash
pip install pandas numpy scipy matplotlib PyQt6 beautifulsoup4
```

### Archivos Necesarios

Antes de iniciar, asegúrate de tener:

1. **Archivos CSV de StrategyQuant** (extensión `.csv`)
   - Deben contener columnas: `Open time`, `Close time`, `Profit/Loss`, `MAE ($)`, `MFE ($)`
   - Formato de fecha: `YYYY-MM-DD HH:MM:SS` o `DD.MM.YYYY HH:MM`

2. **Reportes HTML de MetaTrader** (extensión `.html` o `.htm`)
   - Generados desde Strategy Tester de MT4/MT5
   - Deben contener la tabla de trades con columnas: `Time`, `Type`, `Order`, `Size`, `Price`, `S/L`, `T/P`, `Profit`

3. **Archivos OHLC (Opcional)**
   - Para calcular MAE/MFE desde datos de mercado
   - Formato: `Time,Ask,Bid,Volume`

### Instalación

1. Descarga el archivo `KICKER_FINAL_V36.zip`
2. Extrae en una carpeta (ej: `C:\Kicker\`)
3. Ejecuta `dicker_gui_final.exe` (o `python dicker_gui_final.py` si usas código fuente)
4. La aplicación se abrirá y mostrará el mensaje: **"Análisis se habilitará en 5 segundos"**
5. Espera 5 segundos para que la inicialización complete

---

## Interfaz Principal

La aplicación tiene **3 pestañas principales**:

### 1. Pestaña MT4

Configuración para generar backtests automáticos en MetaTrader 4.

**Campos principales:**
- **Carpeta de Instalación MT4:** Ruta del ejecutable `terminal.exe` (ej: `C:\Program Files (x86)\MetaTrader 4\terminal.exe`)
- **Carpeta de Expertos:** Donde están los archivos `.ex4` (ej: `C:\Users\...\MQL4\Experts`)
- **Símbolo:** Par o instrumento a testear (ej: `XAUUSD`, `EURUSD`)
- **Modelo:** `Every Tick` (más preciso), `Control Points`, `Open Prices`
- **Fechas:** Rango de backtest (desde/hasta)
- **Deposit:** Capital inicial (ej: `10000`)
- **Leverage:** Apalancamiento (ej: `500`)
- **Spread:** `Current` (actual del broker) o valor fijo en puntos

**Botones:**
- **Seleccionar Estrategias:** Abre diálogo para elegir archivos `.ex4`
- **Generar y Ejecutar:** Crea archivos `.ini` y `.bat`, luego ejecuta backtests en MT4

### 2. Pestaña MT5

Idéntica a MT4, pero para MetaTrader 5. Los archivos de expertos tienen extensión `.ex5`.

### 3. Pestaña Analizador

**Aquí se realiza el análisis de correlaciones.**

#### Sección Superior: Archivos SQX

- **Directorio SQX:** Carpeta con archivos CSV de StrategyQuant
- **Botones:**
  - **Agregar CSV:** Selecciona archivos individuales
  - **Agregar Directorio:** Carga todos los CSV de una carpeta
  - **Select All / Remove Selected / Clear All:** Gestión masiva de archivos

**Tabla de archivos SQX:**
- Columna 1: Nombre del archivo
- Columna 2: **Timeframe Manual** (dropdown: Auto, M1, M5, M15, M30, H1, H4, D1)
  - **Auto:** Detecta automáticamente el timeframe desde la duración promedio de trades
  - **Manual:** Fuerza un timeframe específico (útil si la detección falla)

#### Sección Media: Archivos MT

- **Directorio MT:** Carpeta con reportes HTML de MetaTrader
- **Botones:** Idénticos a la sección SQX

**Lista de archivos MT:**
- Muestra archivos `.html` o `.htm`
- El timeframe se extrae automáticamente del nombre del archivo (ej: `Strategy_1.2.1205_H1.html` → H1)

#### Sección Inferior: Opciones de Análisis

**Modo de Análisis:**
- ⚪ **Simple:** Calcula solo métricas básicas (Profit, DD%, Win%, PF, Ret/DD) → 16 columnas
- ⚪ **Avanzado:** Calcula todas las métricas (Sharpe, Calmar, Stability R², Skewness, Kurtosis, MAE/MFE) → 37 columnas

**Ruta OHLC (Opcional):**
- Si tienes un archivo CSV con datos de mercado (OHLC), puedes usarlo para calcular MAE/MFE más precisos
- Formato: `Time,Ask,Bid,Volume`

**Botones de Acción:**
- **Iniciar Análisis:** Comienza el proceso de comparación
- **Pausar / Continuar:** Pausa el análisis en curso (útil para análisis largos)
- **Cancelar:** Detiene el análisis y descarta resultados parciales

#### Sección de Resultados

**Tabla de Ranking:**
- Muestra todas las comparaciones ordenadas por correlación (mayor a menor)
- **Colores de fondo:**
  - 🟢 **Verde claro:** Correlación ≥ 70% (excelente match)
  - 🔴 **Rojo claro:** Diferencia de trades > 30% (advertencia: posible problema)
  - ⚪ **Sin color:** Casos normales

**Botones de Exportación:**
- **Ver Gráficas:** Abre ventana con curvas de equity y drawdown
- **Exportar CSV:** Guarda la tabla completa en formato CSV
- **Copiar Seleccionados:** Copia filas seleccionadas al portapapeles

---

## Flujo de Trabajo Completo

### Escenario 1: Análisis Rápido (1 SQX vs 1 MT)

**Objetivo:** Comparar una estrategia de SQX con su backtest de MT en un solo timeframe.

**Pasos:**

1. **Abrir Pestaña Analizador**
2. **Agregar Archivo SQX:**
   - Click en "Agregar CSV"
   - Selecciona `Strategy_1.2.1205.csv`
   - Deja el timeframe en "Auto"
3. **Agregar Archivo MT:**
   - Click en "Agregar HTML"
   - Selecciona `Strategy_1.2.1205_H1.html`
4. **Seleccionar Modo:**
   - Marca **"Simple"** para análisis rápido
5. **Iniciar Análisis:**
   - Click en "Iniciar Análisis"
   - Espera 5-10 segundos
6. **Ver Resultados:**
   - La tabla mostrará 1 fila con la correlación
   - Click en "Ver Gráficas" para visualizar equity curves

**Resultado esperado:**
```
Rank | Estrategia        | SQX TF | MT TF | Corr% | Trades SQX | Trades MT | Profit SQX | Profit MT
1    | Strategy 1.2.1205 | H1     | H1    | 92.5% | 1520       | 598       | $45,230    | $43,100
```

---

### Escenario 2: Análisis 1-N (1 SQX vs Múltiples MT)

**Objetivo:** Encontrar el mejor timeframe de MT para una estrategia de SQX.

**Pasos:**

1. **Agregar 1 Archivo SQX:**
   - `Strategy_2.3.6.csv` (timeframe: Auto)
2. **Agregar Múltiples Archivos MT:**
   - `Strategy_2.3.6_M5.html`
   - `Strategy_2.3.6_H1.html`
   - `Strategy_2.3.6_H4.html`
   - `Strategy_2.3.6_D1.html`
3. **Seleccionar Modo:**
   - Marca **"Avanzado"** para métricas completas
4. **Iniciar Análisis**
5. **Ver Resultados:**
   - La tabla mostrará 4 filas (una por cada timeframe MT)
   - Ordenadas por correlación de mayor a menor

**Resultado esperado:**
```
Rank | Estrategia    | SQX TF | MT TF | Corr% | Trades SQX | Trades MT | Profit SQX | Profit MT
1    | Strategy 2.3.6| H1     | H1    | 88.3% | 1340       | 520       | $38,450    | $36,200
2    | Strategy 2.3.6| H1     | H4    | 75.1% | 1340       | 130       | $38,450    | $35,100
3    | Strategy 2.3.6| H1     | M5    | 62.4% | 1340       | 2080      | $38,450    | $32,900
4    | Strategy 2.3.6| H1     | D1    | 45.2% | 1340       | 32        | $38,450    | $28,700
```

**Interpretación:** H1 es el mejor timeframe (88.3% de correlación).

---

### Escenario 3: Análisis N-N (Múltiples SQX vs Múltiples MT)

**Objetivo:** Analizar 20-500 estrategias en batch para encontrar las mejores correlaciones.

**Pasos:**

1. **Agregar Directorio SQX:**
   - Click en "Agregar Directorio"
   - Selecciona `C:\Strategies\SQX\`
   - Se cargan automáticamente todos los archivos `.csv`
2. **Agregar Directorio MT:**
   - Click en "Agregar Directorio"
   - Selecciona `C:\Strategies\MT\reports\`
   - Se cargan automáticamente todos los archivos `.html`
3. **Verificar Matching:**
   - Kicker solo comparará estrategias con nombres coincidentes
   - Ejemplo: `Strategy_0.80449.csv` se comparará con `Strategy_0.80449_h1.html`, `Strategy_0.80449_h4.html`, etc.
   - NO se comparará con `Strategy_1.9.173_h1.html` (nombre diferente)
4. **Seleccionar Modo:**
   - **Simple:** Si solo necesitas Profit, DD%, Win%, PF (más rápido)
   - **Avanzado:** Si necesitas todas las métricas (más lento, pero completo)
5. **Iniciar Análisis:**
   - Click en "Iniciar Análisis"
   - Espera 2-10 minutos (depende del número de estrategias)
   - Puedes usar "Pausar" si necesitas interrumpir
6. **Exportar Resultados:**
   - Click en "Exportar CSV"
   - Guarda como `resultados_completos.csv`
7. **Ver Gráficas:**
   - Selecciona una fila de la tabla
   - Click en "Ver Gráficas"
   - Se abrirá ventana con equity curves de SQX (línea punteada verde) y MT (línea sólida azul)

---

## Análisis Simple vs Avanzado

### Modo Simple (16 Columnas)

**Métricas calculadas:**

| Columna | Descripción |
|---------|-------------|
| Rank | Posición en el ranking (1 = mejor correlación) |
| Estrategia | Nombre de la estrategia |
| SQX TF | Timeframe detectado/manual de SQX |
| MT TF | Timeframe extraído del nombre del archivo MT |
| Fechas Test | Rango de fechas del backtest MT |
| Corr% | Correlación de Pearson entre curvas de equity (0-100%) |
| Trades SQX | Número de trades en SQX (filtrados al rango MT) |
| Trades MT | Número de trades en MT |
| Profit SQX | Ganancia neta en SQX |
| Profit MT | Ganancia neta en MT |
| DD% SQX | Máximo drawdown en SQX (%) |
| DD% MT | Máximo drawdown en MT (%) |
| Win% SQX | Porcentaje de trades ganadores en SQX |
| Win% MT | Porcentaje de trades ganadores en MT |
| PF SQX | Profit Factor en SQX (ganancias / pérdidas) |
| PF MT | Profit Factor en MT |
| Ret/DD SQX | Retorno / Drawdown en SQX |
| Ret/DD MT | Retorno / Drawdown en MT |

**Ventajas:**
- ⚡ **Rápido:** Calcula solo lo esencial
- 📊 **Suficiente para validación básica:** Profit, DD%, Win%, PF son las métricas más importantes
- 💾 **Menor uso de CPU:** Ideal para análisis de 200-500 estrategias

**Cuándo usar:**
- Análisis preliminar de muchas estrategias
- Solo necesitas saber si la correlación es buena (>70%)
- Quieres resultados rápidos

---

### Modo Avanzado (37 Columnas)

**Métricas adicionales calculadas:**

| Columna | Descripción | Fórmula |
|---------|-------------|---------|
| Sharpe SQX/MT | Sharpe Ratio | `sqrt(N) * mean(returns) / std(returns)` |
| Expectancy SQX/MT | Expectativa matemática | `(Win% * AvgWin) - (Loss% * AvgLoss)` |
| Stability R² SQX/MT | Estabilidad de la curva de equity | Regresión lineal: `R² = r_value²` |
| MAE SQX/MT | Maximum Adverse Excursion | Promedio de la peor pérdida flotante por trade |
| MFE SQX/MT | Maximum Favorable Excursion | Promedio de la mejor ganancia flotante por trade |
| Skewness SQX/MT | Asimetría de retornos | `skew(returns)` |
| Kurtosis SQX/MT | Curtosis de retornos | `kurtosis(returns)` |
| Calmar Ratio SQX/MT | CAGR / MaxDD | `(CAGR% / MaxDD%)` |
| CAGR/DD SQX/MT | Idéntico a Calmar Ratio | `(CAGR% / MaxDD%)` |

**Ventajas:**
- 🔬 **Análisis profundo:** Métricas estadísticas avanzadas
- 📈 **Mejor comprensión del riesgo:** Sharpe, Calmar, Stability R²
- 🎯 **Detección de anomalías:** Skewness y Kurtosis revelan distribuciones anormales

**Cuándo usar:**
- Análisis final de estrategias seleccionadas
- Necesitas validar riesgo ajustado (Sharpe, Calmar)
- Quieres entender la distribución de retornos (Skewness, Kurtosis)

---

## Métricas Calculadas

### Métricas Básicas

#### 1. Correlación (Corr%)

**Definición:** Mide la similitud entre las curvas de equity de SQX y MT usando el coeficiente de correlación de Pearson.

**Fórmula:**
```
Corr = corr(equity_sqx, equity_mt)
```

**Interpretación:**

| Rango | Significado | Acción |
|-------|-------------|--------|
| 90-100% | Excelente match | ✅ Estrategia validada |
| 70-89% | Buena correlación | ✅ Aceptable, revisar diferencias |
| 50-69% | Correlación moderada | ⚠️ Investigar causas |
| 0-49% | Correlación baja | ❌ Posible problema en la implementación |

**Ejemplo:**
```
Strategy 1.9.173: 92.5% → Excelente
Strategy 2.3.6:   45.2% → Revisar código MT
```

---

#### 2. Profit Factor (PF)

**Definición:** Ratio entre ganancias totales y pérdidas totales.

**Fórmula:**
```
PF = Σ(ganancias) / |Σ(pérdidas)|
```

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| PF > 2.0 | Excelente |
| PF 1.5-2.0 | Bueno |
| PF 1.0-1.5 | Marginal |
| PF < 1.0 | Perdedor |

**Ejemplo:**
```
PF SQX = 2.35 → Buena estrategia
PF MT  = 2.28 → Diferencia de 3% (aceptable)
```

---

#### 3. Maximum Drawdown (DD%)

**Definición:** Máxima caída desde un pico de equity hasta el valle más bajo.

**Fórmula:**
```
DD% = (Peak - Valley) / Peak * 100
```

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| DD < 10% | Bajo riesgo |
| DD 10-20% | Riesgo moderado |
| DD 20-30% | Alto riesgo |
| DD > 30% | Muy alto riesgo |

**Ejemplo:**
```
DD% SQX = 12.5% → Riesgo moderado
DD% MT  = 15.3% → Diferencia de 2.8% (aceptable)
```

---

### Métricas Avanzadas

#### 4. Sharpe Ratio

**Definición:** Mide el retorno ajustado por riesgo.

**Fórmula:**
```
Sharpe = sqrt(N) * mean(returns) / std(returns)
```

Donde:
- `N` = número de trades
- `returns` = retornos por trade (profit / equity_anterior)

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| Sharpe > 2.0 | Excelente |
| Sharpe 1.0-2.0 | Bueno |
| Sharpe 0-1.0 | Marginal |
| Sharpe < 0 | Perdedor |

**Ejemplo:**
```
Sharpe SQX = 1.85 → Buena estrategia
Sharpe MT  = 1.72 → Diferencia de 7% (aceptable)
```

---

#### 5. Calmar Ratio

**Definición:** Ratio entre CAGR (Compound Annual Growth Rate) y Maximum Drawdown.

**Fórmula:**
```
Calmar = CAGR% / MaxDD%
```

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| Calmar > 3.0 | Excelente |
| Calmar 1.0-3.0 | Bueno |
| Calmar 0.5-1.0 | Marginal |
| Calmar < 0.5 | Pobre |

**Ejemplo:**
```
CAGR SQX = 45.2%, DD% = 12.5% → Calmar = 3.62 (excelente)
CAGR MT  = 42.8%, DD% = 15.3% → Calmar = 2.80 (bueno)
```

---

#### 6. Stability R²

**Definición:** Mide qué tan lineal es la curva de equity (0 = caótica, 1 = perfectamente lineal).

**Fórmula:**
```
Stability = R² de regresión lineal sobre equity
```

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| R² > 0.90 | Muy estable |
| R² 0.70-0.90 | Estable |
| R² 0.50-0.70 | Moderadamente estable |
| R² < 0.50 | Inestable |

**Ejemplo:**
```
Stability SQX = 0.88 → Estable
Stability MT  = 0.82 → Estable (diferencia aceptable)
```

---

#### 7. Skewness (Asimetría)

**Definición:** Mide la asimetría de la distribución de retornos.

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| Skew > 0 | Más ganancias grandes que pérdidas grandes (positivo) |
| Skew = 0 | Distribución simétrica |
| Skew < 0 | Más pérdidas grandes que ganancias grandes (negativo) |

**Ejemplo:**
```
Skewness SQX = 0.45 → Más ganancias grandes (bueno)
Skewness MT  = 0.38 → Similar (aceptable)
```

---

#### 8. Kurtosis (Curtosis)

**Definición:** Mide la "pesadez" de las colas de la distribución (eventos extremos).

**Interpretación:**

| Valor | Significado |
|-------|-------------|
| Kurt > 3 | Más eventos extremos (colas pesadas) |
| Kurt = 3 | Distribución normal |
| Kurt < 3 | Menos eventos extremos (colas ligeras) |

**Ejemplo:**
```
Kurtosis SQX = 2.8 → Distribución casi normal
Kurtosis MT  = 3.2 → Ligeramente más eventos extremos
```

---

## Interpretación de Resultados

### Caso 1: Correlación Alta (>70%) y Métricas Similares

**Ejemplo:**
```
Strategy 1.9.173 vs Strategy_1.9.173_h1:
- Corr: 92.5%
- Trades: 1520 SQX vs 598 MT
- Profit: $45,230 SQX vs $43,100 MT (diferencia 4.7%)
- DD%: 12.5% SQX vs 15.3% MT (diferencia 2.8%)
- PF: 2.35 SQX vs 2.28 MT (diferencia 3%)
```

**Interpretación:**
✅ **Estrategia validada.** La implementación en MT es correcta y produce resultados muy similares a SQX. La diferencia en número de trades (1520 vs 598) es normal porque MT puede tener menos datos históricos o filtrar trades por spread/slippage.

**Acción:** Usar esta estrategia en trading real con confianza.

---

### Caso 2: Correlación Alta pero Diferencia Grande en Trades

**Ejemplo:**
```
Strategy 2.3.6 vs Strategy_2.3.6_m5:
- Corr: 85.2%
- Trades: 800 SQX vs 200 MT (diferencia 75%)
- Profit: $38,450 SQX vs $35,100 MT (diferencia 8.7%)
```

**Interpretación:**
⚠️ **Posible problema.** La correlación es buena, pero MT está ejecutando solo el 25% de los trades de SQX. Causas posibles:

1. **Filtro de spread:** MT puede estar rechazando trades por spread alto
2. **Datos faltantes:** MT puede tener gaps en los datos históricos
3. **Diferencia en señales:** La lógica de entrada/salida puede tener diferencias sutiles

**Acción:** Revisar el código MT, verificar datos históricos, y ajustar filtros de spread.

---

### Caso 3: Correlación Baja (<50%)

**Ejemplo:**
```
Strategy 0.80449 vs Strategy_0.80449_d1:
- Corr: 35.8%
- Trades: 807 SQX vs 79 MT
- Profit: $28,700 SQX vs $12,300 MT (diferencia 57%)
```

**Interpretación:**
❌ **Implementación incorrecta.** La estrategia en MT no está replicando la lógica de SQX. Causas posibles:

1. **Timeframe incorrecto:** D1 puede ser demasiado alto para esta estrategia
2. **Indicadores diferentes:** Los indicadores en MT pueden calcular valores diferentes
3. **Lógica de entrada/salida:** Puede haber errores en el código MQL

**Acción:** Revisar el código MQL línea por línea, comparar valores de indicadores, y probar con otros timeframes (H1, H4).

---

## Gráficas de Equity

### Interpretación Visual

Cuando abres "Ver Gráficas", se muestra una ventana con 2 gráficas:

#### Gráfica 1: Equity Curves

- **Línea punteada verde:** Curva de equity de SQX
- **Línea sólida azul:** Curva de equity de MT
- **Eje X:** Número de trades
- **Eje Y:** Equity en dólares

**Qué buscar:**
- ✅ **Líneas paralelas:** Buena correlación
- ⚠️ **Líneas divergentes:** Diferencias en la ejecución
- ❌ **Líneas opuestas:** Implementación incorrecta

#### Gráfica 2: Drawdown

- **Línea punteada verde:** Drawdown de SQX
- **Línea sólida azul:** Drawdown de MT
- **Eje X:** Número de trades
- **Eje Y:** Drawdown en porcentaje (%)

**Qué buscar:**
- ✅ **Picos similares:** Ambas estrategias tienen drawdowns en los mismos momentos
- ⚠️ **Picos más altos en MT:** MT tiene más riesgo
- ❌ **Picos en momentos diferentes:** Diferencias en la lógica

### Guardar Gráficas

1. Click en **"💾 Guardar Gráfica"** (botón azul en la parte inferior)
2. Selecciona carpeta y nombre (ej: `Strategy_1.9.173_H1_comparison.png`)
3. La gráfica se guarda en **PNG de alta resolución (300 DPI)**
4. Puedes incluirla en reportes o presentaciones

---

## Solución de Problemas

### Problema 1: "Análisis se inicia automáticamente al abrir la app"

**Síntoma:** Aparece ventana "Preparando análisis..." 3-5 segundos después de abrir la app, sin haber hecho click en nada.

**Causa:** Eventos residuales de inicialización de la GUI.

**Solución (V36):**
- La app ahora espera **5 segundos** antes de habilitar el análisis
- Verás el mensaje: **"Análisis se habilitará en 5 segundos"**
- Espera a que aparezca: **"ANÁLISIS HABILITADO - Listo para usar"**

---

### Problema 2: "No se cargan archivos CSV de SQX"

**Síntoma:** Al agregar CSV, la tabla queda vacía.

**Causa:** Formato de CSV incorrecto o columnas faltantes.

**Solución:**
1. Abre el CSV en Excel o Notepad
2. Verifica que tenga estas columnas:
   - `Open time` o `Entry time`
   - `Close time` o `Exit time`
   - `Profit/Loss` o `Profit`
   - `MAE ($)` (opcional)
   - `MFE ($)` (opcional)
3. Si faltan columnas, exporta de nuevo desde StrategyQuant con la plantilla correcta

---

### Problema 3: "No se cargan archivos HTML de MT"

**Síntoma:** Al agregar HTML, la lista queda vacía.

**Causa:** Archivos con extensión `.htm` no son reconocidos (solo `.html`).

**Solución:**
1. Renombra los archivos de `.htm` a `.html`
2. O usa el conversor interno:
   - Pestaña Analizador → "Convertir HTML a CSV"
   - Selecciona directorio con archivos `.htm`
   - Se generarán archivos `.csv` que puedes cargar directamente

---

### Problema 4: "Correlación 0% en todos los resultados"

**Síntoma:** Todas las filas muestran Corr% = 0.0%.

**Causa:** Los nombres de archivos SQX y MT no coinciden.

**Solución:**
1. Verifica que los nombres sean idénticos (ignorando timeframe):
   - ✅ `Strategy_1.2.1205.csv` vs `Strategy_1.2.1205_H1.html`
   - ❌ `Strategy 1.2.1205.csv` vs `Strategy_1_2_1205_H1.html`
2. Renombra archivos para que coincidan
3. Usa guiones bajos `_` en lugar de espacios

---

### Problema 5: "Gráficas no se muestran"

**Síntoma:** Al hacer click en "Ver Gráficas", no pasa nada.

**Causa:** Falta la librería `matplotlib` o error en los datos.

**Solución:**
1. Si usas código fuente, instala: `pip install matplotlib`
2. Si usas ejecutable, reinstala la aplicación
3. Verifica que los archivos tengan datos válidos (no vacíos)

---

## Preguntas Frecuentes

### 1. ¿Cuántas estrategias puedo analizar a la vez?

**Respuesta:** Hasta **500 estrategias** en modo Simple, o **200 estrategias** en modo Avanzado. El tiempo de análisis depende del número de trades por estrategia:

- 100 estrategias (1000 trades cada una) → 2-5 minutos (Simple) / 5-10 minutos (Avanzado)
- 500 estrategias (1000 trades cada una) → 10-20 minutos (Simple) / 30-60 minutos (Avanzado)

---

### 2. ¿Qué timeframe de MT debo usar?

**Respuesta:** Depende del timeframe de tu estrategia en SQX:

| SQX Timeframe | MT Timeframe Recomendado |
|---------------|--------------------------|
| M1 | M1 |
| M5 | M5 |
| M15 | M15 |
| M30 | M30 |
| H1 | H1 |
| H4 | H4 |
| D1 | D1 |

Si no estás seguro, **prueba con múltiples timeframes** (1-N) y elige el que tenga mayor correlación.

---

### 3. ¿Por qué MT tiene menos trades que SQX?

**Respuesta:** Es normal. Causas comunes:

1. **Datos históricos:** MT puede tener menos datos que SQX
2. **Spread:** MT filtra trades con spread muy alto
3. **Slippage:** MT simula slippage real, SQX no
4. **Filtrado de fechas:** Kicker filtra los trades de SQX al rango de fechas de MT

**Regla general:** Si la diferencia es < 30%, es aceptable. Si es > 50%, investiga.

---

### 4. ¿Qué significa "Calmar Ratio = 999.99"?

**Respuesta:** Significa que el **Maximum Drawdown es casi 0** (< 0.01%). Esto ocurre cuando:

- La estrategia solo tiene trades ganadores
- El drawdown es extremadamente pequeño

Es un valor "infinito" truncado a 999.99 para evitar errores.

---

### 5. ¿Puedo usar Kicker con otros brokers (no MT4/MT5)?

**Respuesta:** Sí, siempre que puedas exportar los reportes en formato HTML o CSV compatible. Los formatos soportados son:

- **HTML:** Formato estándar de MT4/MT5 Strategy Tester
- **CSV:** Columnas mínimas: `Time`, `Type`, `Order`, `Size`, `Price`, `Profit`

---

### 6. ¿Cómo interpretar Skewness y Kurtosis?

**Respuesta:**

**Skewness (Asimetría):**
- **Positivo (> 0):** Más ganancias grandes → Bueno
- **Negativo (< 0):** Más pérdidas grandes → Malo
- **Cercano a 0:** Distribución simétrica → Normal

**Kurtosis (Curtosis):**
- **> 3:** Más eventos extremos (colas pesadas) → Mayor riesgo
- **= 3:** Distribución normal
- **< 3:** Menos eventos extremos (colas ligeras) → Menor riesgo

**Ejemplo ideal:**
```
Skewness = 0.5 (más ganancias grandes)
Kurtosis = 2.5 (menos eventos extremos)
```

---

### 7. ¿Qué es MAE y MFE?

**Respuesta:**

- **MAE (Maximum Adverse Excursion):** La peor pérdida flotante que tuvo cada trade antes de cerrar
- **MFE (Maximum Favorable Excursion):** La mejor ganancia flotante que tuvo cada trade antes de cerrar

**Uso:**
- **MAE alto:** Indica que los stops son muy amplios o que hay mucho ruido
- **MFE alto:** Indica que la estrategia deja mucho profit sobre la mesa (podría optimizarse el take profit)

**Ejemplo:**
```
MAE = $150 → En promedio, cada trade tuvo una pérdida flotante de $150
MFE = $450 → En promedio, cada trade tuvo una ganancia flotante de $450
```

Si MFE >> MAE, la estrategia es buena. Si MAE >> MFE, hay problemas.

---

### 8. ¿Puedo pausar un análisis largo?

**Respuesta:** Sí, usa el botón **"Pausar"**. El análisis se detendrá en el trade actual y podrás:

- Click en **"Continuar"** para reanudar
- Click en **"Cancelar"** para abortar

**Nota:** Los resultados parciales NO se guardan si cancelas.

---

### 9. ¿Cómo exporto los resultados a Excel?

**Respuesta:**

1. Click en **"Exportar CSV"**
2. Guarda como `resultados.csv`
3. Abre en Excel
4. Usa "Texto a columnas" si es necesario (delimitador: coma)

---

### 10. ¿Qué versión es la más estable?

**Respuesta:** **Versión BETA 2** (esta versión) es la más estable hasta la fecha. Incluye:

- ✅ Fix de análisis automático al iniciar
- ✅ Calmar Ratio y CAGR/DD habilitados
- ✅ Separación de análisis Simple vs Avanzado
- ✅ Botón para guardar gráficas
- ✅ Colores distintos en equity curves
- ✅ Colores de fondo en tabla de resultados

---

## Soporte y Contacto

**Autor:** Diego Tobón  
**Email:** [Insertar email]  
**Versión:** 36 (Estable)  
**Fecha:** Enero 2025  

Para reportar bugs o sugerencias, contacta al autor directamente.


---

**Fin del Manual Avanzado**
