IVO · Análisis Karting
Compará tandas de la AiM MyChron (archivos .xrk) curva por curva: cuánto se pierde, dónde, si es manejo o agarre, y cómo rindió el motor.
- Web: https://francomica22-lab.github.io/kart-telemetria/ — el análisis corre en el navegador (Pyodide); los archivos no se suben.
- Windows: descargar. Funciona sin internet. Al abrirlo por primera vez se instala solo y crea el acceso directo. Cuando hay una versión nueva aparece un aviso ! arriba a la derecha.
Windows puede mostrar "Windows protegió su PC" porque el programa no está firmado: tocá Más información → Ejecutar de todas formas.
Qué hace
- Análisis simple (para empezar) y detallado.
- Una tanda sola (vuelta óptima, regularidad) o varias comparadas (manejo vs agarre, curva por curva y por sectores).
- Vuelta óptima: juntando tus mejores curvas, y qué hiciste distinto en la mejor pasada de cada curva.
- Motor: curva de potencia estimada en HP (todas las vueltas), comparación con margen de error y corrección por clima.
- Clima automático (Open-Meteo) por ubicación GPS y hora de la tanda.
- Setup: se lee del comentario de la MyChron y se puede editar (se guarda junto al
.xrk).
- Carburación: tres indicios sin sensor de escape (pico de RPM contra pico de velocidad, cuánto sube el motor cerca del tope, y clima contra una tanda de referencia), cruzados con lo que sentiste (gordo, fino, detonación) para sugerir el cambio: chicler y aguja en carburadores a cortina, vueltas de baja y alta en los de membrana.
- Transmisión: sugiere la corona según las RPM al final de la recta.
- Sensores: agua, escape, batería y lo que haya registrado la MyChron.
- Video: sincroniza el onboard con la telemetría escuchando el motor; dos videos se mueven juntos por posición en pista.
- Compartir: link y QR para abrir el reporte en el celular (vence a los 30 días), o PDF.
- Reportar un problema desde la app.
- Catálogo de karts: categoría, chasis y motor de cada kart (se confirma una vez por kart).
Datos anónimos
La app comparte un resumen anónimo de cada tanda analizada (activado por defecto, se desactiva en Ajustes del análisis):
circuito (ubicación aproximada, largo, curvas), kart (categoría, chasis, motor), setup, clima, mejor tiempo y resultados del análisis.
Nunca se envían vueltas, telemetría, archivos, nombres ni comentarios libres. La base (Supabase) solo permite agregar resúmenes: no se pueden leer ni modificar desde la app. Política completa: https://francomica22-lab.github.io/kart-telemetria/privacidad.html
Estructura
| Carpeta | Qué hay |
|---|
app/ | Análisis en Python (kartlib, tandas, motor, sesiones, setup_kart), programa de escritorio (desktop.py) y actualizador (updater.py) |
web/ | Interfaz (la misma para escritorio y web). web-backend.js + py-worker.js solo se usan en la web |
tools/build_site.py | Arma la carpeta site/ para GitHub Pages |
tools/qa_all.py | Prueba el análisis con todas las tandas de una carpeta (solas y de a pares) |
.github/workflows/ | pages.yml publica la web en cada push a main; release.yml arma el .exe en cada tag vX.Y.Z |
Cómo publicar una versión
- Cambios en
main → la web se actualiza sola.
- Para el programa de Windows: subir
VERSION, commit, y un tag con notas:
git tag -a v1.1.0 -m "Qué cambió en esta versión"
git push origin main --tags
GitHub Actions arma el ejecutable y publica el Release; los programas instalados lo ofrecen como actualización.
Desarrollo local
pip install -r requirements.txt
python app/desktop.py
