Basisvaardigheden in R: Hulp
Hulp beschikbaar binnen R en RStudio
Als je begint met R, zul je regelmatig fouten, waarschuwingen, berichten en andere problemen tegenkomen. Niemand kan zonder fouten werken. Deze theoriepagina legt uit hoe je hulp kunt krijgen vanuit R en RStudio.
Hints in RStudio Stel je wilt de functie ls()
om de structuur van een dataset te bekijken, zeg de ingebouwde dataset airquality. Tijdens de invoer in het console kun je al suggesties krijgen!
We toetsen deze functie in de console in. Normaal gesproken zouden we de naam van de dataset invullen tussen de haakjes, maar nu laten we dit bewust leeg. Als we onze muis tussen de haakjes plaatsen en op Tab drukken dan geeft R ons automatisch een lijstje met alle mogelijke invoeropties:
In de gele tekst staat een korte uitleg over het geselecteerde veld, daaronder staat dat je voor meer hulp op F1 kan indrukken. Wanneer we dit doen dan krijgen we in het paneel rechtsonderin onder "Help" een uitgebreide beschrijving van de functie en de verschillende invoermogelijkheden
Rechtstreeks om hulp vragen Je kunt ook direct om hulp vragen en een uitgebreide beschrijving van een functie, zeg ls()
, krijgen. Toets dan in de console help("ls")
of korter ?ls
in.
Structuur van een hulpbericht In plaats van een hulpverzoek in te voeren zoals ?mean
, kun je ook de zoekfunctie gebruiken in het onderste rechterpaneel 'Help'. Zie onderstaande schermafdruk.
De structuur van de hulp is altijd hetzelfde, behalve dat onnodige delen worden weggelaten:
-
Description: Een korte beschrijving van wat de functie doet.
-
Usage: Hier zie je alle functie-argumenten (dwz de informatie die je aan de functie mee moet geven).
-
Arguments: Een gedetailleerde beschrijving van de functie-argumenten.
-
Details: Meestal wiskundige details over de implementatie.
-
Value: Een beschrijving van wat de functie retourneert.
-
Author(s): Wie heeft de functie geschreven? Als je vragen hebt of een fout vindt, kun je contact opnemen met de auteur..
-
References: Meer informatie over de methoden en hoe ze te citeren.
-
See Also: Links naar andere verwante functies.
-
Examples: Dit is misschien het meest nuttige deel voor een beginner. Hier vind je voorbeelden van hoe de functie wordt gebruikt. Kopieer ze naar de console en inspecteer de objecten die worden doorgegeven, welke argumenten worden gebruikt en wat de uitvoer is.
R help functies Zoals je hierboven hebt gezien, biedt het ingebouwde hulpsysteem details, referenties en voorbeelden van elke functie die zich in een momenteel geïnstalleerd pakket bevindt. Je kunt hulp verkrijgen door een van de functies uit onderstaande tabel uit te voeren."
Functie | Actie |
help.start() |
Roep het hulpsysteem op. |
help("foo") or ?foo |
Krijg hulp over foo . |
help(package = "foo") |
Krijg hulp over het pakket foo . |
help.search("foo") of ??foo |
Zoek in het hulpsysteem naar gevallen van de string foo . |
example("foo") |
Geef voorbeelden van de functie foo (aanhalingstekens zijn optioneel). |
data() |
Maak een lijst van alle beschikbare datasets in momenteel geactiveerde pakketten. |
vignette() |
Maak een lijst van alle beschikbare vignetten voor momenteel geïnstalleerde pakketten. |
vignette("foo") |
Toon specifieke vignetten voor het onderwerp foo . |
De functie help.start()
opent een hulpsysteem met toegang tot inleidende en geavanceerde handleidingen, veelgestelde vragen en naslagmateriaal. De vignetten die worden teruggegeven door de functie vignette()
zijn praktische introductieartikelen die worden geleverd in PDF- of HTML-indeling. Niet alle pakketten hebben vignetten.