Tutorial de Vega-Lite: Exploración de Deneb Custom Visual en LuckyTemplates

En la publicación de blog de hoy, hablaré sobre el nuevo objeto visual personalizado Deneb Vega-Lite disponible para LuckyTemplates. Lo usé exclusivamente en mi presentación parcial para el LuckyTemplates Challenge #17 sobre informes de datos ambientales. Puedes ver el video completo de este tutorial en la parte inferior de este blog.

Esto recibió algunos comentarios positivos, por lo que decidí hacer un tutorial sobre cómo usé Vega-Lite en mi presentación. Mi objetivo para este desafío era ganar experiencia usando el objeto visual personalizado de Deneb, razón por la cual elegí usarlo únicamente y no usar ningún objeto visual estándar de LuckyTemplates.

Tampoco dediqué mucho tiempo a los datos, por lo que no dedicaré tiempo al desarrollo del conjunto de datos, aparte de incluir la porción de toxinas del aire en mi informe.

Tabla de contenido

• Una descripción general de la página del informe en Vega-Lite
• Crear el cuadro de texto del título
• Crear el cuadro de texto de información del informe
• Crear los cortadores de toxinas
• Hacer la cortadora de año
• Creación de la segmentación de estado
• Hacer la tarjeta de métricas en Vega-Lite
• Creación de la imagen principal con Vega-Lite
• Conclusión

Una descripción general de la página del informe en Vega-Lite

Echemos un vistazo a mi presentación. Hay 7 imágenes diferentes y 2 cuadros de texto en la parte superior. Tenemos una segmentación por Años , una segmentación por Estados , una segmentación por Toxinas , una tarjeta de métricas y una imagen principal que muestra la Concentración de Toxinas que puede ordenarse por Estado y Año .

Ahora echemos un vistazo a cada pasante visual a medida que los desarrollamos desde cero. Antes de comenzar, solo una breve nota sobre el entorno de desarrollo. Para comenzar, tomé una copia de mi presentación del Desafío #17 y eliminé todas las páginas. Así que no quedaron visuales; solo quedaron los datos, el modelo de datos y los cálculos DAX.

Crear el cuadro de texto del título

Creé varias páginas en blanco en el cuadro de texto del título. Dado que Vega-Lite es un lenguaje gráfico para imágenes, no existe un método obvio para crear un cuadro de texto.

Pero dado que Vega-Lite visual es solo una colección de marcas, pensé que podría usar solo marcas de texto para simular un cuadro de texto.

Agreguemos una imagen de Deneb. Lo primero que debe hacer es agregar una medida con nuestros valores (título de página y subtítulo de página), luego elija una especificación vacía.

Luego vamos a nuestro archivo de fragmentos y usamos la medida del título de la página para nuestra imagen. Copiaremos el bloque de texto aquí...

…. y pégalo en el editor visual de Deneb.

Podemos usar Control y la rueda del mouse para hacerlo más grande. Luego miraremos la posición para ver si está centrada en la imagen.

Visualicémoslo agregando una marca circular para mostrarnos dónde está el origen. Hagamos una imagen en capas con el cuadro de texto y una marca circular.

Y ahora podemos ver que un círculo está ubicado en el centro de todo el visual.

Otra cosa que podemos hacer es cambiar la posición del origen del visual estableciendo las coordenadas X e Y.

Ahora podemos ver que el texto viene en la parte superior izquierda.

El siguiente paso es cambiar la alineación del texto. Tomaremos un bloque de mi archivo de fragmentos y estableceremos la alineación en el editor a la izquierda, luego alinearemos la marca central en 0.

Lo siguiente que haremos es copiar algunos de los atributos de la fuente en la imagen aquí. Agreguemos algunas características para que el visual marque.

Ahora cambiemos la marca circular a una marca de texto usando el subtítulo de nuestra página y luego hagamos los cambios necesarios.

Luego regresaremos y cambiaremos el tamaño de la imagen solo un poco.

Crear el cuadro de texto de información del informe

Pasemos al cuadro de texto de información del informe. Agregaremos una nueva imagen de Deneb y la colocaremos en la esquina superior derecha y agregaremos nuestra medida de información del informe.

