telefonicaiot/smc-echarts repository overview

⁠Aclaraciones previas

Este servicio emplea Apache ECharts, una librería Open Source basada en JavaScript, con el objetivo de poder generar gráficos que precisa este servicio. Esta librería se está empleando en los gráficos descritos en el apartado Graficas implementadas.

El código se ha implementado en el fichero app.py donde se puede encontrar tanto la peticiones a la BD de la plataforma como la configuración de los gráficos diseñados.

Las variables de entorno que se han empleado se pueden encontrar en el fichero config.py dentro de la carpeta visual-echarts

⁠Graficas implementadas:

Grafica rosa de viento:

• http://<'server'>:<'port'>/echarts/rosa-viento?dfrom=2023-01-01&dto=2024-01-01&station=44332212&average_type=H

  Parámetros recibidos desde Urbo:

  • dfrom, dto,station,average_type

Grafica multiple axis:

• http://<'server'>:'<'port'>'/echarts/multiple-axis?dfrom=2023-01-01&dto=2024-01-01&item=Co2&average_type=H&station1=44332212&magnitude1=012&technique1=12

  Parámetros recibidos desde Urbo:

  • dfrom,dto,average_type,station1,magnitude1,technique1,station2,magnitude2,technique2,station3 magnitude3,technique3,station4,magnitude4,technique4,station5,magnitude5,technique5,station6,magnitude6,technique6,station7,magnitude7,technique7,station8,magnitude8,technique8

Gráfica line chart

• http://<'server'>:<'port'>/echarts/line-chart?dfrom=2023-01-01&dto=2024-01-01&item=Co2&average_type=H&magnitude=012&technique=12

  Parámetros recibidos desde Urbo:

  • dfrom, dto, magnitude, technique, average_type

Cuadro de correlación: - http://<'server'>:'<'port'>'/echarts/correlation-chart?dfrom=2023-01-01T00:00:00.000Z&dto=2024-01-01T00:00:00.000 Z&estación1 =101&estación2=102&magnitud1=001&magnitud2=002

⁠Configurar el servicio

Se ejecuta con:

flask run

o con

python3 app.py

Levantando un servicio en el puerto 12021 por defecto.

⁠Generación de certificados.

El servicio utiliza SSL, para poder utilizarlo en los iframes de urbo. En ese caso se necesitan los ficheros de certificados 'cert.pem' y 'key.pem'. Se pueden generar usando un comando como:

    openssl req -x509 -newkey rsa:4096 -nodes -out cert.pem -keyout key.pem -days 365

Los certificados tienen que ser válidos, para la correcta visualización. Se incluyen unos cert.pem y key.pem de pruebas.

⁠Docker

El fichero Dockerfile⁠ incluido puede utilizarse para construir un entorno que lanzar el servicio visual-echarts. (docker build -rm -t visualecharts:latest .)

Adicionalmente se incluye el fichero docker-compose.yaml⁠ para ejecutar el servicio as a service. Si se lanza el stack con docker-compose up -d, se levantará un servicio web al que puede accederse a través del puerto 12021 del equipo en el que se esté ejecutando (http://localhost:12021).

⁠Variables de entorno

Se procede a definir las variables de entorno que se emplean en el despliegue de las gráficas:

⁠Pendiente / WIP

Queda pendiente para tener el servicio completo:

1. Generar de forma dinamica la gráfica rosa-contaminante: -http://<'server'>:<'port'>/echarts/rosa-contaminante?dfrom=2023-01-01&dto=2024-01-01&station=44332212&average_type=H&magnitude=012
   • Parámetros a recibir desde Urbo: dfrom, dto, magnitude, station , average_type