المؤلف: جيسون براير ، دكتوراه [email protected]
الموقع الإلكتروني: https://jbryer.github.io/brickset/
توفر هذه الحزمة وظائف للوصول إلى البيانات حول مجموعات LEGO من موقع Brickset. تحتوي الحزمة أيضًا على data.frame إطار مع جميع مجموعات LEGO (ن = 18،455) من 1970 إلى 2022. تم إنشاء مجموعة البيانات هذه باستخدام وظيفة getSets ويوصى باستخدام إطار البيانات هذا لتقليل عدد مكالمات API. راجع البرنامج النصي Build.r لكيفية إنشاء إطار البيانات. يتم تضمين معلومات حول المتغيرات أدناه.
يمكنك التنزيل من Cran باستخدام:
install.packages( ' brickset ' ) أو أحدث إصدار تطوير باستخدام حزمة remotes :
remotes :: install_github( ' jbryer/brickset ' )لاستخدام API Brickset ، يجب عليك أولاً إنشاء حساب طوبى وطلب مفتاح API. وثيقة 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 .
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 جميع مجموعات LEGO من السنة المحددة.
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 معلومات حول موضوعات 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 ستعيد 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 يحتوي إطار بيانات legosets على جميع مجموعات LEGO (ن = 18،455) من 1970 إلى 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) ' )
المتغيرات في إطار بيانات legosets هي:
| يكتب | فريدة من نوعها | |
|---|---|---|
| setid | عدد صحيح | 18455 |
| اسم | شخصية | 15372 |
| سنة | عدد صحيح | 53 |
| سمة | شخصية | 154 |
| مجموعة | شخصية | 16 |
| الموضوع الفرعي | شخصية | 901 |
| فئة | شخصية | 7 |
| مطلق سراحه | منطقي | 2 |
| قِطَع | عدد صحيح | 1403 |
| minifigs | عدد صحيح | 34 |
| طوبيتورل | شخصية | 18455 |
| تصنيف | رقمية | 31 |
| ReviewCount | عدد صحيح | 64 |
| PackagingType | شخصية | 18 |
| توافر | شخصية | 10 |
| agerange_min | عدد صحيح | 16 |
| us_retailprice | رقمية | 142 |
| US_DATEFIRSTAVAILIDE | تاريخ | 881 |
| US_DATELASTAVAILIDE | تاريخ | 2125 |
| uk_retailprice | رقمية | 210 |
| UK_DATEFIRSTAVAILIDE | تاريخ | 825 |
| UK_DATELASTAVAILIDE | تاريخ | 1984 |
| ca_retailprice | رقمية | 162 |
| ca_datefirstavailivail | تاريخ | 641 |
| ca_datelastavailivail | تاريخ | 1808 |
| de_retailprice | رقمية | 155 |
| DE_DATEFIRSTAVAILIDE | تاريخ | 428 |
| DE_DATELASTAVAILIDE | تاريخ | 1176 |
| ارتفاع | رقمية | 241 |
| عرض | رقمية | 286 |
| عمق | رقمية | 279 |
| وزن | رقمية | 1046 |
| Thumbnailurl | شخصية | 17420 |
| ImageUrl | شخصية | 17420 |
يرجى ملاحظة أنه يتم إصدار مشروع Brickset مع مدونة سلوك مساهم. من خلال المساهمة في هذا المشروع ، فإنك توافق على الالتزام بشروطه.