Volvamos a la imagen que acabamos de desarrollar para copiar el código JSON.

Podemos poner ese código JSON en este nuevo objeto visual y volver a usar la especificación vacía.

Para este visual, solo tenemos una marca para usar. No necesitamos una capa y una segunda marca, así que eliminémoslos y luego cambiemos el nombre de la medida para informar la información.

Cambiemos el tamaño de fuente a 12 y el estilo de fuente a cursiva. También cambiaremos la alineación de izquierda a derecha y cambiaremos la coordenada X a 380. Luego regresaremos al informe y ajustaremos un poco el tamaño.

Crear los cortadores de toxinas

Pasemos a las cortadoras. Vega-Lite no tiene un gráfico específico para una segmentación, pero puede usar elementos visuales en lugar de segmentaciones.

Para las segmentaciones, intentemos usar gráficos de barras de un tamaño fijo. Agregaremos una segmentación usando nuestro Deneb visual, y agregaremos nuestras Toxinas como un valor. Agregaremos nuestra medida Tamaño , que es un simple igual a uno.

Una vez que los tenemos bloqueados, podemos usar una especificación de gráfico de barras simple, seleccionar Toxina para la categoría y seleccionar Tamaño para la medida.

Y ahí vamos. Ahora tenemos un gráfico de barras horizontales.

Cambiaremos esto de un gráfico de barras a un gráfico de columnas al voltear la X y la Y.

Lo siguiente que debe hacer es establecer las etiquetas en horizontal y desactivar el eje X. Copiaré este bloque de texto aquí y lo pegaré en el editor.

Podemos cambiar la forma de nuestros gráficos de barras en forma de píldora estableciendo el radio de la esquina aquí.

Volvamos al informe para reducir ese tamaño hasta que el gráfico se parezca más a una píldora.

Apaguemos el eje Y y establezcamos el eje en nulo. Luego apague la información sobre herramientas y cámbiela de verdadero a falso.

Lo siguiente que queremos hacer es establecer la fuente en rojo, por lo que agregaremos esta parte en la descripción del eje X.

Lo siguiente que debe hacer es apagar el borde. Agregaremos un trazo transparente a la configuración de este objeto visual. Iremos a la sección Config , agregaremos una coma y un bloque. Como puede ver, la frontera ha desaparecido.

Finalmente, lo último que queremos hacer para el cortador de toxinas es agregar un título. Copiaremos el código de mi archivo de fragmentos y agregaremos un título.

Hacer la cortadora de año

Para la segmentación de años, aprovechemos el trabajo que ya hemos hecho y copiemos y peguemos la segmentación de toxinas, luego hagamos algunos ajustes. Moveremos el duplicado un poco más arriba, eliminaremos la toxina del valor del campo y agregaremos el año.

Luego editaré el código Vega-Lite y cambiaré el título de Toxins a Years.

Como puede ver, aparecen demasiados campos aquí, así que solo filtraremos un par de ellos y mantendremos solo los que queremos en la parte superior.

Creación de la segmentación de estado

Probemos una forma alternativa para nuestra segmentación de estado y comencemos con un gráfico de barras. Vayamos a LuckyTemplates y agreguemos un nuevo objeto visual Deneb, luego cambiemos un poco el tamaño y la ubicación del objeto visual.

Agregaremos el código de Estados y agregaremos la medida Tamaño , luego usaremos una especificación de Gráfico de barras simple . Seleccionaremos el código de estado para la categoría y el tamaño para la medida.

Tenemos otro gráfico de barras, que cambiaré por un círculo. Luego voy a cambiar el tamaño de los círculos a 2000.

Lo siguiente que debe hacer es desactivar el eje X y luego establecerlo en nulo . Luego apague el título del eje Y, los textos y el dominio.

Al igual que con la otra segmentación, desactivaremos el borde para que podamos configurar el trazo del dominio como transparente desde la sección Configuración .

Lo siguiente que debe hacer es establecer la fuente en rojo, que agregaremos al eje Y.

Lo siguiente es agregar un título en nuestra segmentación, que agregaremos como un bloque aquí en la parte superior.

