Vega-Lite Tutorial: Udforskning af Deneb Custom Visual i Lucky Templates

I dagens blogindlæg vil jeg tale om den nyligt tilgængelige Deneb Vega-Lite brugerdefinerede visual til LuckyTemplates. Jeg brugte det udelukkende i min delvise indsendelse til rapportering om miljødata. Du kan se den fulde video af denne tutorial nederst på denne blog.

Dette fik nogle positive tilbagemeldinger, og derfor besluttede jeg at lave en tutorial om, hvordan jeg brugte Vega-Lite i mit indlæg. Mit mål for denne udfordring var at få erfaring med at bruge Deneb brugerdefinerede visual, hvorfor jeg valgte at bruge den udelukkende og ikke at bruge nogen standard LuckyTemplates visuals.

Jeg brugte heller ikke meget tid på dataene, så jeg vil ikke bruge tid på udviklingen af ​​datasættet udover at inkludere luftgiftdelen i min rapport.

Indholdsfortegnelse

• En oversigt over rapportsiden i Vega-Lite
• Oprettelse af titeltekstboksen
• Fremstilling af rapportinfotekstboksen
• Oprettelse af Toxin Slicers
• At lave Årets skæremaskine
• Oprettelse af The State Slicer
• Fremstilling af Metric-kortet i Vega-Lite
• Oprettelse af det vigtigste visuelle ved hjælp af Vega-Lite
• Konklusion

En oversigt over rapportsiden i Vega-Lite

Lad os se på mit indlæg. Der er 7 forskellige billeder og 2 tekstbokse øverst. Vi har en slicer for år , en slicer til stater , en slicer til toksiner , et metrisk kort og et hovedvisuelt billede , der viser toksinkoncentrationen, der kan sorteres efter stat og år .

Lad os nu tage et kig på hver enkelt visuel praktikant, mens vi udvikler dem fra bunden. Før vi begynder, lige en hurtig note om udviklingsmiljøet. Til at starte med tog jeg en kopi af min udfordring #17 indsendelse og slettede alle siderne. Så der var ingen resterende visuals; kun dataene, datamodellen og DAX-beregningerne var tilbage.

Oprettelse af titeltekstboksen

Jeg oprettede et antal tomme sider på titeltekstboksen. Da Vega-Lite er et grafisk sprog for billeder, er der ikke en oplagt metode til at oprette en tekstboks.

Men da Vega-Lite visual kun er en samling af mærker, tænkte jeg, at jeg måske kun kunne bruge tekstmærker til at simulere en tekstboks.

Lad os tilføje en Deneb-visuel. Den første ting at gøre er at tilføje et mål med vores værdier (sidetitel og sideundertitel), og vælg derefter en tom specifikation.

Så går vi over til vores snippets-fil og bruger sidetitelmålet til vores visual. Vi kopierer tekstblokken her...

…. og indsæt det i Denebs visuelle editor.

Vi kan bruge Control og musehjulet til at gøre det større. Så ser vi på positionen for at se, om den er centreret i det visuelle.

Lad os visualisere det ved at tilføje et cirkelmærke for at vise os, hvor oprindelsen er. Lad os lave et lagvis visuelt med tekstboksen og et cirkelmærke.

Og vi kan nu se en cirkel er placeret i midten af ​​hele det visuelle.

En anden ting, vi kan gøre, er at ændre placeringen af ​​oprindelsen af ​​det visuelle ved at indstille X- og Y-koordinaterne.

Nu kan vi se, at teksten kommer øverst til venstre.

Det næste trin er at ændre justeringen af ​​teksten. Vi tager en blok fra min snippets-fil og indstiller justeringen i editoren til venstre, og justerer derefter midtermærket til 0.

Den næste ting, vi skal gøre, er at kopiere nogle af skrifttypeattributterne til det visuelle her. Lad os tilføje et par karakteristika, som det visuelle kan markere.

Lad os nu ændre cirkelmærket til et tekstmærke ved hjælp af vores side undertekst, og derefter foretage ændringerne efter behov.

Så går vi tilbage og ændrer størrelsen på det visuelle bare en lille smule.

Fremstilling af rapportinfotekstboksen

