ScoreMatrix

ScoreMatrix es una aplicacion desktop para Windows que estima probabilidades de resultados exactos de futbol y sus cuotas justas equivalentes a partir de un modelo matematico.

La app puede partir de cuotas 1X2 de mercado o de goles esperados ingresados manualmente. Luego construye una matriz de marcadores como 0-0, 1-0, 2-1, etc. Cada celda puede verse como probabilidad o como cuota decimal justa.

Version actual: 0.02

Funcionalidades

• UI desktop WinForms para Windows.
• Entrada desde cuotas decimales 1X2: victoria local, empate, victoria visitante.
• Calibracion opcional con cuotas Over/Under 2.5.
• Calibracion opcional con cuotas Both Teams To Score: Si/No.
• Entrada desde goles esperados manuales: lambda local y lambda visitante.
• Conversion proporcional de cuotas 1X2 a probabilidades sin margen.
• Inferencia de lambdas desde probabilidades 1X2.
• Modelo Poisson para resultados exactos.
• Ajuste Dixon-Coles opcional para marcadores bajos.
• Rango visible configurable entre 3 y 15 goles.
• Vista de matriz en probabilidades o cuotas justas.
• Vista de cuotas con margen comercial configurable.
• Resumen agregado:
  • Victoria local, empate, victoria visitante.
  • Over/Under 0.5, 1.5, 2.5 y 3.5.
  • Both Teams To Score: Si/No.
  • 0-0 y 1-1.
  • Marcador mas probable.
  • Probabilidad cubierta por la grilla.
  • Probabilidad fuera de la grilla.
• Exportacion a CSV.
• Ventana de ayuda integrada con explicacion del modelo y los conceptos.

Requisitos

• Windows.
• .NET 10 SDK.

El proyecto WinForms usa:

net10.0-windows

Compilar Y Ejecutar

Desde la raiz del repositorio:

dotnet build
dotnet run --project ScoreMatrix.WinForms\ScoreMatrix.WinForms.csproj

Tambien se puede ejecutar el binario generado despues de compilar:

ScoreMatrix.WinForms\bin\Debug\net10.0-windows\ScoreMatrix.WinForms.exe

Como Funciona

1. De cuotas a probabilidades sin margen

Cuando se usan cuotas 1X2, ScoreMatrix convierte primero cada cuota decimal en probabilidad implicita:

pLocalBruta = 1 / cuotaLocal
pEmpateBruta = 1 / cuotaEmpate
pVisitanteBruta = 1 / cuotaVisitante

Luego quita el margen del bookmaker con normalizacion proporcional:

suma = pLocalBruta + pEmpateBruta + pVisitanteBruta

pLocal = pLocalBruta / suma
pEmpate = pEmpateBruta / suma
pVisitante = pVisitanteBruta / suma

Si las probabilidades implicitas brutas suman menos que 1, la app bloquea el calculo porque eso implicaria margen negativo para el bookmaker.

2. De probabilidades 1X2 a lambdas

La app infiere:

lambdaLocal
lambdaVisitante

Estos valores representan los goles esperados del equipo local y visitante.

El optimizador prueba pares de lambdas, construye una matriz Poisson interna para cada par y la agrega en tres probabilidades:

P(local gana) = suma de marcadores donde goles local > goles visitante
P(empate) = suma de marcadores donde goles local == goles visitante
P(visitante gana) = suma de marcadores donde goles local < goles visitante

Luego elige el par que minimiza:

error =
  (localModelo - localMercado)^2
+ (empateModelo - empateMercado)^2
+ (visitanteModelo - visitanteMercado)^2

Si se activa Usar O/U 2.5, la app tambien convierte las cuotas Over/Under 2.5 a probabilidades sin margen y agrega esos desvíos al objetivo:

+ (over25Modelo - over25Mercado)^2
+ (under25Modelo - under25Mercado)^2

Esto ayuda a fijar mejor el total esperado de goles cuando las cuotas 1X2 por si solas no alcanzan.

Si se activa Usar BTTS, la app tambien usa Both Teams To Score:

+ (bttsSiModelo - bttsSiMercado)^2
+ (bttsNoModelo - bttsNoMercado)^2

Esto ayuda a calibrar mejor si la distribucion asigna suficiente probabilidad a marcadores donde ambos equipos convierten.

El optimizador actual usa una busqueda amplia por grilla seguida de refinamiento local.

3. Matriz Poisson

El modelo base asume distribuciones Poisson independientes:

Goles local ~ Poisson(lambdaLocal)
Goles visitante ~ Poisson(lambdaVisitante)

La probabilidad de un marcador exacto se calcula asi:

P(i-j) = Poisson(i, lambdaLocal) * Poisson(j, lambdaVisitante)

La cuota justa se calcula como:

cuotaJusta = 1 / probabilidad

Tambien se puede aplicar un margen comercial configurable a la cuota justa:

cuotaConMargen = cuotaJusta / (1 + margen / 100)

Este margen solo cambia la visualizacion y la exportacion; no altera las probabilidades ni los lambdas del modelo.

4. Ajuste Dixon-Coles

Dixon-Coles parte de la matriz Poisson y ajusta marcadores bajos:

0-0
1-0
0-1
1-1

El parametro manual rho controla la direccion y fuerza del ajuste.

• rho = 0: igual que Poisson simple.
• rho < 0: segun el factor aplicado, sube 0-0 y 1-1, y baja 1-0 y 0-1.
• rho > 0: segun el factor aplicado, baja 0-0 y 1-1, y sube 1-0 y 0-1.

Luego ScoreMatrix renormaliza la matriz para conservar la masa de probabilidad base, asi que el efecto visible puede variar levemente en la grilla completa.

Limitaciones Importantes

ScoreMatrix es una herramienta de modelado, no un sistema para garantizar apuestas ganadoras.

Las cuotas 1X2 por si solas no definen completamente el total esperado de goles. Dos partidos pueden tener probabilidades 1X2 parecidas pero perfiles de Over/Under o BTTS distintos. La app permite usar Over/Under 2.5 y BTTS para mejorar esa calibracion. Futuras versiones podrian sumar mercados adicionales como:

• Totales asiaticos.
• Precios de mercado de resultado exacto.

Las cuotas justas mostradas por ScoreMatrix no incluyen margen de bookmaker, liquidez, sesgos de mercado ni ajustes comerciales.

Estructura Del Proyecto

ScoreMatrix.Domain
  Modelos y enums compartidos.

ScoreMatrix.Application
  Conversion de odds, optimizacion de lambdas, modelos de score, calculadora y exportacion CSV.

ScoreMatrix.WinForms
  UI desktop, ventana de ayuda e iconos.

Notas Del Repositorio

• La version 0.02 agrega calibracion opcional con Over/Under 2.5 y BTTS, margen comercial para odds y mejoras visuales.