Hacer la tarjeta de métricas en Vega-Lite

Parece que está de moda en estos días usar tuberías verticales como separador entre elementos de texto. Quería ver si podía hacer eso en Deneb Vega-Lite. Descubrí que si creaba tres marcas de texto para cada medida, podía establecer el separador de nombre y el valor como deseaba.

Agreguemos un nuevo objeto visual de Deneb y agregaremos nuestras cuatro medidas de conteo: Concentración , Existencias , Sitios y Años .

Luego, editaremos el objeto visual y elegiremos una especificación vacía. Revisaremos nuestros fragmentos de bloques de texto y copiaremos la capa de tres imágenes y la pegaremos en el editor visual. Actualmente tenemos una capa de tres marcas de texto: la categoría , el separador y el valor .

Hemos establecido la alineación del separador al centro y la alineación de los datos a la izquierda. Antes de copiar y pegar, haremos ajustes para las tres medidas restantes y usaremos algunos parámetros para facilitar la configuración de los colores.

Agreguemos un bloque de parámetros para los colores. Copiaremos el bloque de texto de nuestro archivo de fragmentos y lo pegaremos aquí en nuestro código. Ya tenemos nuestros parámetros disponibles.

El siguiente paso es actualizar nuestras marcas de texto para usar esos parámetros. Tenemos tres bloques separados que podemos agregar: el bloque de categoría, el bloque separador y el bloque de datos.

Luego estableceremos el título de la tarjeta. Copiaremos el bloque de título del archivo de fragmentos y lo colocaremos en la parte superior de nuestro código. Ahora tenemos nuestro título para nuestra tarjeta de métricas.

También usaremos otra característica que está integrada en Vega-Lite, a saber, el widget enlazado. Pondremos dos: uno para el tamaño de fuente y otro para el espacio vertical . Primero, agregaremos un parámetro para el tamaño de fuente en nuestro elemento visual.

Luego agregaremos parámetros para el espacio vertical y la posición Y vertical. También editaremos las marcas de texto para usar esos parámetros. En lugar de Y en un valor fijo, voy a establecer un valor específico para nuestro parámetro Y1 uno. Como puede ver, podemos cambiar la brecha a medida que se mueve.

Agreguemos otro lado de las marcas de texto. Copiaré la categoría, el separador y el código de datos y los pegaré en el editor. Luego cambiaré esto a Datos 2, Separador 2 y Categoría 2. También cambiaremos nuestro valor Y de Y1 a Y2. Por último, cambiemos la medida que se muestra aquí de Recuento de toxinas a Recuento de sitios .

Creación de la imagen principal con Vega-Lite

Dado que ahora tenemos todos los elementos visuales de configuración en su lugar, podemos pasar al elemento visual principal del informe, a saber, el gráfico de columnas facetadas de concentración por estado y año .

Para crear la imagen principal de este informe, modifiquemos un gráfico de barras simple. Para este, he creado algunos cortes rápidos que nos ayudarán en nuestro esfuerzo de desarrollo. Copiaremos estas segmentaciones y luego las pegaremos en una página en blanco.

Luego agregaremos una imagen de Deneb y la agrandaremos para llenar una buena parte de la página.

También agregaremos nuestra medida de Concentración, Estado, Toxina y Año.

Comencemos usando una especificación de gráfico de barras simple. Para categoría elegiremos Año , y para medida elegiremos Concentración .

Podemos ver un gráfico de barras, pero queremos convertirlo en un gráfico de columnas. Volteemos los ejes X e Y para convertirlo en un gráfico de columnas.

Lo siguiente es establecer el eje de la etiqueta en 0 y desactivar los textos. Como de costumbre, copiaremos el bloque de nuestro archivo de fragmentos para ajustar el ángulo de la etiqueta del eje X.

También ajustaremos la información sobre herramientas tomando ese bloque de código del archivo de fragmentos y pegándolo en el código.

Como podemos ver, hay muchos espacios en blanco adicionales y una palabra muy larga para Concentración en nuestra información sobre herramientas. Agreguemos un título específico usando una C en lugar de Concentración.