Lad os gå videre til tekstboksen med rapportinfo. Vi tilføjer en ny Deneb-visuel og placerer den i øverste højre hjørne og tilføjer vores rapportinfomål.

Lad os gå tilbage til det visuelle, vi lige har udviklet for at kopiere JSON-koden.

Vi kan sætte den JSON-kode i denne nye visual og bruge den tomme specifikation igen.

Til denne visualisering har vi kun ét mærke at bruge. Vi har ikke brug for et lag og et andet mærke, så lad os slippe af med dem, og derefter ændre navnet på foranstaltningen for at rapportere info.

Lad os ændre skriftstørrelsen til 12, og skrifttypestilen til kursiv. Vi ændrer også justeringen fra venstre mod højre og ændrer X-koordinaten til 380. Så går vi tilbage til rapporten og justerer størrelsen en lille smule.

Oprettelse af Toxin Slicers

Lad os gå videre til udskærerne. Vega-Lite har ikke en specifik grafik til en slicer, men du kan bruge visuals i stedet for slicere.

Lad os prøve at bruge søjlediagrammer med en fast størrelse til udskærerne. Vi tilføjer en slicer ved hjælp af vores Deneb-visual og tilføjer vores Toxins som en værdi. Vi tilføjer vores Størrelsesmål , som er en simpel lig med en.

Når vi har dem låst ind, kan vi bruge en simpel søjlediagramspecifikation, vælge Toxin for kategorien og vælge Størrelse for målingen.

Og der går vi. Vi har nu et vandret søjlediagram.

Vi ændrer dette fra et søjlediagram til et søjlediagram ved at vende X og Y.

Den næste ting at gøre er at sætte etiketterne til vandret og slukke for X-aksen. Jeg kopierer denne tekstblok her og indsætter den i editoren.

Vi kan ændre formen på vores søjlediagrammer til en pilleform ved at indstille hjørneradius her.

Lad os gå tilbage til rapporten for at få den størrelse ned, indtil diagrammet ligner mere en pille.

Lad os slå Y-aksen fra og sætte aksen til nul. Sluk derefter værktøjsspidsen og skift den fra sand til falsk.

Den næste ting, vi vil gøre, er at sætte skrifttypen til rød, så vi tilføjer denne del til X-aksebeskrivelsen.

Den næste ting at gøre er at slukke for grænsen. Vi tilføjer et gennemsigtigt streg til konfigurationen for denne visualisering. Vi går ind i sektionen Config , tilføjer et komma og en blok. Som du kan se, er grænsen gået væk.

Endelig er den sidste ting, vi ønsker at gøre for toksin-sliceren, at tilføje en titel. Vi kopierer koden fra min snippets-fil og tilføjer en titel.

At lave Årets skæremaskine

Lad os drage fordel af det arbejde, vi allerede har udført, til årsskæreren og kopiere og indsætte toksinskæremaskinen og derefter foretage nogle justeringer. Vi flytter duplikatet en lille smule højere, slipper af med toksinet fra feltværdien og tilføjer året.

Så vil jeg redigere Vega-Lite-koden og ændre titlen fra Toxins til Years.

Som du kan se, er der alt for mange felter, der vises her, så lad os bare filtrere et par af dem ud og kun beholde dem, vi vil have øverst.

Oprettelse af The State Slicer

Lad os prøve en alternativ form til vores statsskærer og starte med et søjlediagram. Lad os gå til LuckyTemplates og tilføje en ny Deneb-visuel, og derefter ændre størrelsen og placeringen af ​​visualiseringen en lille smule.

Vi tilføjer tilstandskoden og tilføjer størrelsesmålet , og bruger derefter en enkel søjlediagramspecifikation . Vi vælger tilstandskode for kategori og størrelse for mål.

Vi har et andet søjlediagram, som jeg vil ændre til en cirkel. Så vil jeg ændre størrelsen på cirklerne til 2000.

Den næste ting at gøre er at slå X-aksen fra og derefter indstille den til null . Sluk derefter Y-aksens titel, teksterne og domænet.

Ligesom med den anden slicer deaktiverer vi grænsen, så vi kan indstille domænets streg til transparent fra Config-sektionen .

