Opetusohjelma: Suppilokaavion luominen R-komentosarjasta R-visualisointiin

Tässä artikkelissa kerrotaan vaihe vaiheittain, miten voit luoda suppilokaavion käyttämällä R-komentosarjaa R-visualisoinnissa. Lähdetiedostot ovat ladattavissa kaikissa vaiheissa.

Tässä artikkelissa opit luomaan:

• R-komentosarja RStudioon
• R-visualisointi Power BI:ssä
• PNG-pohjainen R:ää hyödyntävä visualisointi Power BI:ssä
• HTML-pohjainen R:ää hyödyntävä visualisointi Power BI:ssä

Suppilokaavio tarjoaa helpon tavan käyttää, tulkita ja näyttää odotetun vaihtelun määrän. Suppilo muodostetaan käyttämällä luotettavuusrajoja, ja poikkeavat arvot näytetään pisteinä suppilon ulkopuolella.

Tässä esimerkissä suppilokaavion avulla verrataan ja analysoidaan erilaisia tietojoukkoja.

Edellytykset

• Hanki Microsoft Fabric -tilaus. Voit myös rekisteröityä ilmaiseen Microsoft Fabric -kokeiluversioon.

• Asenna pbiviz-työkalut.

Luo R-komentosarja semanttisen mallin avulla

1. Lataa minimaalinen R-komentosarja ja sen tietotaulukko dataset.csv.

2. Muokkaa seuraavaksi komentosarjaa tämän komentosarjan peilaamiseksi. Tämä lisää syötteen virheenkäsittelyn ja käyttäjäparametrit, joilla hallitaan kaavion ulkoasua.

Raportin luominen

Muokkaa seuraavaksi komentosarjaa tämän komentosarjan peilaamiseksi. Tämä lataa dataset.csv read.csv sijaan Power BI Desktop -työtilaan ja luo Syöpäkuolleisuus-taulukon. Katso tulokset seuraavasta PBIX-tiedostosta.

Huomautus

dataset on pysyväiskoodattu nimi minkä tahansa R-visualisoinnin syötteelledata.frame.

Luo R:ää hyödyntävä visualisointi ja paketti R-koodissa

1. Luo uusi R:ää hyödyntävä visualisointi suorittamalla seuraava komento:

   pbiviz new funnel-visual -t rvisual
   cd funnel-visual
   npm install 
   pbiviz package
   

   Tämä komento luo kansion funnel-visual, jossa on alkuperäinen mallivisualisointi (-t mallia varten). PBIVIZ on dist-kansiossa ja R-koodi script.r-tiedostossa. Yritä tuoda se Power BI:hin ja katso, mitä tapahtuu.

2. Muokkaa script.r-tiedostoa ja korvaa sen sisältö aiemmalla komentosarjalla.

3. Muokkaa capabilities.json ja korvaa merkkijono Values kohteella dataset. Tämä korvaa mallin roolin nimen R-koodin kaltaiseksi.

   

4. (valinnainen) Muokkaa dependencies.json ja lisää osa jokaiselle R-komentosarjan edellyttämälle R-paketille. Tämä kehottaa Power BI:n tuomaan nämä paketit automaattisesti, kun visualisointi ladataan ensimmäisen kerran.

   

5. Pakkaa visualisointi uudelleen -komennolla pbiviz package ja yritä tuoda se Power BI:hin.

Huomautus

Katso ladattavat PBIX ja lähdekoodi .

Tee R-pohjaisia visualisointien parannuksia

Visualisointi ei ole vielä käyttäjäystävällinen, koska käyttäjän on tiedettävä sarakkeiden järjestys syötetaulukossa.

1. Jaa syötekentän dataset kolmeen kenttään (rooliin): Population, Numberja Tooltips

   

2. Muokkaa capabilities.json ja korvaa dataset rooli kolmella uudella roolilla, tai lataa capabilities.json.

   Sinun on päivitettävä osat ja dataRoles dataViewMappings, jotka määrittävät kunkin syötekentän nimet, tyypit, työkaluvihjeet ja sarakkeiden enimmäismäärät.

   

   Katso lisätietoja ominaisuuksista.

3. Muokkaa script.r-tiedostoa tukeaksesi Population-, Number ja Tooltips syötteen tietokehyksinä :n datasetsijaan, tai lataa script.r.

   

   Vihje

   Jos haluat seurata R-komentosarjan muutoksia, hae seuraavia kommenttilohkoja:

   #RVIZ_IN_PBI_GUIDE:BEGIN: Added to enable visual fields
   ...
   #RVIZ_IN_PBI_GUIDE:END: Added to enable visual fields
   
   #RVIZ_IN_PBI_GUIDE:BEGIN: Removed to enable visual fields 
   ...
   #RVIZ_IN_PBI_GUIDE:BEGIN: Removed to enable visual fields
   

4. Pakkaa visualisointi uudelleen -komennolla pbiviz package ja yritä tuoda se Power BI:hin.

