Procesamiento y visualización de las rutas L1, L23 y LM-3, en ida y vuelta, para el piloto de tesis de Jhon Alex Morales Apaza (UNAJ). Forma parte del proyecto JuliacaBus-DS.
Los GPX vigentes de data/gpx_entrada/ son los archivos de entrada
proporcionados por el autor para trabajar con las rutas.
El programa lee esos archivos, ajusta su geometría a las calles de
OpenStreetMap y produce tablas y mapas. Los originales se conservan.
| Línea | Sentido | Recorrido |
|---|---|---|
| LM-3 | Ida | Ayabacas → Bosque |
| LM-3 | Vuelta | Bosque → Ayabacas |
| L23 | Ida | Molina → Escuri |
| L23 | Vuelta | Escuri → Molina |
| L1 | Ida | Rinconada → Guadalupe |
| L1 | Vuelta | Guadalupe → Rinconada |
Las cifras vigentes están en data/salida/resumen_rutas.csv.
Se actualizan al volver a procesar los GPX; no se mantienen copias manuales
de los valores en este documento.
GPX originales en data/gpx_entrada/
→ 2_validar_recorridos.py: calidad, horas y huella SHA-256
→ 3_procesar_rutas.py: ajuste a calles, esquinas y horas de paso
→ data/salida/: tablas, GPX procesados, mapas y registros
→ visor.py: consulta visual y descargas
El paso de validación comprueba la estructura, coordenadas y orden de las
horas. No añade puntos, horas, velocidades ni detenciones a los originales.
El archivo 2_generar_recorridos.py se conserva únicamente como acceso
compatible al validador: ya no genera ni sobrescribe recorridos.
Requisitos: Python 3.10 o superior.
git clone https://github.com/shonales/miCombi.git
cd miCombi
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt
python 2_validar_recorridos.py
python 3_procesar_rutas.py
streamlit run visor.pyLa red vial comprimida se incluye en data/mapa/. Si falta o se desea
actualizarla, ejecutar python 1_descargar_mapa.py; este paso requiere
conexión a internet. El procesamiento usa el mapa local; los fondos
cartográficos del visor pueden requerir conexión.
En VS Code, F5 permite validar los originales, procesarlos o abrir el visor.
miCombi/
├── 1_descargar_mapa.py
├── 2_validar_recorridos.py
├── 2_generar_recorridos.py acceso compatible al validador
├── 3_procesar_rutas.py
├── visor.py
├── rendimiento.py
├── config.json
├── requirements.txt
├── docs/VARIABLES_SEMANA8.md unidad de análisis y variables
└── data/
├── README.md procedencia y actualización de datos
├── gpx_entrada/ originales de las seis rutas
├── parametros_rutas/ identificación y datos descriptivos
├── mapa/ red vial comprimida
├── gpx_dibujado/ referencia auxiliar anterior
└── salida/
├── calidad/ validación y huellas de originales
├── resumen_rutas.csv
├── esquinas/ puntos candidatos y GPX procesados
├── horarios/ horas de paso y detenciones detectadas
├── ejecucion/ tiempos y reporte del procesamiento
└── mapas/ HTML regenerables, excluidos de Git
- Distancia original: longitud de los puntos GPS, después de la limpieza.
- Distancia procesada: longitud de la geometría ajustada a las calles.
- Duración: diferencia entre las horas de los puntos GPS conservados.
- Velocidad media: distancia procesada dividida por la duración.
- Esquinas o paraderos candidatos: intersecciones identificadas en el mapa; no equivalen automáticamente a paraderos oficiales ni a lugares donde se comprobó un abordaje.
- Detenciones: episodios detectados cerca de las esquinas, con los umbrales del procesamiento. Una detención no demuestra por sí sola su causa.
- Horas de paso: estimaciones interpoladas a partir de las horas del GPX.
- Tiempo de ejecución: segundos que tarda el programa; es distinto del tiempo de viaje.
El ajuste usa un modelo oculto de Markov y Viterbi. La geometría se trabaja
en UTM 19 S; las coordenadas publicadas se expresan en WGS84. Los parámetros
están en config.json.
Conservar un respaldo, colocar los GPX en data/gpx_entrada/ y verificar
que cada nombre coincida con su JSON de data/parametros_rutas/. Ejecutar
la validación y revisar su reporte antes de procesar. Las horas y la
duración se obtienen del GPX; los datos descriptivos del JSON no las sustituyen.
La tabla data/salida/calidad/validacion_gpx.json registra una huella SHA-256
por original y comprueba que la lectura no lo haya alterado. La validación
no certifica el dispositivo ni la procedencia de captura.
Repositorio: shonales/miCombi.
Se versionan código, originales de las rutas, metadatos, red vial comprimida,
tablas y controles de calidad. Se excluyen entornos locales, cachés, mapas
HTML regenerables y credenciales. Las huellas de los GPX se conservan sin
normalización de finales de línea mediante .gitattributes.
Los registros anteriores de ejecución se conservan en
data/salida/ejecucion/historico/; el visor muestra los pasos del flujo actual.
| Situación | Acción |
|---|---|
| Falta la red vial | Ejecutar python 1_descargar_mapa.py |
| No aparecen rutas | Revisar data/gpx_entrada/ y ejecutar validación y procesamiento |
| El GPX no tiene horas | Se puede analizar la geometría; revisar antes de informar tiempos o velocidades |
| La validación encuentra errores | Revisar el original y su exportación antes de procesarlo |
| Falta una calle en OpenStreetMap | Revisar el tramo conservado fuera de la red |
Cartografía: © colaboradores de OpenStreetMap (ODbL); imágenes satelitales de Esri.
En la revisión del 30 de octubre de 2026, las coordenadas, alturas y horas
de los seis GPX coincidieron punto por punto con los resultados reproducidos
por el generador de la versión anterior, usando sus parámetros conservados.
El detalle está en data/salida/calidad/procedencia_gpx.json. Esta coincidencia
no acredita una captura independiente con un dispositivo GPS.