brickset
04.30
作者： Jason Bryer博士[email protected]
网站： https：//jbryer.github.io/brickset/
该软件包提供了从Brickset网站访问有关乐高集合的数据的功能。该软件包还包含一个数据。从1970年到2022年的所有乐高集合（n = 18,455）的data.frame 。此数据集是使用getSets函数创建的，建议您使用此数据框架来减少API调用的数量。有关如何创建数据框，请参见build.r脚本。有关变量的信息如下。
您可以从Cran下载：
install.packages( ' brickset ' )或使用remotes软件包的最新开发版本：
remotes :: install_github( ' jbryer/brickset ' )要使用Brickset API，您必须首先创建一个Brickset帐户并请求API密钥。完整的Brickset API文档可在此处找到：https：//brickset.com/article/52664/api-version-3-documentation
大多数功能都需要一个砖头用户名，密码和API键。您可以将其作为参数传递，也可以设置以下选项：
options( brickset_key = ' YOUR_API_KEY ' ,
brickset_username = ' YOUR_USERNAME ' ,
brickset_password = ' YOUR_PASSWORD ' ) checkKey函数将验证您的API密钥是否有效：
brickset :: checkKey()
# > [1] TRUE您可以使用getKeyUsageStats函数检查API使用情况。
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 getSets功能从给定年份返回所有乐高集合。
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 getReviews功能将返回给定集的所有评论。
reviews29830 <- brickset :: getReviews( 29830 )
names( reviews29830 )
# > [1] "author" "datePosted" "title"
# > [4] "review" "HTML" "overall"
# > [7] "parts" "buildingExperience" "playability"
# > [10] "valueForMoney" getThemes和getSubthemes返回有关乐高主题的信息。
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 getInstructions将将带有URL的表返回到建筑物说明中。
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数据集从1970年到2022年， legosets数据框架包含所有乐高集合（n = 18,455）。
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) ' )
legosets数据框中的变量是：
| 类型 | unique_values | |
|---|---|---|
| setid | 整数 | 18455 |
| 姓名 | 特点 | 15372 |
| 年 | 整数 | 53 |
| 主题 | 特点 | 154 |
| themegroup | 特点 | 16 |
| 子图 | 特点 | 901 |
| 类别 | 特点 | 7 |
| 发行 | 逻辑 | 2 |
| 件 | 整数 | 1403 |
| minifigs | 整数 | 34 |
| 砖头 | 特点 | 18455 |
| 等级 | 数字 | 31 |
| 评论 | 整数 | 64 |
| 包装类型 | 特点 | 18 |
| 可用性 | 特点 | 10 |
| Agerange_min | 整数 | 16 |
| US_RETAILPRICE | 数字 | 142 |
| US_DATEFIRSTAVAILABLE | 日期 | 881 |
| US_DATELASTAVAILABLE | 日期 | 2125 |
| uk_retailprice | 数字 | 210 |
| uk__datefirstavailable | 日期 | 825 |
| UK__DATELASTAVAILABLE | 日期 | 1984 |
| ca_retailprice | 数字 | 162 |
| ca_datefirstavailable | 日期 | 641 |
| ca_datelastavailable | 日期 | 1808年 |
| de_retailprice | 数字 | 155 |
| de_datefirstavailable | 日期 | 428 |
| de_datelastavailable | 日期 | 1176 |
| 高度 | 数字 | 241 |
| 宽度 | 数字 | 286 |
| 深度 | 数字 | 279 |
| 重量 | 数字 | 1046 |
| Thumbnailurl | 特点 | 17420 |
| ImageUrl | 特点 | 17420 |
请注意，Brickset Project已发布贡献者的行为准则。通过为该项目做出贡献，您同意遵守其条款。
