ProHoster > Блог > Administracija > Proširivanje ugniježđenih kolona - liste koje koriste R jezik (tidyr paket i funkcije unnest porodice)
Proširivanje ugniježđenih kolona - liste koje koriste R jezik (tidyr paket i funkcije unnest porodice)
U većini slučajeva, kada radite sa odgovorom primljenim od API-ja, ili sa bilo kojim drugim podacima koji imaju složenu strukturu stabla, suočeni ste sa JSON i XML formatima.
Ovi formati imaju mnoge prednosti: pohranjuju podatke prilično kompaktno i omogućuju vam da izbjegnete nepotrebno dupliciranje informacija.
Nedostatak ovih formata je složenost njihove obrade i analize. Nestrukturirani podaci se ne mogu koristiti u proračunima niti se na njima ne može graditi vizualizacija.
Ovaj članak je logičan nastavak publikacije "R paket tidyr i njegove nove funkcije pivot_longer i pivot_wider". Pomoći će vam da dovedete nestrukturirane strukture podataka u poznatu i pogodnu za analizu tabelarni oblik pomoću paketa tidyr, uključena u jezgro biblioteke tidyverse, i njegovu porodicu funkcija unnest_*().
Sadržaj
Ako ste zainteresovani za analizu podataka, možda će vas zanimati moja telegram и youtube kanala. Većina sadržaja je posvećena R jeziku.
Pravougaonik(napomena prevodioca, nisam našao adekvatne opcije prijevoda za ovaj termin, pa ćemo ga ostaviti kako jeste.) je proces dovođenja nestrukturiranih podataka sa ugniježđenim nizovima u dvodimenzionalnu tabelu koja se sastoji od poznatih redova i kolona. IN tidyr Postoji nekoliko funkcija koje će vam pomoći da proširite ugniježđene stupce liste i svedete podatke na pravokutni, tabelarni oblik:
unnest_longer() uzima svaki element liste kolona i kreira novi red.
unnest_wider() uzima svaki element liste kolona i kreira novu kolonu.
unnest_auto() automatski određuje koju funkciju je najbolje koristiti unnest_longer() ili unnest_wider().
hoist() slicno unnest_wider() ali bira samo navedene komponente i omogućava vam rad sa nekoliko nivoa ugniježđenja.
Većina problema povezanih sa dovođenjem nestrukturiranih podataka sa nekoliko nivoa ugnježđenja u dvodimenzionalnu tabelu može se rešiti kombinovanjem navedenih funkcija sa dplyr-om.
Da bismo demonstrirali ove tehnike, koristićemo paket repurrrsive, koji pruža višestruke složene liste na više nivoa izvedenih iz web API-ja.
Počnimo odavde gh_users, lista koja sadrži informacije o šest GitHub korisnika. Prvo transformirajmo listu gh_users в tibble okvir:
users <- tibble( user = gh_users )
Ovo se čini malo kontraintuitivnim: zašto davati listu gh_users, na složeniju strukturu podataka? Ali okvir podataka ima veliku prednost: kombinuje više vektora tako da se sve prati u jednom objektu.
Svaki element objekta users je imenovana lista u kojoj svaki element predstavlja kolonu.
U ovom slučaju imamo tabelu koja se sastoji od 30 kolona i neće nam trebati većina njih, pa možemo umjesto toga unnest_wider() koristite hoist(). hoist() omogućava nam da izdvojimo odabrane komponente koristeći istu sintaksu kao purrr::pluck():
users %>% hoist(user,
followers = "followers",
login = "login",
url = "html_url"
)
#> # A tibble: 6 x 4
#> followers login url user
#> <int> <chr> <chr> <list>
#> 1 303 gaborcsardi https://github.com/gaborcsardi <named list [27]>
#> 2 780 jennybc https://github.com/jennybc <named list [27]>
#> 3 3958 jtleek https://github.com/jtleek <named list [27]>
#> 4 115 juliasilge https://github.com/juliasilge <named list [27]>
#> 5 213 leeper https://github.com/leeper <named list [27]>
#> 6 34 masalmon https://github.com/masalmon <named list [27]>
hoist() uklanja navedene imenovane komponente sa liste kolona korisniktako da možete razmotriti hoist() poput premeštanja komponenti sa interne liste okvira datuma na njegov najviši nivo.
Github spremišta
Poravnanje liste gh_repos počinjemo slično pretvarajući ga u tibble:
Ovaj put elementi korisnik predstavljaju listu spremišta u vlasništvu ovog korisnika. Svako spremište je zasebna opservacija, dakle prema konceptu urednih podataka (cca uredni podaci) trebalo bi da postanu nove linije, zbog čega i koristimo unnest_longer() ali ne unnest_wider():
repos <- repos %>% unnest_longer(repo)
repos
#> # A tibble: 176 x 1
#> repo
#> <list>
#> 1 <named list [68]>
#> 2 <named list [68]>
#> 3 <named list [68]>
#> 4 <named list [68]>
#> 5 <named list [68]>
#> 6 <named list [68]>
#> 7 <named list [68]>
#> 8 <named list [68]>
#> 9 <named list [68]>
#> 10 <named list [68]>
#> # … with 166 more rows
Sada možemo koristiti unnest_wider() ili hoist() :
repos %>% hoist(repo,
login = c("owner", "login"),
name = "name",
homepage = "homepage",
watchers = "watchers_count"
)
#> # A tibble: 176 x 5
#> login name homepage watchers repo
#> <chr> <chr> <chr> <int> <list>
#> 1 gaborcsardi after <NA> 5 <named list [65]>
#> 2 gaborcsardi argufy <NA> 19 <named list [65]>
#> 3 gaborcsardi ask <NA> 5 <named list [65]>
#> 4 gaborcsardi baseimports <NA> 0 <named list [65]>
#> 5 gaborcsardi citest <NA> 0 <named list [65]>
#> 6 gaborcsardi clisymbols "" 18 <named list [65]>
#> 7 gaborcsardi cmaker <NA> 0 <named list [65]>
#> 8 gaborcsardi cmark <NA> 0 <named list [65]>
#> 9 gaborcsardi conditions <NA> 0 <named list [65]>
#> 10 gaborcsardi crayon <NA> 52 <named list [65]>
#> # … with 166 more rows
Obratite pažnju na upotrebu c("owner", "login"): Ovo nam omogućava da dobijemo vrijednost drugog nivoa iz ugniježđene liste owner. Alternativni pristup je da dobijete cijelu listu owner a zatim pomoću funkcije unnest_wider() stavi svaki od njegovih elemenata u kolonu:
Umjesto da razmišljate o odabiru prave funkcije unnest_longer() ili unnest_wider() možeš koristiti unnest_auto(). Ova funkcija koristi nekoliko heurističkih metoda za odabir najpogodnije funkcije za transformaciju podataka i prikazuje poruku o odabranoj metodi.
got_chars ima identičnu strukturu gh_users: Ovo je skup imenovanih lista, gdje svaki element unutrašnje liste opisuje neki atribut lika iz Game of Thrones. Dovođenje got_chars Za prikaz tabele počinjemo kreiranjem okvira datuma, baš kao u prethodnim primerima, a zatim pretvaramo svaki element u zasebnu kolonu:
chars <- tibble(char = got_chars)
chars
#> # A tibble: 30 x 1
#> char
#> <list>
#> 1 <named list [18]>
#> 2 <named list [18]>
#> 3 <named list [18]>
#> 4 <named list [18]>
#> 5 <named list [18]>
#> 6 <named list [18]>
#> 7 <named list [18]>
#> 8 <named list [18]>
#> 9 <named list [18]>
#> 10 <named list [18]>
#> # … with 20 more rows
chars2 <- chars %>% unnest_wider(char)
chars2
#> # A tibble: 30 x 18
#> url id name gender culture born died alive titles aliases father
#> <chr> <int> <chr> <chr> <chr> <chr> <chr> <lgl> <list> <list> <chr>
#> 1 http… 1022 Theo… Male Ironbo… In 2… "" TRUE <chr … <chr [… ""
#> 2 http… 1052 Tyri… Male "" In 2… "" TRUE <chr … <chr [… ""
#> 3 http… 1074 Vict… Male Ironbo… In 2… "" TRUE <chr … <chr [… ""
#> 4 http… 1109 Will Male "" "" In 2… FALSE <chr … <chr [… ""
#> 5 http… 1166 Areo… Male Norvos… In 2… "" TRUE <chr … <chr [… ""
#> 6 http… 1267 Chett Male "" At H… In 2… FALSE <chr … <chr [… ""
#> 7 http… 1295 Cres… Male "" In 2… In 2… FALSE <chr … <chr [… ""
#> 8 http… 130 Aria… Female Dornish In 2… "" TRUE <chr … <chr [… ""
#> 9 http… 1303 Daen… Female Valyri… In 2… "" TRUE <chr … <chr [… ""
#> 10 http… 1319 Davo… Male Wester… In 2… "" TRUE <chr … <chr [… ""
#> # … with 20 more rows, and 7 more variables: mother <chr>, spouse <chr>,
#> # allegiances <list>, books <list>, povBooks <list>, tvSeries <list>,
#> # playedBy <list>
struktura got_chars nešto teže nego gh_users, jer neke komponente liste char sami su lista, kao rezultat dobijamo stubove - liste:
Vaše dalje akcije zavise od ciljeva analize. Možda trebate staviti informacije u redove za svaku knjigu i seriju u kojoj se lik pojavljuje:
chars2 %>%
select(name, books, tvSeries) %>%
pivot_longer(c(books, tvSeries), names_to = "media", values_to = "value") %>%
unnest_longer(value)
#> # A tibble: 180 x 3
#> name media value
#> <chr> <chr> <chr>
#> 1 Theon Greyjoy books A Game of Thrones
#> 2 Theon Greyjoy books A Storm of Swords
#> 3 Theon Greyjoy books A Feast for Crows
#> 4 Theon Greyjoy tvSeries Season 1
#> 5 Theon Greyjoy tvSeries Season 2
#> 6 Theon Greyjoy tvSeries Season 3
#> 7 Theon Greyjoy tvSeries Season 4
#> 8 Theon Greyjoy tvSeries Season 5
#> 9 Theon Greyjoy tvSeries Season 6
#> 10 Tyrion Lannister books A Feast for Crows
#> # … with 170 more rows
Ili možda želite da kreirate tabelu koja vam omogućava da uskladite karakter i delo:
chars2 %>%
select(name, title = titles) %>%
unnest_longer(title)
#> # A tibble: 60 x 2
#> name title
#> <chr> <chr>
#> 1 Theon Greyjoy Prince of Winterfell
#> 2 Theon Greyjoy Captain of Sea Bitch
#> 3 Theon Greyjoy Lord of the Iron Islands (by law of the green lands)
#> 4 Tyrion Lannister Acting Hand of the King (former)
#> 5 Tyrion Lannister Master of Coin (former)
#> 6 Victarion Greyjoy Lord Captain of the Iron Fleet
#> 7 Victarion Greyjoy Master of the Iron Victory
#> 8 Will ""
#> 9 Areo Hotah Captain of the Guard at Sunspear
#> 10 Chett ""
#> # … with 50 more rows
(Obratite pažnju na prazne vrijednosti "" na terenu title, to je zbog grešaka pri unosu podataka got_chars: zapravo likovi za koje ne postoje odgovarajući naslovi knjiga i TV serija u ovoj oblasti title mora imati vektor dužine 0, a ne vektor dužine 1 koji sadrži prazan niz.)
Možemo prepisati gornji primjer koristeći funkciju unnest_auto(). Ovaj pristup je zgodan za jednokratnu analizu, ali se na njega ne treba oslanjati unnest_auto() za redovnu upotrebu. Poenta je da ako se vaša struktura podataka promijeni unnest_auto() može promijeniti odabrani mehanizam transformacije podataka ako je inicijalno proširio kolone liste u redove koristeći unnest_longer(), onda kada se struktura dolaznih podataka promijeni, logika se može promijeniti u korist unnest_wider(), a korištenje ovog pristupa na stalnoj osnovi može dovesti do neočekivanih grešaka.
tibble(char = got_chars) %>%
unnest_auto(char) %>%
select(name, title = titles) %>%
unnest_auto(title)
#> Using `unnest_wider(char)`; elements have 18 names in common
#> Using `unnest_longer(title)`; no element has names
#> # A tibble: 60 x 2
#> name title
#> <chr> <chr>
#> 1 Theon Greyjoy Prince of Winterfell
#> 2 Theon Greyjoy Captain of Sea Bitch
#> 3 Theon Greyjoy Lord of the Iron Islands (by law of the green lands)
#> 4 Tyrion Lannister Acting Hand of the King (former)
#> 5 Tyrion Lannister Master of Coin (former)
#> 6 Victarion Greyjoy Lord Captain of the Iron Fleet
#> 7 Victarion Greyjoy Master of the Iron Victory
#> 8 Will ""
#> 9 Areo Hotah Captain of the Guard at Sunspear
#> 10 Chett ""
#> # … with 50 more rows
Geokodiranje sa Google-om
Zatim ćemo pogledati složeniju strukturu podataka dobivenih od Googleove usluge geokodiranja. Keširanje akreditiva je protivno pravilima rada sa API-jem za Google mape, tako da ću prvo napisati jednostavan omot oko API-ja. Koji se zasniva na pohranjivanju Google Maps API ključa u varijablu okruženja; Ako nemate ključ za rad sa API-jem za Google Maps pohranjen u varijablama vašeg okruženja, fragmenti koda predstavljeni u ovom odjeljku neće se izvršiti.
has_key <- !identical(Sys.getenv("GOOGLE_MAPS_API_KEY"), "")
if (!has_key) {
message("No Google Maps API key found; code chunks will not be run")
}
# https://developers.google.com/maps/documentation/geocoding
geocode <- function(address, api_key = Sys.getenv("GOOGLE_MAPS_API_KEY")) {
url <- "https://maps.googleapis.com/maps/api/geocode/json"
url <- paste0(url, "?address=", URLencode(address), "&key=", api_key)
jsonlite::read_json(url)
}
Lista koju ova funkcija vraća je prilično složena:
Na sreću, problem pretvaranja ovih podataka u tabelarnu formu možemo riješiti korak po korak pomoću funkcija tidyr. Kako bih zadatak učinio malo izazovnijim i realnijim, počet ću geokodiranjem nekoliko gradova:
city <- c ( "Houston" , "LA" , "New York" , "Chicago" , "Springfield" ) city_geo <- purrr::map (city, geocode)
Pretvorit ću rezultirajući rezultat u tibble, radi praktičnosti, dodat ću kolonu s odgovarajućim imenom grada.
loc <- tibble(city = city, json = city_geo)
loc
#> # A tibble: 5 x 2
#> city json
#> <chr> <list>
#> 1 Houston <named list [2]>
#> 2 LA <named list [2]>
#> 3 New York <named list [2]>
#> 4 Chicago <named list [2]>
#> 5 Springfield <named list [2]>
Prvi nivo sadrži komponente status и result, sa kojim možemo proširiti unnest_wider() :
loc %>%
unnest_wider(json)
#> # A tibble: 5 x 3
#> city results status
#> <chr> <list> <chr>
#> 1 Houston <list [1]> OK
#> 2 LA <list [1]> OK
#> 3 New York <list [1]> OK
#> 4 Chicago <list [1]> OK
#> 5 Springfield <list [1]> OK
Zapiši to results je lista na više nivoa. Većina gradova ima 1 element (koji predstavlja jedinstvenu vrijednost koja odgovara API-ju za geokodiranje), ali Springfield ima dva. Možemo ih povući u zasebne redove sa unnest_longer() :
loc %>%
unnest_wider(json) %>%
unnest_longer(results)
#> # A tibble: 5 x 3
#> city results status
#> <chr> <list> <chr>
#> 1 Houston <named list [5]> OK
#> 2 LA <named list [5]> OK
#> 3 New York <named list [5]> OK
#> 4 Chicago <named list [5]> OK
#> 5 Springfield <named list [5]> OK
Sada svi imaju iste komponente, koje se mogu provjeriti korištenjem unnest_wider():
loc %>%
unnest_wider(json) %>%
unnest_longer(results) %>%
unnest_wider(results)
#> # A tibble: 5 x 7
#> city address_componen… formatted_addre… geometry place_id types status
#> <chr> <list> <chr> <list> <chr> <lis> <chr>
#> 1 Houst… <list [4]> Houston, TX, USA <named … ChIJAYWN… <lis… OK
#> 2 LA <list [4]> Los Angeles, CA… <named … ChIJE9on… <lis… OK
#> 3 New Y… <list [3]> New York, NY, U… <named … ChIJOwg_… <lis… OK
#> 4 Chica… <list [4]> Chicago, IL, USA <named … ChIJ7cv0… <lis… OK
#> 5 Sprin… <list [5]> Springfield, MO… <named … ChIJP5jI… <lis… OK
Možemo pronaći koordinate zemljopisne širine i dužine svakog grada proširivanjem liste geometry:
loc %>%
unnest_wider(json) %>%
unnest_longer(results) %>%
unnest_wider(results) %>%
unnest_wider(geometry)
#> # A tibble: 5 x 10
#> city address_compone… formatted_addre… bounds location location_type
#> <chr> <list> <chr> <list> <list> <chr>
#> 1 Hous… <list [4]> Houston, TX, USA <name… <named … APPROXIMATE
#> 2 LA <list [4]> Los Angeles, CA… <name… <named … APPROXIMATE
#> 3 New … <list [3]> New York, NY, U… <name… <named … APPROXIMATE
#> 4 Chic… <list [4]> Chicago, IL, USA <name… <named … APPROXIMATE
#> 5 Spri… <list [5]> Springfield, MO… <name… <named … APPROXIMATE
#> # … with 4 more variables: viewport <list>, place_id <chr>, types <list>,
#> # status <chr>
A zatim i lokaciju za koju se trebate proširiti location:
loc %>%
unnest_wider(json) %>%
unnest_longer(results) %>%
unnest_wider(results) %>%
unnest_wider(geometry) %>%
unnest_wider(location)
#> # A tibble: 5 x 11
#> city address_compone… formatted_addre… bounds lat lng location_type
#> <chr> <list> <chr> <list> <dbl> <dbl> <chr>
#> 1 Hous… <list [4]> Houston, TX, USA <name… 29.8 -95.4 APPROXIMATE
#> 2 LA <list [4]> Los Angeles, CA… <name… 34.1 -118. APPROXIMATE
#> 3 New … <list [3]> New York, NY, U… <name… 40.7 -74.0 APPROXIMATE
#> 4 Chic… <list [4]> Chicago, IL, USA <name… 41.9 -87.6 APPROXIMATE
#> 5 Spri… <list [5]> Springfield, MO… <name… 37.2 -93.3 APPROXIMATE
#> # … with 4 more variables: viewport <list>, place_id <chr>, types <list>,
#> # status <chr>
Ipak opet, unnest_auto() pojednostavljuje opisanu operaciju uz neke rizike koji mogu biti uzrokovani promjenom strukture ulaznih podataka:
loc %>%
unnest_auto(json) %>%
unnest_auto(results) %>%
unnest_auto(results) %>%
unnest_auto(geometry) %>%
unnest_auto(location)
#> Using `unnest_wider(json)`; elements have 2 names in common
#> Using `unnest_longer(results)`; no element has names
#> Using `unnest_wider(results)`; elements have 5 names in common
#> Using `unnest_wider(geometry)`; elements have 4 names in common
#> Using `unnest_wider(location)`; elements have 2 names in common
#> # A tibble: 5 x 11
#> city address_compone… formatted_addre… bounds lat lng location_type
#> <chr> <list> <chr> <list> <dbl> <dbl> <chr>
#> 1 Hous… <list [4]> Houston, TX, USA <name… 29.8 -95.4 APPROXIMATE
#> 2 LA <list [4]> Los Angeles, CA… <name… 34.1 -118. APPROXIMATE
#> 3 New … <list [3]> New York, NY, U… <name… 40.7 -74.0 APPROXIMATE
#> 4 Chic… <list [4]> Chicago, IL, USA <name… 41.9 -87.6 APPROXIMATE
#> 5 Spri… <list [5]> Springfield, MO… <name… 37.2 -93.3 APPROXIMATE
#> # … with 4 more variables: viewport <list>, place_id <chr>, types <list>,
#> # status <chr>
Također možemo samo pogledati prvu adresu za svaki grad:
loc %>%
unnest_wider(json) %>%
hoist(results, first_result = 1) %>%
unnest_wider(first_result) %>%
unnest_wider(geometry) %>%
unnest_wider(location)
#> # A tibble: 5 x 11
#> city address_compone… formatted_addre… bounds lat lng location_type
#> <chr> <list> <chr> <list> <dbl> <dbl> <chr>
#> 1 Hous… <list [4]> Houston, TX, USA <name… 29.8 -95.4 APPROXIMATE
#> 2 LA <list [4]> Los Angeles, CA… <name… 34.1 -118. APPROXIMATE
#> 3 New … <list [3]> New York, NY, U… <name… 40.7 -74.0 APPROXIMATE
#> 4 Chic… <list [4]> Chicago, IL, USA <name… 41.9 -87.6 APPROXIMATE
#> 5 Spri… <list [5]> Springfield, MO… <name… 37.2 -93.3 APPROXIMATE
#> # … with 4 more variables: viewport <list>, place_id <chr>, types <list>,
#> # status <chr>
Ili koristite hoist() za zaron na više nivoa na koji možete ići direktno lat и lng.
loc %>%
hoist(json,
lat = list("results", 1, "geometry", "location", "lat"),
lng = list("results", 1, "geometry", "location", "lng")
)
#> # A tibble: 5 x 4
#> city lat lng json
#> <chr> <dbl> <dbl> <list>
#> 1 Houston 29.8 -95.4 <named list [2]>
#> 2 LA 34.1 -118. <named list [2]>
#> 3 New York 40.7 -74.0 <named list [2]>
#> 4 Chicago 41.9 -87.6 <named list [2]>
#> 5 Springfield 37.2 -93.3 <named list [2]>
Diskografija Sharle Gelfand
Na kraju ćemo pogledati najsloženiju strukturu - diskografiju Sharle Gelfand. Kao u gornjim primjerima, počinjemo pretvaranjem liste u okvir podataka sa jednom kolonom, a zatim ga proširimo tako da svaka komponenta bude zasebna kolona. Takođe transformišem kolonu date_added na odgovarajući format datuma i vremena u R.
discs <- tibble(disc = discog) %>%
unnest_wider(disc) %>%
mutate(date_added = as.POSIXct(strptime(date_added, "%Y-%m-%dT%H:%M:%S")))
discs
#> # A tibble: 155 x 5
#> instance_id date_added basic_information id rating
#> <int> <dttm> <list> <int> <int>
#> 1 354823933 2019-02-16 17:48:59 <named list [11]> 7496378 0
#> 2 354092601 2019-02-13 14:13:11 <named list [11]> 4490852 0
#> 3 354091476 2019-02-13 14:07:23 <named list [11]> 9827276 0
#> 4 351244906 2019-02-02 11:39:58 <named list [11]> 9769203 0
#> 5 351244801 2019-02-02 11:39:37 <named list [11]> 7237138 0
#> 6 351052065 2019-02-01 20:40:53 <named list [11]> 13117042 0
#> 7 350315345 2019-01-29 15:48:37 <named list [11]> 7113575 0
#> 8 350315103 2019-01-29 15:47:22 <named list [11]> 10540713 0
#> 9 350314507 2019-01-29 15:44:08 <named list [11]> 11260950 0
#> 10 350314047 2019-01-29 15:41:35 <named list [11]> 11726853 0
#> # … with 145 more rows
Na ovom nivou dobijamo informacije o tome kada je svaki disk dodan u Sharlinu diskografiju, ali ne vidimo nikakve podatke o tim diskovima. Da bismo to učinili moramo proširiti kolonu basic_information:
discs %>% unnest_wider(basic_information)
#> Column name `id` must not be duplicated.
#> Use .name_repair to specify repair.
Nažalost, dobićemo grešku, jer... unutar liste basic_information postoji kolona istog imena basic_information. Ako dođe do takve greške, možete koristiti kako biste brzo utvrdili njen uzrok names_repair = "unique":
Zatim ih po potrebi možete spojiti natrag na originalni skup podataka.
zaključak
U srž biblioteke tidyverse uključuje mnoge korisne pakete ujedinjene zajedničkom filozofijom obrade podataka.
U ovom članku smo ispitali porodicu funkcija unnest_*(), koji imaju za cilj rad sa izdvajanjem elemenata iz ugniježđenih lista. Ovaj paket sadrži mnoge druge korisne funkcije koje olakšavaju pretvaranje podataka prema konceptu Tidy Data.