dtpm-validador-datos

Herramienta que tiene por objetivo validar los datos de entrada para el proceso realizado por siguientes herramientas:

  1. aptto-dtpm-demanda : Transformacion y enrequecimiento de los datos de validaciones de pago Bip
  2. Estimacion de paradero de subida
  3. Estimacion de paradero de bajada
  4. Estimacion de viaje, e indicadores de viajes
  5. Estimacion de perfiles de carga
  6. Estimacion de matrices origen-destino
  7. Calculo de factores de pago en Zonas Pagas
  8. aptto-dtpm-velocidades : Estimacion de velocidades por tramo (500m) periodo (30 min) para cada servicio-sentido
  9. cityred : Sistema web para visualizar y analizar los datos procesados por las herramientas anteriores

Instructivo de Instalación

Este documento detalla los pasos necesarios para instalar y configurar la herramienta utilizando un entorno virtual de Python (virtualenv). Las instrucciones están separadas para sistemas operativos Windows y Linux.

Requisitos Previos

  1. Python: Asegúrate de tener Python instalado en tu sistema.
  2. Verifica la instalación con: bash python --version o
    bash python3 --version
  3. pip: Confirma que tienes pip instalado. Si no, instálalo desde la documentación oficial de Python.
  4. virtualenv: Instálalo con: bash pip install virtualenv

Descarga del proyecto

El proyecto se encuentra en el siguiente repositorio de github.

https://github.com/Pragxis/dtpm-validador-datos

Se puede descargar haciendo click en el boton --> "<> Code" y "luego Download Zip"

Descarga repositorio

Pasos de Instalación

# Posicionarse dentro del proyecto
cd /ruta/del/proyecto

# Crear un entorno virtual
# En Windows:
python -m virtualenv venv
venv\Scripts\activate

# En Linux:
python3 -m virtualenv venv
source venv/bin/activate

# Instalar las dependencias desde el archivo requirements.txt
pip install -r requirements.txt

# Para salir del entorno virtual (no debe salir para ejecutar el programa)
deactivate

Datos de entrada

Los datos de un programa de operación deben almacenarse en una carpeta cuyo nombre corresponda a la fecha de inicio del programa. Dentro de esta carpeta, debe seguirse la siguiente estructura de subcarpetas:

Estructura de carpeta

Ejecución

Para ejecutar el programa se debe ejecutar el siguiente comando:

python3 dtpm-validador-datos.py parametros.json

Donde el archivo de parametros debe contener los siguientes campos:

 {
 "fecha_po" : "2024-05-18",
 "fecha_ini" : "2024-10-01",
 "fecha_fin" : "2024-10-30",
 "carpeta_po" : "./data/2024-05-18",
 "carpeta_tmp" : "./data/tmp",
 "carpeta_196" : "./data/196",
 "diccionario_zonas_pagas": "Diccionario-DetalleServicioZP_20240701_20240715.csv"
 }

y cada campo corresponde a :

Campo Descripción
fecha_po Fecha de inicio del programa de operacion, debe coincidir con el nombre de la carpeta
fecha_ini Fecha de inicio del periodo que se quiere validar
fecha_fin Fecha de fin del periodo que se quiere validar
carpeta_po Ruta en donde se encuentra la carpeta del PO
carpeta_tmp Ruta de una carpeta temporal que se usara para descargar archivos temporales desde la nube
carpeta_196 Ruta donde se dejaran los archivos 1.96 manualmente
diccionario_zonas_pagas Nombre del archivo con el diccionario de detalles de las zonas pagas

🔴 ¡Consideraciones importantes!

  1. Se deben descargar y copiar manualmente los archivos de 1.96 en la carpeta definida en los parametros
  2. El proyecto debe tener una llave para la conexion con la nube, esta llave debe ser pedida al administrador del sistema [mzuniga@pragxis.cl]
  3. Se debe ejecutar el validador en forma separada para periodo definido por cada archivo del diccionario de zonas pagas

Datos de salida

El programa al ser ejecutado ira secuencialmente realizando validaciones, todas los textos de información, advertencias o errores seran guardados en un archivo con el nombre o fecha del programa de operación y de extensión .log.