Allisona commited on
Commit
a4ac235
verified
1 Parent(s): 44b95ef

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +49 -24
README.md CHANGED
@@ -1,26 +1,51 @@
1
- # 馃 An谩lisis y Despliegue de Datos UFC (ML Space)
2
-
3
- Este Hugging Face Space aloja el modelo de Machine Learning desarrollado para el proyecto de An谩lisis de Datos, utilizando Gradio para crear una interfaz de usuario y una API de inferencia.
4
-
5
- ## 馃幆 Objetivo
6
- El modelo tiene como objetivo principal predecir la **probabilidad de que un combate de UFC termine por Knockout/Technical Knockout (KO/TKO)**, bas谩ndose en estad铆sticas de los peleadores (golpeo, derribos, precisi贸n) y el contexto del evento.
7
-
8
- ## 馃殌 Arquitectura del Modelo
9
- * **Problema:** Clasificaci贸n Binaria.
10
- * **Algoritmo:** **Random Forest Classifier** (Seleccionado por su robusto rendimiento en m茅tricas como AUC y F1 Score, demostrado en la evaluaci贸n comparativa del informe).
11
- * **Pipeline de Preprocesamiento:**
12
- 1. **Imputaci贸n:** `SimpleImputer` (rellenar valores nulos con la mediana).
13
- 2. **Escalado:** `StandardScaler` aplicado a las estad铆sticas brutas.
14
- 3. **Codificaci贸n:** `OneHotEncoder` aplicado a la variable categ贸rica `Location`.
15
- * **Features de Entrada:** Estad铆sticas brutas, variables de diferencia (`KD_diff`, `STR_diff`, etc.) y las variables OHE de la categor铆a de peso.
16
-
17
- ## 馃捇 Componentes del Despliegue
18
- Este Space requiere los siguientes archivos para funcionar:
19
- 1. `app.py`: C贸digo principal de la aplicaci贸n Gradio.
20
- 2. `requirements.txt`: Lista de dependencias (`scikit-learn`, `gradio`, etc.).
21
- 3. `model.pkl`: El modelo Random Forest serializado.
22
- 4. `preprocessor.pkl`: El ColumnTransformer ajustado.
23
- 5. `model_columns.pkl`: Lista para garantizar el orden de las features.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
24
 
25
  ---
26
- *Este proyecto demuestra el ciclo de vida completo de un modelo de Machine Learning, desde la limpieza de datos hasta el despliegue como un servicio de inferencia.*
 
1
+ ---
2
+ title: UFC KO/TKO Predictor
3
+ emoji: 馃
4
+ colorFrom: 'red'
5
+ colorTo: 'blue'
6
+ sdk: gradio
7
+ sdk_version: "4.3.0"
8
+ app_file: app.py
9
+ pinned: false
10
+ license: mit
11
+ ---
12
+
13
+ # 馃 Predictor de Finalizaci贸n UFC (KO/TKO)
14
+
15
+ Aplicaci贸n de Machine Learning que predice la **probabilidad de que un combate termine por Knockout/Technical Knockout (KO/TKO)**, bas谩ndose en el an谩lisis de estad铆sticas de los peleadores y el contexto de la pelea.
16
+
17
+ ## 馃幆 Objetivo y Modelo
18
+
19
+ El modelo de clasificaci贸n fue entrenado para responder a la pregunta binaria: **驴El combate finaliza por KO/TKO (1) o Decisi贸n/Sumisi贸n (0)?**
20
+
21
+ * **Algoritmo Principal:** **Random Forest Classifier** (Seleccionado tras una evaluaci贸n comparativa).
22
+ * **M茅trica Clave:** **AUC Score** (脕rea bajo la curva ROC), priorizando la capacidad de distinci贸n de clases.
23
+ * **Pipeline de Preprocesamiento:** Incluye Imputaci贸n de nulos, `StandardScaler` y `OneHotEncoder` para la ubicaci贸n (`Location`).
24
+
25
+ [Image of Heatmap of a Correlation Matrix]
26
+
27
+
28
+ ## 馃搳 Caracter铆sticas Clave Analizadas
29
+
30
+ El modelo utiliza caracter铆sticas de diferencia y estad铆sticas brutas:
31
+
32
+ * **Diferencias:** Diferencia de Knockdowns (`KD_diff`), Golpes Significativos (`STR_diff`), Derribos (`TD_diff`) y Sumisiones.
33
+ * **Estad铆sticas Brutas:** `Round` actual, Precisi贸n de golpeo de ambos peleadores.
34
+ * **Contexto:** Ubicaci贸n del evento (`Location`) y Categor铆a de Peso (OHE).
35
+
36
+ ## 鈿欙笍 Arquitectura T茅cnica
37
+
38
+ El servicio se despliega usando el ciclo de vida completo de ML:
39
+
40
+ 1. **Entorno:** Google Colab / Scikit-learn.
41
+ 2. **Serializaci贸n:** `model.pkl` y `preprocessor.pkl`.
42
+ 3. **Despliegue:** **Gradio** en un **Hugging Face Space**.
43
+
44
+ ## 馃捇 Uso de la Interfaz
45
+
46
+ 1. **Ingresa las estad铆sticas** brutas y de diferencia de los peleadores.
47
+ 2. **Aseg煤rate de que la Ubicaci贸n** sea correcta (usado para codificaci贸n).
48
+ 3. El modelo devuelve una **Probabilidad de KO/TKO (%)** y el **Resultado M谩s Probable**.
49
 
50
  ---
51
+ *Este proyecto fue desarrollado con fines educativos y de demostraci贸n para el curso de An谩lisis de Datos.*