Autor: Jason Bryer, Ph.D. [email protected]
Website: https://jbryer.github.io/brickset/
Dieses Paket bietet Funktionen zum Zugriff auf Daten zu LEGO -Sätzen von der Brickset -Website. Das Paket enthält auch einen data.frame mit allen LEGO -Sätzen (n = 18.455) von 1970 bis 2022. Dieser Datensatz wurde mithilfe der getSets -Funktion erstellt, und es wird empfohlen, diesen Datenrahmen zu verwenden, um die Anzahl der API -Anrufe zu reduzieren. Siehe das Skript für Build.r -Skript, wie der Datenrahmen erstellt wurde. Informationen zu den Variablen finden Sie unten.
Sie können von Cran mit:
install.packages( ' brickset ' ) Oder die neueste Entwicklungsversion mit dem remotes -Paket:
remotes :: install_github( ' jbryer/brickset ' )Um die Brickset -API zu verwenden, müssen Sie zuerst ein Brickset -Konto erstellen und einen API -Schlüssel anfordern. Die vollständige API-Dokumentation von Brickset ist hier verfügbar: https://brickset.com/article/52664/api-version-3-documentation
Für die meisten Funktionen erfordern ein Brickset -Benutzername, ein Passwort und ein API -Schlüssel. Sie können diese als Parameter übergeben oder diese Optionen festlegen:
options( brickset_key = ' YOUR_API_KEY ' ,
brickset_username = ' YOUR_USERNAME ' ,
brickset_password = ' YOUR_PASSWORD ' ) Die checkKey -Funktion verifiziert, dass Ihr API -Schlüssel gültig ist:
brickset :: checkKey()
# > [1] TRUE Sie können Ihre API -Verwendung mit der getKeyUsageStats -Funktion überprüfen.
brickset :: getKeyUsageStats()
# > dateStamp count
# > 1 2023-03-30T00:00:00Z 3
# > 2 2023-03-24T00:00:00Z 2
# > 3 2023-03-23T00:00:00Z 2
# > 4 2023-03-22T00:00:00Z 16
# > 5 2023-03-21T00:00:00Z 2 Die getSets -Funktion gibt alle LEGO -Sätze aus dem angegebenen Jahr zurück.
sets2021 <- brickset :: getSets( 2021 )
head( sets2021 , n = 3 )
# > setID name year theme themeGroup
# > 1 31026 Police Station 2021 Icons Model making
# > 2 31754 Volkswagen T2 Camper Van 2021 Icons Model making
# > 3 31025 Flower Bouquet 2021 Icons Model making
# > subtheme category released pieces minifigs
# > 1 Modular Buildings Collection Normal TRUE 2923 5
# > 2 Vehicles Normal TRUE 2207 NA
# > 3 Botanical Collection Normal TRUE 756 NA
# > bricksetURL rating reviewCount packagingType
# > 1 https://brickset.com/sets/10278-1 4.4 4 Box
# > 2 https://brickset.com/sets/10279-1 4.1 0 Box
# > 3 https://brickset.com/sets/10280-1 4.3 3 Box
# > availability agerange_min US_retailPrice US_dateFirstAvailable
# > 1 LEGO exclusive 18 199.99 2021-01-02T00:00:00Z
# > 2 LEGO exclusive 18 179.99 2021-08-02T00:00:00Z
# > 3 Retail 18 59.99 2021-01-02T00:00:00Z
# > US_dateLastAvailable UK_retailPrice UK_dateFirstAvailable
# > 1 <NA> 169.99 2021-01-01T00:00:00Z
# > 2 2022-11-12T00:00:00Z 139.99 2021-08-01T00:00:00Z
# > 3 <NA> 54.99 2021-01-01T00:00:00Z
# > UK_dateLastAvailable CA_retailPrice CA_dateFirstAvailable
# > 1 <NA> 269.99 2021-01-02T00:00:00Z
# > 2 2022-11-29T00:00:00Z 249.99 2021-08-03T00:00:00Z
# > 3 <NA> 79.99 2021-01-02T00:00:00Z
# > CA_dateLastAvailable DE_retailPrice DE_dateFirstAvailable
# > 1 <NA> 199.99 2021-01-02T00:00:00Z
# > 2 2022-11-12T00:00:00Z 159.99 2021-08-02T00:00:00Z
# > 3 <NA> 59.99 2021-01-02T00:00:00Z
# > DE_dateLastAvailable height width depth weight
# > 1 <NA> 47.6 57.7 11.8 4.012
# > 2 2022-11-30T00:00:00Z 37.4 57.8 11.2 2.945
# > 3 <NA> 38.2 26.2 7.1 0.760
# > thumbnailURL
# > 1 https://images.brickset.com/sets/small/10278-1.jpg
# > 2 https://images.brickset.com/sets/small/10279-1.jpg
# > 3 https://images.brickset.com/sets/small/10280-1.jpg
# > imageURL
# > 1 https://images.brickset.com/sets/images/10278-1.jpg
# > 2 https://images.brickset.com/sets/images/10279-1.jpg
# > 3 https://images.brickset.com/sets/images/10280-1.jpg Die getReviews -Funktion gibt alle Bewertungen für einen bestimmten Satz zurück.
reviews29830 <- brickset :: getReviews( 29830 )
names( reviews29830 )
# > [1] "author" "datePosted" "title"
# > [4] "review" "HTML" "overall"
# > [7] "parts" "buildingExperience" "playability"
# > [10] "valueForMoney" Die getThemes und getSubthemes geben Informationen über LEGO -Themen zurück.
getThemes() | > head( n = 3 )
# > theme setCount subthemeCount yearFrom yearTo
# > 1 {Unknown IP} 5 0 2023 2023
# > 2 4 Juniors 24 5 2003 2004
# > 3 Action Wheelers 9 0 2000 2001
getSubthemes( ' Toy Story ' )
# > theme subtheme setCount yearFrom yearTo
# > 1 Toy Story Buildable Figures 2 2010 2010
# > 2 Toy Story Original Film 2 2010 2010
# > 3 Toy Story Toy Story 2 3 2010 2010
# > 4 Toy Story Toy Story 3 8 2010 2010
getYears( ' Toy Story ' )
# > theme year setCount
# > 1 Toy Story 2010 15 Die getInstructions geben einen Tisch mit den URLs in die Gebäudestellungen zurück.
instructions <- getInstructions( setID = 29830 )
instructions
# > URL
# > 1 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313846.pdf
# > 2 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313848.pdf
# > 3 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313849.pdf
# > 4 https://www.lego.com/cdn/product-assets/product.bi.core.pdf/6313850.pdf
# > description
# > 1 BI 3103, 112+4/65+200G, 10270 V29 1/2
# > 2 BI 3103, 96+4/65+200G,10270 V29 2/2
# > 3 BI 3103, 112+4/65+200G, V39/142 1/2
# > 4 BI 3103, 96+4/65+200G, V39/142 2/2 legosets -Datensatz Der legosets Data Frame enthält alle LEGO -Sätze (n = 18.455) von 1970 bis 2022.
data( " legosets " , package = " brickset " )
ggplot( legosets , aes( x = year )) + geom_bar() +
ggtitle( ' Number of LEGO sets by year ' ) +
xlab( ' Year ' ) + ylab( ' Number of LEGO Sets ' )
ggplot( legosets , aes( x = pieces , y = US_retailPrice )) +
geom_point() +
ggtitle( ' Cost of LEGO sets by number of pieces ' ) +
xlab( ' Number of LEGO pieces ' ) + ylab( ' US Retail Price (dollars) ' )
Die Variablen im legosets -Datenrahmen sind:
| Typ | Unique_values | |
|---|---|---|
| setId | ganze Zahl | 18455 |
| Name | Charakter | 15372 |
| Jahr | ganze Zahl | 53 |
| Thema | Charakter | 154 |
| Unterbrechungsgruppe | Charakter | 16 |
| Unterthema | Charakter | 901 |
| Kategorie | Charakter | 7 |
| freigegeben | logisch | 2 |
| Stücke | ganze Zahl | 1403 |
| Minifigs | ganze Zahl | 34 |
| Brickseturl | Charakter | 18455 |
| Bewertung | numerisch | 31 |
| Rezensionscount | ganze Zahl | 64 |
| Verpackungstyp | Charakter | 18 |
| Verfügbarkeit | Charakter | 10 |
| AGERANGE_MIN | ganze Zahl | 16 |
| US_RETAILPRICE | numerisch | 142 |
| US_DATEFIRSTAVABLE | Datum | 881 |
| US_DATELASTAVAILABLE | Datum | 2125 |
| Uk_retailprice | numerisch | 210 |
| Uk_datefirstavailable | Datum | 825 |
| Uk_datelastavailable | Datum | 1984 |
| Ca_retailprice | numerisch | 162 |
| Ca_datefirstavailable | Datum | 641 |
| Ca_datelastavailable | Datum | 1808 |
| De_retailprice | numerisch | 155 |
| De_dateFirstavailable | Datum | 428 |
| De_datelastAVailable | Datum | 1176 |
| Höhe | numerisch | 241 |
| Breite | numerisch | 286 |
| Tiefe | numerisch | 279 |
| Gewicht | numerisch | 1046 |
| Vorschaubild | Charakter | 17420 |
| Imageurl | Charakter | 17420 |
Bitte beachten Sie, dass das Brickset -Projekt mit einem Mitwirkenden -Verhaltenskodex veröffentlicht wird. Durch den Beitrag zu diesem Projekt erklären Sie sich damit einverstanden, sich an seine Bedingungen zu halten.