Huomautus

Katso ladattavat PBIX ja lähdekoodi .

Lisää käyttäjäparametrit

1. Lisää käyttäjälle ominaisuuksia, jotta hän voi hallita visuaalisten elementtien värejä ja kokoja, mukaan lukien käyttöliittymän sisäiset parametrit.

   

2. Muokkaa capabilities.json ja päivitä osa objects . Tässä määritetään kunkin parametrin nimet, työkaluvihjeet ja tyypit ja päätetään myös parametrien jaosta ryhmiin (tässä tapauksessa ryhmiä on kolme).

   lataa capabilities.json, katso lisätietoja kohdasta objektin ominaisuudet

   

3. Muokkaa src/settings.ts tämän settings.ts peilaamiseksi. Tämä tiedosto kirjoitetaan TypeScriptillä.

   Tässä on kaksi koodilohkoa, joiden lisääminen kohteeseen on lisätty:

   • Määrittää uusi liittymä, joka sisältää ominaisuuden arvon
   • Määritä jäsenen ominaisuus ja oletusarvot

   

4. Muokkaa script.r-tiedostoa tämän script.r-kohteen peilaamiseksi. Tämä lisää käyttöliittymän parametrien tuen lisäämällä if.exists -kutsut käyttäjäparametria kohden.

   Vihje

   Jos haluat seurata R-komentosarjan muutoksia, hae seuraavia kommentteja:

   #RVIZ_IN_PBI_GUIDE:BEGIN:Added to enable user parameters
    ...
   #RVIZ_IN_PBI_GUIDE:END:Added to enable user parameters
   
   #RVIZ_IN_PBI_GUIDE:BEGIN:Removed to enable user parameters 
    ...
   #RVIZ_IN_PBI_GUIDE:END:Removed to enable user parameters
   

   

   Voit päättää olla näyttämättä parametreja käyttöliittymässä, kuten me teimme.

5. Pakkaa visualisointi uudelleen -komennolla pbiviz package ja yritä tuoda se Power BI:hin.

Huomautus

Katso ladattavat PBIX ja lähdekoodi .

Vihje

Olemme lisänneet useiden tyyppien parametrit (totuusarvo, numero, merkkijono ja väri) kaikki kerralla. Katso tästä esimerkistä, miten yksittäinen parametri lisätään.

Visualisoinnin muuntaminen RHTML-pohjaseksi visualisoinniksi

Koska tuloksena saatu visualisointi on PNG-pohjainen, se ei reagoi hiiren osoittimen viemiseen eikä sitä voi zoomata, joten meidän on muunnettava se HTML-pohjaseksi visualisoinniksi. Luomme tyhjän R:ää hyödyntävän HTML-pohjaisen visuaalisen mallin ja kopioimme jotkin komentosarjat PNG-pohjaisessa projektissa.

1. Suorita komento:

   pbiviz new funnel-visual-HTML -t rhtml
   cd funnel-visual-HTML
   npm install 
   pbiviz package
   

2. Avaa capabilities.json ja huomioi "scriptOutputType":"html" rivi.

3. Avaa dependencies.json ja kirjoita muistiin lueteltujen R-pakettien nimet.

4. Avaa script.r ja huomioi rakenne. Voit avata ja suorittaa sen RStudiossa, koska se ei käytä ulkoista syötettä.

   Tämä luo ja tallentaa out.html. Tämä tiedosto on itsenäinen (ilman ulkoisia riippuvuuksia), ja se määrittää HTML-pienoissovelluksen sisältämät grafiikat.

   Tärkeä

   R-apuohjelmat htmlWidgets annetaan käyttäjille r_files-kansiossa, jotta tai widget objektit voidaan muuntaa plotly erilliseksi HTML:ksi.

   Tämä R:ää hyödyntävä visualisointiversio tukee source myös komentoa (toisin kuin aiemmat visualisointityypit), jotta koodiasi olisi helpommin luettava.

5. Korvaa capabilities.json edellisen vaiheen capabilities.json: tai lataa capabilities.json.

   Muista säilyttää:

   "scriptOutputType": "html"

6. Yhdistä script.r-tiedoston uusin versio mallin script.r-tiedostoon, tai lataa script.r.

   Uusi komentosarja käyttää plotly -pakettia muuntamaan ggplot-objektin plotly-objektiksi ja sen jälkeen htmlWidgets -pakettia sen tallentamiseksi HTML-tiedostoon.

   Suurin osa apuohjelman funktioista siirretään kohteeseen r_files/utils.r ja generateNiceTooltips funktio lisätään plotly-objektin ulkoasuun.

   

   

   Vihje

   Jos haluat seurata R-komentosarjan muutoksia, hae seuraavia kommentteja:

   #RVIZ_IN_PBI_GUIDE:BEGIN:Added to create HTML-based 
    ...
   #RVIZ_IN_PBI_GUIDE:BEGIN:Added to create HTML-based
   
   #RVIZ_IN_PBI_GUIDE:BEGIN:Removed to create HTML-based  
   ...
   #RVIZ_IN_PBI_GUIDE:BEGIN:Removed to create HTML-based
   