Den næste ting at gøre er at sætte skrifttypen til rød, som vi tilføjer til Y-aksen.

Det næste er at tilføje en titel i vores udsnit, som vi tilføjer som en blok her øverst.

Fremstilling af Metric-kortet i Vega-Lite

Det ser ud til at være i top i disse dage at bruge lodrette rør som adskillelse mellem tekstelementer. Jeg ville se, om jeg kunne gøre det i Deneb Vega-Lite. Jeg fandt ud af, at hvis jeg oprettede tre tekstmærker for hver takt, kunne jeg indstille navneskilleren og værdien, som jeg ville.

Lad os tilføje en ny Deneb-visual, og vi tilføjer vores fire tællemål: Koncentration , Aktier , Websteder og År .

Derefter redigerer vi det visuelle og vælger en tom specifikation. Vi gennemgår vores tekstblokuddrag og kopierer laget af tre visuals og indsætter det i den visuelle editor. Vi har i øjeblikket et lag med tre tekstmærker: kategorien , separatoren og værdien .

Vi har indstillet justeringen af ​​separatoren til midten, og justeringen af ​​dataene til venstre. Før vi kopierer og indsætter, vil vi foretage justeringer for de resterende tre takter og bruge nogle parametre for at gøre vores indstilling af farverne nemmere.

Lad os tilføje en parameterblok til farverne. Vi kopierer tekstblokken fra vores snippets-fil og indsætter den i vores kode her. Vi har nu vores parametre tilgængelige.

Det næste trin er at opdatere vores tekstmærker for at bruge disse parametre. Vi har tre separate blokke, vi kan tilføje i: kategoriblokken, separatorblokken og datablokken.

Så sætter vi kortets titel. Vi kopierer titelblokken fra snippets-filen og sætter den øverst i vores kode. Nu har vi vores titel for vores metrics-kort.

Vi vil også bruge en anden funktion, der er indbygget i Vega-Lite, nemlig den bundne widget. Vi indsætter to: en til skriftstørrelsen og en til den lodrette mellemrum . Først tilføjer vi en parameter for skriftstørrelsen i vores visual.

Derefter tilføjer vi parametre for det lodrette mellemrum og den lodrette Y-position. Vi vil også redigere tekstmærkerne for at bruge disse parametre. I stedet for Y i en fast værdi, vil jeg indstille en specifik værdi til vores Y1 en parameter. Som du kan se, kan vi ændre mellemrummet, når det bevæger sig rundt.

Lad os tilføje en anden side af tekstmærker. Jeg kopierer kategorien, separatoren og datakoden og indsætter dem i editoren. Så vil jeg ændre dette til Data 2, Separator 2 og Kategori 2. Vi ændrer også vores Y-værdi fra Y1 til Y2. Lad os endelig ændre det mål, der vises her, fra Antal toksiner til Antal steder .

Oprettelse af det vigtigste visuelle ved hjælp af Vega-Lite

Da vi nu har alle de visuelle opsætninger på plads, kan vi gå videre til rapportens hovedvisual, nemlig det facetterede søjlediagram over koncentration efter stat og år .

Lad os ændre et simpelt søjlediagram for at oprette hovedvisualen til denne rapport. Til denne har jeg lavet et par hurtige skæremaskiner, der vil hjælpe os i vores udviklingsindsats. Vi kopierer disse udskæringsmaskiner og indsætter dem på en tom side.

Så tilføjer vi en Deneb visual og gør den større for at fylde en god del af siden.

Vi tilføjer også vores koncentrationsmål, stat, toksin og år.

Lad os starte med at bruge en enkel søjlediagramspecifikation. For kategori vælger vi År , og som mål vælger vi Koncentration .

Vi kan se et søjlediagram vist, men vi ønsker at gøre det til et søjlediagram. Lad os vende X- og Y-akserne for at gøre det til et søjlediagram.

Det næste er at sætte etiketaksen til 0 og at slukke for tekster. Som sædvanlig kopierer vi blokken fra vores snippets-fil for at justere X-aksens etiketvinkle.

Vi vil også justere værktøjstip ved at gribe den kodeblok fra snippets-filen og indsætte den i koden.