También querremos agregar un parámetro para el color de la fuente.

Lo último que debe hacer para esta imagen es agregar un título. Copiaremos el bloque para el título y lo pegaremos en el código.

Queremos que este gráfico de barras sea específico para cada estado. Es muy fácil hacer esto en Vega-Lite; solo agregaremos una faceta en Estado. Copiaremos el bloque de texto y lo pegaremos aquí abajo.

Ahora podemos ver diferentes gráficos para cada estado aquí.

Hagamos una cosa más y ajustemos el tamaño del gráfico. Tomaremos otro pequeño bloque de texto y lo pegaremos en el código.

Cuando volvemos al informe, podemos ver que responde a cualquier estado que elijamos.

Eso es todo para la fase de preparación. A partir de aquí, es una simple cuestión de copiar y pegar nuestras imágenes de desarrollo en una página común y configurar los colores.

Vayamos a LuckyTemplates y tomemos nuestros cuadros de texto tanto para el título como para la información del informe y péguelos en la página principal. Haremos lo mismo con los años, los estados y las segmentaciones de toxinas.

Una de las cosas que podemos hacer ahora es ajustar un poco nuestros colores. En este caso, he elegido el Color del año de Pantone para 2022, que es el morado.

Seleccionemos el fondo del lienzo para que sea nuestro color más oscuro y nuestra paleta de colores.

A continuación, tomemos nuestra tarjeta de métricas y péguela en nuestra página principal. Elegiremos un color de fondo y ajustaremos el tamaño.

Luego tome nuestro gráfico de columnas en ayunas, péguelo en nuestra página principal y cambie su tamaño. Todo está en una página ahora. Es solo una cuestión de revisar las imágenes y cambiar nuestros rojos por blancos para terminar nuestro trabajo.

Revisaremos todas las imágenes para cambiar el rojo por el blanco.

Cree un objeto visual personalizado para LuckyTemplates utilizando
temas personalizados de Deneb en LuckyTemplates
Visuales personalizados de LuckyTemplates: cree una aplicación de generación de informes

Conclusión

Mi conclusión de este tutorial es que puedes hacer prácticamente lo que quieras en Vega-Lite. Pero como cualquier otra herramienta, tiene sus puntos fuertes y débiles. Cuando se ve desde el punto de vista del escritorio de LuckyTemplates, surgen algunas ideas.

Los cuadros de texto requieren mucha mano de obra en Deneb Vega-Lite, por lo que continuaré usando los cuadros de texto dinámicos en el escritorio de LuckyTemplates en este momento, a menos que haya una razón convincente para hacerlo en Vega-Lite.

Los rebanadores son específicos en lugar de estar en cascada en Deneb Vega-Lite, por lo que continuaré usando imágenes de LuckyTemplates para rebanar por el momento. Pero sospecho mucho que hay configuraciones que aún no he encontrado o que la imagen personalizada de Deneb se mejorará con capacidades ampliadas en un futuro próximo.

Las tarjetas requieren un mayor esfuerzo de desarrollo en Vega-Lite en comparación con las estándar disponibles en el escritorio LuckyTemplates, pero Deneb Vega-Lite ofrece personalizaciones mejoradas que no están disponibles en las tarjetas estándar del escritorio LuckyTemplates.

Las imágenes son donde el Deneb Vega-Lite realmente brilla. La flexibilidad es sobresaliente y la personalización es prácticamente ilimitada. También se pueden aprovechar los ejemplos del trabajo de otros en la implementación de Vega-Lite en otros entornos, ya que el código JSON es estándar y se puede personalizar fácilmente para adaptarse a la implementación de LuckyTemplates.

Una desventaja de Vega-Lite es que tiene una curva de aprendizaje, pero la ventaja es que la sintaxis JSON es legible y fácil de entender. Una técnica desarrollada para un objeto visual a menudo se puede copiar como un bloque de texto JSON y pegar tal cual en otro objeto visual. Con esta herramienta, veo un futuro muy brillante, no solo para el objeto visual personalizado de Deneb, sino también para la comunidad de LuckyTemplates.

greg