7. Yhdistä dependencies.json uusin versio mallin dependencies.json, jos haluat sisällyttää uudet R-paketin riippuvuudet, tai lataa dependencies.json.

8. Muokkaa src/settings.ts samalla tavalla kuin edellisissä vaiheissa.

9. Pakkaa visualisointi uudelleen -komennolla pbiviz package ja yritä tuoda se Power BI:hin.

Huomautus

Katso ladattavat PBIX ja lähdekoodi .

Luo muita esimerkkejä

1. Luo tyhjä projekti suorittamalla seuraava komento:

   pbiviz new example -t rhtml
   cd example
   npm install 
   pbiviz package
   

2. Ota koodi tästä esittelystä ja tee korostetut muutokset:

   

3. Korvaa mallisi script.r-komentosarja ja suorita pbiviz package uudelleen. Nyt visualisointi sisältyy Power BI -raporttiin!

Vinkkejä

• Suosittelemme, että kehittäjät muokkaavat pbiviz.json oikeiden metatietojen tallentamiseksi, kuten versio, sähköposti, nimi, käyttöoikeustyyppi ja niin edelleen.

  Tärkeä

  GUID-kenttä on visualisoinnin yksilöivä tunnus. Jos luot uuden projektin kullekin visualisoinnille, myös sen GUID-tunnus on eri. Tämä on sama vasta, kun käytät uuteen visualisointiin kopioitunutta vanhaa projektia, mitä sinun ei pitäisi tehdä.

• Muokkaa resursseja/icon.png ja luo visualisoinnille yksilölliset kuvakkeet.

• Korjaa R-koodin virhe RStudiossa käyttämällä Power BI -raportin tietoja lisäämällä seuraava R-komentosarjan alkuun (muokkaa muuttujaa fileRda ):

  #DEBUG in RStudio
  fileRda = "C:/Users/yourUserName/Temp/tempData.Rda"
  if(file.exists(dirname(fileRda)))
  {
     if(Sys.getenv("RSTUDIO")!="")
       load(file= fileRda)
     else
       save(list = ls(all.names = TRUE), file=fileRda)
  }
  

  Tämä tallentaa ympäristön Power BI -raportista ja lataa sen RStudioon.

• Sinun ei tarvitse kehittää R:ää hyödyntäviä visualisointeja alusta alkaen GitHubissa käytettävissä koodeilla. Voit valita mallina käytettävän visualisoinnin ja kopioida koodin uuteen projektiin.

  Kokeile esimerkiksi käyttää mukautettua splini-visualisointia.

• Jokainen R-visualisointi soveltaa operaattoria unique syötetaulukossaan. Jos haluat välttää identtisten rivien poistamisen, harkitse ylimääräisen syötekentän lisäämistä yksilöivällä tunnuksella ja ohita se R-koodissa.

• Jos sinulla on Power BI -tili, voit Power BI -palvelun avulla kehittää visualisoinnin lennossa sen sijaan, että pakkaisit ne uudelleen komennolla pbiviz package .

HTML-pienoissovellusvalikoima

Tutustu HTML-pienoissovellusvalikoiman visualisointeihin, joita voit käyttää seuraavassa visualisoinnissa. Olemme helpottaneet luodessamme visualisointien projekti säilön , jossa on valittavana yli 20 vuorovaikutteista HTML-visualisointia.

Vihje

Jos haluat vaihtaa html-pienoissovellusten välillä, käytä Muotoiluasetukset-tyyppiä>>. Kokeile käyttämällä tätä PBIX-tiedostoa.

Mallin käyttäminen visualisoinnissa

1. Lataa koko kansio.
2. Muokkaa script.r-tiedostoa ja dependencies.json niin, että vain yksi pienoissovellus säilyy.
3. Muokkaa capabilities.json ja settings.ts valitsimen Type poistamiseksi.
4. Muuta const updateHTMLHead: boolean = true; arvoon false visual.ts. (suorituskyvyn parantamiseksi)
5. Muuta pbiviz.json, ennen kaikkea kentän guid metatietoja.
6. Pakkaa visualisointi uudelleen ja jatka sen mukauttamista haluamallasi tavalla.

Huomautus

Palvelu ei tue kaikkia tämän projektin pienoissomentteja.

Liittyvä sisältö

Jos haluat lisätietoja, tutustu muihin Power BI -opetusohjelmiin, kuten Power BI:n pyöreän kortin visualisoinnin kehittäminen ja R-visualisoinnit.

Lue, miten voit kehittää ja lähettää visualisointeja Office-kauppaan (valikoima) tai katso lisäesimerkkejä R-komentosarjan esittelystä