Autor: Jason Bryer, Ph.D. [email protected]
Sitio web: https://jbryer.github.io/brickset/
Este paquete proporciona funciones para acceder a datos sobre conjuntos LEGO desde el sitio web de BrickSet. El paquete también contiene un data.frame
Con todos los conjuntos de LEGO (n = 18,455) desde 1970 hasta 2022. Este conjunto de datos se creó utilizando la función getSets
y se recomienda que use este marco de datos para reducir el número de llamadas API. Vea el script Build.r sobre cómo se creó el marco de datos. La información sobre las variables se incluye a continuación.
Puedes descargar desde CRAN usando:
install.packages( ' brickset ' )
O la última versión de desarrollo utilizando el paquete remotes
:
remotes :: install_github( ' jbryer/brickset ' )
Para usar la API de BrickSet, primero debe crear una cuenta de BrickSet y solicitar una clave API. La documentación completa de la API de BrickSet está disponible aquí: https://brickset.com/article/52664/api-version-3-documentation
La mayoría de las funciones requieren un nombre de usuario, contraseña y clave API de BrickSet. Puede pasarlos como parámetros, o puede establecer estas opciones:
options( brickset_key = ' YOUR_API_KEY ' ,
brickset_username = ' YOUR_USERNAME ' ,
brickset_password = ' YOUR_PASSWORD ' )
La función checkKey
verificará que su clave API sea válida:
brickset :: checkKey()
# > [1] TRUE
Puede verificar su uso de API con la función getKeyUsageStats
.
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
La función getSets
devuelve todos los conjuntos de LEGO del año dado.
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
La función getReviews
devolverá todas las revisiones para un conjunto determinado.
reviews29830 <- brickset :: getReviews( 29830 )
names( reviews29830 )
# > [1] "author" "datePosted" "title"
# > [4] "review" "HTML" "overall"
# > [7] "parts" "buildingExperience" "playability"
# > [10] "valueForMoney"
Los getThemes
y getSubthemes
devuelven información sobre los temas de LEGO.
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
Las getInstructions
devolverán una mesa con las URL a las instrucciones del edificio.
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
El marco de datos legosets
contiene todos los conjuntos de LEGO (n = 18,455) desde 1970 hasta 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) ' )
Las variables en el marco de datos legosets
son:
Tipo | Valores únicos | |
---|---|---|
setid | entero | 18455 |
nombre | personaje | 15372 |
año | entero | 53 |
tema | personaje | 154 |
geagroup | personaje | 16 |
subtema | personaje | 901 |
categoría | personaje | 7 |
liberado | lógico | 2 |
piezas | entero | 1403 |
minifigs | entero | 34 |
ladrillo | personaje | 18455 |
clasificación | numérico | 31 |
revisión | entero | 64 |
paquete | personaje | 18 |
disponibilidad | personaje | 10 |
agerange_min | entero | 16 |
US_RetailPrice | numérico | 142 |
Us_dateFirstavailable | Fecha | 881 |
US_DATELASTAVAILIBLE | Fecha | 2125 |
Uk_retailprice | numérico | 210 |
Uk_dateFirstavailable | Fecha | 825 |
UK_DATELASTAVAYABLE | Fecha | 1984 |
CA_RetailPrice | numérico | 162 |
CA_DATEFIRSTAVAILABLE | Fecha | 641 |
CA_DATELASTAVABLABLE | Fecha | 1808 |
De_retailprice | numérico | 155 |
De_dateFirstavailable | Fecha | 428 |
De_datelastavisable | Fecha | 1176 |
altura | numérico | 241 |
ancho | numérico | 286 |
profundidad | numérico | 279 |
peso | numérico | 1046 |
miniatura | personaje | 17420 |
imagina | personaje | 17420 |
Tenga en cuenta que el proyecto BrickSet se lanza con un código de conducta de contribuyentes. Al contribuir a este proyecto, usted acepta cumplir con sus términos.