Som vi kan se, er der masser af ekstra hvidt mellemrum og et rigtig langt ord for Koncentration i vores værktøjstip. Lad os tilføje en specifik titel ved at bruge et C i stedet for Koncentration.

Vi vil også tilføje en parameter for skriftfarve.

Den sidste ting at gøre for denne visualisering er at tilføje en titel. Vi kopierer blokken for titlen og indsætter den i koden.

Vi ønsker at gøre dette søjlediagram specifikt for hver stat. Det er meget nemt at gøre dette i Vega-Lite; vi vil blot tilføje en facet om State. Vi kopierer tekstblokken og indsætter den her.

Vi kan nu se forskellige grafer for hver stat her.

Lad os gøre en ting mere og justere størrelsen på diagrammet. Vi tager en anden lille tekstblok og indsætter den i koden.

Når vi går tilbage til rapporten, kan vi se, at den er lydhør med de stater, vi vælger.

Det er det for forberedelsesfasen. Herfra er det et simpelt spørgsmål om at kopiere og indsætte vores udviklingsvisuals til en fælles side og indstille farverne.

Lad os gå over til LuckyTemplates og få fat i vores tekstbokse for både titlen og rapportoplysningerne og indsætte dem på hovedsiden. Vi vil gøre det samme for årene, staterne og toksinudskærerne.

En af de ting, vi kan gøre nu, er at justere vores farver lidt. I dette tilfælde har jeg valgt Pantones Årets Farve for 2022, som er lilla.

Lad os vælge lærredsbaggrunden til at være vores mørkeste farve og vores farvepalle.

Lad os derefter få fat i vores metric-kort og indsætte det på vores hovedside. Vi vælger en baggrundsfarve og justerer størrelsen.

Så tag fat i vores faste søjlediagram, indsæt det på vores hovedside og tilpas størrelsen på det. Alt er på én side nu. Det er bare et spørgsmål om at gå gennem det visuelle og ændre vores røde til hvide for at afslutte vores arbejde.

Vi vil gennemgå hvert billede for at ændre rødt til hvidt.

Konklusion

Min takeaway fra denne tutorial er, at du kan gøre stort set, hvad du vil i Vega-Lite. Men som ethvert andet værktøj har det sine styrker og svagheder. Når det ses fra LuckyTemplates skrivebordssynspunkt, dukker et par indsigter frem.

Tekstbokse er arbejdskrævende i Deneb Vega-Lite, så jeg fortsætter med at bruge de dynamiske tekstbokse i LuckyTemplates desktop på nuværende tidspunkt, medmindre der er en tvingende grund til at gøre dem i Vega-Lite.

Slicere er specifikke snarere end cascading i Deneb Vega-Lite, så jeg fortsætter med at bruge LuckyTemplates visuals til udskæring indtil videre. Men jeg har en stor mistanke om, at enten er der konfigurationer, jeg ikke har fundet endnu, eller at Deneb brugerdefinerede visual vil blive forbedret med udvidede muligheder i den nærmeste fremtid.

Kort kræver øget udviklingsindsats i Vega-Lite sammenlignet med standardkortene, der er tilgængelige i LuckyTemplates desktop, men Deneb Vega-Lite giver forbedrede tilpasninger, der ikke er tilgængelige i standardkortene på LuckyTemplates desktop.

Det visuelle er, hvor Deneb Vega-Lite virkelig skinner. Fleksibiliteten er enestående, og tilpasningen er praktisk talt ubegrænset. Man kan også udnytte eksemplerne på andres arbejde med at implementere Vega-Lite i andre miljøer, da JSON-koden er standard og nemt kan tilpasses, så den passer til implementeringen af ​​LuckyTemplates.

En ulempe ved Vega-Lite er, at den har en indlæringskurve, men på opsiden er en JSON-syntaks læselig og let at forstå. En teknik udviklet til én visualisering kan ofte kopieres som en JSON-tekstblok og indsættes som den er i en anden visualisering. Med dette værktøj ser jeg en meget lys fremtid, ikke kun for Deneb brugerdefinerede visual, men for LuckyTemplates-fællesskabet.

Greg