/*
 * =============================================================================
 * SelectBestByEntryGroupArgs - Análisis Personalizado para StrategyQuant X
 * =============================================================================
 *
 * DESCRIPCIÓN:
 *   Procesa un databank y selecciona las N mejores estrategias de cada grupo
 *   de estrategias que comparten la misma combinación de Entry Indicators.
 *   La ganadora de cada grupo se determina mediante un criterio de puntuación
 *   configurable por el usuario.
 *
 * USO:
 *   - Añadir este snippet como tarea "Full databank analysis" en un Custom Project
 *   - Configurar el databank Source (estrategias a evaluar)
 *   - Configurar el databank Target (aquí se copiarán las ganadoras)
 *   - Desactivar el toggle "Filter by results of custom analysis"
 *   - Opcionalmente pasar criterio, número y muestra via Input args (ver abajo)
 *
 * INPUT ARGS (opcional):
 *   Formato: Criterio,N,Sample
 *   Ejemplos:
 *     RetDD              → 1 mejor por Ret/DD, FullSample (todo por defecto)
 *     RetDD,3            → 3 mejores por Ret/DD, FullSample
 *     RetDD,3,IS         → 3 mejores por Ret/DD, InSample
 *     Sharpe,5,OOS       → 5 mejores por Sharpe, OutOfSample
 *     Calmar,10,Full     → 10 mejores por Calmar, FullSample
 *
 *   Criterios disponibles:
 *     RetDD        → Ret/DD Ratio             (valor por defecto)
 *     Sharpe       → Sharpe Ratio
 *     ProfitFactor → Profit Factor
 *     NetProfit    → Net Profit absoluto
 *     Calmar       → Calmar Ratio
 *     WinRate      → Porcentaje de trades ganadores
 *     Drawdown     → Menor Drawdown absoluto (menor es mejor)
 *
 *   Muestras disponibles:
 *     Full         → FullSample  (por defecto si se omite)
 *     IS           → InSample
 *     OOS          → OutOfSample
 *
 * DEPENDENCIAS:
 *   No se requieren snippets adicionales. Todas las dependencias están
 *   disponibles en la instalación estándar de SQX.
 *
 * AVISO LEGAL:
 *   Este snippet se proporciona únicamente con fines educativos y de
 *   investigación. No constituye asesoramiento financiero ni una
 *   recomendación para operar con ningún instrumento financiero.
 *   Los resultados pasados de cualquier estrategia seleccionada por
 *   esta herramienta no son indicativos de resultados futuros.
 *   Úselo bajo su propia responsabilidad. Valide siempre los resultados
 *   de forma independiente antes de utilizar cualquier estrategia en
 *   trading real.
 *
 * AUTOR: José Carlos Paredes
 * VERSIÓN: 1.4
 * =============================================================================
 */