Comment utiliser les fichiers d'aide R - les nuls

Parfois, vous ne connaissez pas la fonction exacte à utiliser dans R D'autres fois, vous savez peut-être exactement ce dont vous avez besoin. Quoi qu'il en soit, les fichiers d'aide de R peuvent être utiles.

Lorsque vous connaissez la fonction R souhaitée

Si vous connaissez le nom de la fonction pour laquelle vous avez besoin d'aide, vous pouvez accéder aux fichiers d'aide R de deux manières:

• En tapant aide (…) avec le nom de la fonction à l'intérieur des parenthèses. Par exemple, taper help (coller) renvoie de l'aide sur la fonction paste ().

• En tapant ? suivi du nom de la fonction. Par exemple, en tapant ? paste renvoie de l'aide sur la fonction paste ().

Généralement, les fichiers d'aide de R suivent un schéma assez standard. Vous trouverez la plupart des sections suivantes dans chaque fichier d'aide R:

• Titre: Un aperçu de la fonction en une phrase.

• Description: Introduction aux objectifs de haut niveau de la fonction, généralement d'environ un paragraphe.

• Utilisation: Une description de la syntaxe de la fonction (en d'autres termes, comment la fonction est appelée). C'est là que vous trouvez tous les arguments que vous pouvez fournir à la fonction, ainsi que toutes les valeurs par défaut de ces arguments.

• Arguments: Une description de chaque argument. Généralement, cela inclut une spécification de la classe (par exemple, caractère, numérique, liste, etc.). Cette section est importante à comprendre, car les arguments sont fréquemment la cause d'erreurs dans R.

• Détails: Des détails supplémentaires sur le fonctionnement de la fonction, des descriptions plus détaillées des différentes manières d'appeler la fonction (le cas échéant) et une discussion plus longue des arguments.

• Valeur: Une description de la classe de la valeur retournée par la fonction.

• Voir aussi: Liens vers d'autres fonctions pertinentes. Dans la plupart des éditeurs R, vous pouvez cliquer sur ces liens pour lire les fichiers d'aide de ces fonctions.

• Exemples: Exemples de code R réel que vous pouvez coller dans votre console et exécuter.

Lorsque vous ne savez pas exactement ce dont vous avez besoin

Peut-être connaissez-vous le nom de la fonction, mais vous ne vous souvenez pas si elle est épelée en minuscules ou en majuscules. Dans ces situations, recherchez les fichiers d'aide R.

Vous pouvez rechercher les fichiers d'aide R en tapant aide. recherche (…) avec un terme de recherche entre guillemets. Cela donne une liste de fonctions similaires au terme de recherche. c'est utile si vous ne pouvez pas vous souvenir du nom exact d'une fonction. Par exemple, en tapant aide. search ("date") dans la console renvoie une longue liste de correspondances possibles, y compris le format.Date, as. POSIXlt, et DateTimeClasses, entre autres.

La saisie de deux points d'interrogation suivis du terme de recherche est un raccourci pour obtenir de l'aide. chercher(). Par exemple, en tapant ? ? date renvoie la même liste de fonctions que l'aide . recherche ("date") fait.

Lorsque vous recherchez R help, vous obtenez une liste de rubriques correspondant au terme recherché. Vous pouvez obtenir le résultat suivant en tapant ? ? date :

ada:: mise à jour. ada Ajouter des arbres à un objet ada chron:: chron Créer un objet chronologique chron:: couper. dates Créer un facteur à partir d'un objet Chron ou Dates chron:: dates Générer des dates et des heures Composants à partir de l'entrée … base:: Date Date Classe de base:: DateTimeClasses Date-Time Classes base:: diff Différences décalées …

La main gauche La colonne contient les fonctions qui correspondent à votre terme de recherche et la colonne de droite contient le titre du fichier d'aide R pour cette fonction. Chaque fonction est composée de deux éléments séparés par deux deux-points. Cela signifie que dans le paquet ada, il y a une fonction appelée update. ada ().

Dans la description de ada:: update, il est évident que cette fonction n'a rien à voir avec les dates. Néanmoins, il a été inclus dans les résultats de la recherche car le nom de la fonction contenait la date de la sous-chaîne. Si vous faites défiler la liste, vous trouverez également des références à plusieurs fonctions de date dans le package de base, notamment Date (), DateTimeClasses () et diff ().

Après avoir identifié une fonction utile, tapez ? functionName pour ouvrir la page d'aide correspondante.