Skip to content
shonalesPublic

About

Rutas de micro de Juliaca y San Miguel (Puno, Perú): recorridos GPS ajustados a las calles de OpenStreetMap, paraderos en cada esquina y horarios. Python, OSMnx, Streamlit.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

miCombi · Recorridos de transporte urbano de Juliaca

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.

Rutas disponibles

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.

Flujo actual

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.

Instalación y uso

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.py

La 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.

Organización

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

Qué representan los resultados

  • 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.

Actualizar las rutas

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.

GitHub

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.

Problemas comunes

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.

Comprobación de procedencia

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.

About

Rutas de micro de Juliaca y San Miguel (Puno, Perú): recorridos GPS ajustados a las calles de OpenStreetMap, paraderos en cada esquina y horarios. Python, OSMnx, Streamlit.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages