Proyecto Grupo 1 - ELO328 2020.S2

Sistema de Reconocimiento de Pista de Carreras de F1

Integrantes

• Mauricio Aravena (Wauro21)
• Diego Badillo (Zimrahin)
• Steev González (steevglez)
• Sebastián Neira (nabway)

• Felipe Villenas (felipeville)

  Índice

• Instalación
  • Instalación desde Código Fuente
  • Pre-requisito: Qt Creator
  • Pre-requisito: OpenCV
  • Compilación y Ejecución
  • Dataset
• Guía de Uso

  1. Instalación

1.1. Instalación (Linux)

1.1.1. Pre-requisito: Qt Creator

El programa está escrito en el lenguaje de programación C++, junto con el uso de librerías de Qt5 para el desarrollo de la interfaz gráfica. Para el correcto funcionamiento del programa se deben installar las librerías de Qt5 en el host. Para Ubuntu, se deben ejecutar las siguientes líneas en una terminal:

$ sudo apt-get update
$ sudo apt-get install qt5-default

Adicionalmente, se debe descargar e instalar el IDE Qt Creator para poder compilar y ejecutar el programa. Para aquello, se instala de la misma forma desde un terminal con la siguiente línea de código:

$ sudo apt install qtcreator

La alternativa, es realizar una instalación desde el código fuente el cual puede ser obtenido en el sitio web de Qt.

Luego, con Qt Creator ya instalado es posible poder abrir el archivo *.pro contenido en la descarga del código fuente de este programa.

1.1.2. Pre-requisito: OpenCV

Para poder compilar el programa es necesario instalar las librerías de OpenCV. Primero, se debe descargar OpenCV 4.4.0 desde el siguiente enlace. Luego, para instalar OpenCV, se debe seguir los pasos del siguiente tutorial.

Luego de completar la instalación, idealmente se debe agregar la ruta de donde están las liberías de OpenCV al PATH del sistema, para facilitar el proceso a la hora de incluir las librerías en Qt Creator.

1.1.3. Compilación y Ejecución

El programa está ubicado en la sección Releases del repositorio. Para compilar y ejecutar el programa, se debe abrir el archivo *.pro incluido en la descarga con Qt Creator. En el archivo *.pro, se debe cerciorarse que la variable INCLUDEPATH tenga la ruta correcta de donde se encuentran los headers de OpenCV.

Luego, en la siguiente figura se muestra como compilar y ejecutar el programa dentro del IDE.

1.1.4. Dataset

Dentro de los archivos del release vienen incluídas las imágenes y video de prueba, junto con los respectivos archivos de telemetría en formato *.csv y *.txt. Las imágenes de prueba están enumeradas del 0 hacia adelante, y también se incluyen sus respectivas versiones con la línea de carrera mostrada dentro del videojuego para realizar comparaciones con el funcionamiento del algoritmo de procesamiento. Dichos archivos con la línea tienen una w después del número. Los archivos de telemetría correspondientes poseen el mismo número de la imagen a la cual le corresponden, por ejemplo, imagen 0.jpg y su archivo de telemetría 0.csv. En el caso del video de prueba, este se llama redbull.mp4 y su archivo de telemetría redbull.txt.

2. Guía de Uso

2.1 GUI

1. Selección vídeo/imagen: Permite seleccionar el archivo de entrada a analizar. Este puede ser un vídeo o una imagen/fotograma.

2. Selección telemetría: Permite seleccionar el archivo de telemetría con el cual se comparará el archivo cargado en el paso anterior.

3. Selección pista: Seleccionamos la pista a la que corresponden los archivos cargados en los puntos previos. Para este release solo está disponible realizar análisis para Silverstone.

4. Botonera:

• Video Mode: En el caso de que el archivo que se desee analizar corresponda a un vídeo de una carrera, este botón permite seleccionar el análisis deseado.

• Image Mode: En el caso de que el archivo que se desee analizar corresponda a una imagen/fotograma de una carrera, este botón permite seleccionar el análisis deseado.

• Exit: Cierra el programa.

2.2 Ejemplo de procesamiento: Vídeo