Maak een R-package

Reproduceerbaarheid en gebruiksgemak zijn cruciaal in data-analyse, en R-packages sluiten hier perfect op aan. Deze oefening draait om het usethis-pakket in R, een hulpmiddel dat het maken van je eigen R-packages vereenvoudigt.

Stel, je krijgt van je manager de taak om een R-package te maken voor het omrekenen van verschillende lengtematen van de ene eenheid naar de andere. Met deze oefening zet je de eerste stap op dit productieve pad.

Het usethis-pakket is voor jou geladen in deze en de volgende oefeningen.

Deze oefening maakt deel uit van de cursus

R-pakketten ontwikkelen

Cursus bekijken

Oefeninstructies

Maak het skelet van een R-package met de naam "unitConverter" met behulp van het usethis-pakket.
Controleer of het package is aangemaakt door de bestands- en mappenstructuur van het package te bekijken.

Praktische interactieve oefening

Probeer deze oefening eens door deze voorbeeldcode in te vullen.

# Create a package skeleton named unitConverter
___

# View and check the R package directory
___

Code bewerken en uitvoeren

Deze oefening maakt deel uit van de cursus

R-pakketten ontwikkelen

SkillTag.level.intermediateSkillTag.label

4.8+

Begin de cursus gratis

Dive into the essentials of R package construction, from understanding the architecture, the critical R and man directories, to the significance of the DESCRIPTION and NAMESPACE files. Get hands-on with the usethis package as you create your own package skeleton and include data. Strengthen your R function writing skills, grasp best practices for package development, and get comfortable saving functions to a file. Finally, install your package locally using devtools.

Exercise 1: Onderdelen van een R-pakket Exercise 2: Waarheden over R-packages Exercise 3: Wat is nodig in alle R-pakketten?Exercise 4: Vereiste pakketonderdelen Exercise 5: Data en R Markdown-sjabloon in een R-pakket Exercise 6: Maak een R-package

Huidige oefening

Exercise 7: Voeg data toe aan het R-pakket Exercise 8: Maak een R Markdown-sjabloonbestand voor een R-pakket Exercise 9: Indeling van een R Markdown-sjabloonbestand Exercise 10: Pakketfuncties bouwen Exercise 11: R-functie voor het omrekenen van afstanden Exercise 12: Installeer het R-pakket en probeer het uit

Learn the advantages of creating packages versus using scripts, exploring the impact on code organization, reproducibility, collaboration, and sharing. Discover effective strategies for structuring code and functions within the R directory, and choosing an appropriate name and license for your package. Finally, you’ll learn how to manage CRAN package dependencies.

Exercise 1: More package structure Exercise 2: Comparing packages and scripts Exercise 3: Checking your package name Exercise 4: Choosing an appropriate license for your package Exercise 5: Package build Exercise 6: Adding and testing a new function in the package Exercise 7: Debug errors with load_all()Exercise 8: Differences between check() errors, warnings, and notes Exercise 9: Package dependencies Exercise 10: Types of R package dependencies Exercise 11: Set package dependencies Exercise 12: Set more package dependencies

Harness the power of examples in documentation by creating function examples with roxygen2. Understand the significance of examples in clarifying function behavior and identifying key components of a well-documented R function. Explore the purpose of vignettes in R package documentation and learn best practices for creating engaging vignettes and evaluating their content and quality through metadata analysis.

Exercise 1: Help files with R packages Exercise 2: Order of help file components Exercise 3: Exported and non-exported functions Exercise 4: Documentation with roxygen2 Exercise 5: Function documentation starters Exercise 6: Function argument documentation Exercise 7: Function returns and exporting Exercise 8: Generate help file documentation Exercise 9: Getting started with R package vignettes Exercise 10: Browse package vignette Exercise 11: Properties of vignettes and articles Exercise 12: Designing R package vignettes Exercise 13: Generate an R package vignette skeleton Exercise 14: Design an R package vignette Exercise 15: Build package vignettes

Identify why the unit tests are important to package development and maintenance and learn how to implement the testthat package for unit tests. Convert R examples into expectations to build your unit test knowledge. You’ll then gain an understanding on how to document your package data and run some final checks to ensure you have developed a robust R package.

Exercise 1: Unit tests Exercise 2: Advantages of unit testing Exercise 3: Set up your package for testing Exercise 4: Create a testing file Exercise 5: Exploring expect statements Exercise 6: Convert an example into a test Exercise 7: Check for warnings and errors Exercise 8: Check for output and identicalness Exercise 9: Storing expectations as unit tests and running tests Exercise 10: Fix expectation errors Exercise 11: Run a test on function examples Exercise 12: Run all tests in the package Exercise 13: Final steps Exercise 14: Finalize your DESCRIPTION file Exercise 15: Document your data Exercise 16: Check your R package Exercise 17: Congratulations!