Lorsqu’on est débutant, on ne sait pas toujours comment obtenir de l’aide avec le logiciel R. D’autant plus que l’on peut  avoir besoin d’aide pour différentes raisons. Par exemple, pour connaître les arguments d’une fonction (les éléments dont elle a besoin), ou pour avoir des précisions sur son fonctionnement (par exemple sur les méthodes de calcul employées), ou encore pour résoudre un message d’erreur.Dans cet article, je vais vous montrer comment obtenir de l’aide dans une grande majorité de situations. 

1. Utilisez la saisie semi-automatique

R Studio propose une saisie semi-automatique du nom des fonctions, accompagné de l’affichage d’une brève description de leurs arguments.   Pour l’obtenir il suffit d’écrire les 3 premières lettres de la fonction et d’appuyer sur la touche TAB. Il est également possible d’obtenir ces informations automatiquement, sans avoir recours à la touche TAB. Pour cela allez dans le menu “Tools” puis “Global options…”, puis dans la partie “Code” et l’onglet “Completion”.Choisissez “ Show Code Completion : automatically”, puis “Apply” et “OK”.   

2. Consultez l’aide intégrée

Comme indiqué en bas de la brève description des arguments de la fonction, l’aide intégrée complète peut être affichée (dans la fenêtre en bas à droite), en sélectionnant le nom d’une fonction avec la souris, et appuyant sur la touche F1. Dans cette aide complète vous trouverez :

• une description de l’ensemble des arguments de la fonction considérée,
• une description de tous les éléments de sortie de la fonction (par exemple, pour le test de Shapiro Wilk : les données considérées, la statistique du test, la p-value),
• des informations sur les méthodes ou algorithmes employés,
• des références bibliographiques,
• et un exemple de commandes, que vous pouvez copier-coller dans la console.

Cette aide peut également s’obtenir avec la  commande suivante dans la console: ? nom_de_la_fonction.

 

3. Utilisez la fonction apropos(“mot_clé”)

Lorsque vous utilisez R, il peut arriver que vous ayez besoin de réaliser une tâche (par exemple calculer la somme cumulée de plusieurs nombres), mais que vous ne connaissiez pas de fonctions susceptibles de le faire. Dans ce cas, il est possible d’obtenir la liste de toutes les fonctions disponibles (cad appartenant à des packages préalablement chargés dans la session), et  contenant un mot clé spécifique (en anglais). Pour cela, utilisez la commande apropos(“mot_clé”).Dans notre exemple du calcul d’une somme cumulée, en utilisant la commande apropos(“sum”) on obtient la liste de toutes les fonctions contenant ce mot clé. Dans cette liste se trouve la fonction “cumsum” qui, a priori, pourrait correspondre à la fonction recherchée. Il suffit alors d’utiliser la commande ?cumsum pour obtenir l’aide complète de cette fonction, dans la fenêtre en bas à droite, comme expliqué plus haut. 

4. Faites des requêtes sur Google et Stack Overflow

Il peut également arriver que la fonction que vous souhaitez utiliser vous renvoit un message d’erreur. Si après avoir consulté l’aide intégrée de cette fonction, vous ne parvenez pas à résoudre l’erreur, alors Google est votre ami !Copiez collez le message d’erreur dans Google et remonter la piste ! Il est très probable que les premiers liens vous renvoient vers le site de Stack Overflow . Il s’agit d’un site sur lequel des utilisateurs du monde entier posent et/ ou répondent à des questions techniques de programmation. De nombreux langages sont concernés, dont R. C’est actuellement le meilleur site pour trouver des réponses concrètes à vos problèmes de programmation avec le logiciel R. Vous pouvez donc aussi copier coller directement le message dans Stack Overflow.Vous pouvez également utiliser Stack Overflow pour trouver comment faire une tâche précise. Pour cela interroger le site en utilisant des mots clés et en utilisant le tag [r] pour filtrer les réponses qui concernent spécifiquement le logiciel R. 

5. Posez votre question sur Stack Overflow

Si les requêtes ne vous apportent pas de solution, alors lancez vous et posez votre question à la communauté.Cela nécessite d’avoir un compte sur le site, mais l’inscription est rapide et gratuite.  Pour maximiser vos chance d’obtenir des réponses, il est recommandé de :

• décrire le but final de ce que vous souhaitez faire,
• d’être concis tout en donnant l’ensemble des informations nécessaires,
• d’être courtois
• de soumettre un exemple reproductible (vous pouvez simplifier à l’extrême vos données, mais fournissez les lignes de commandes permettant de le générer)

Pour plus de détails, consultez la section “Asking” du Help Center de Stack Overflow.  

6. Utilisez les “Special Interest Group” (SIG) du logiciel R

Si vous recherchez de l’aide dans un domaine d’application bien précis, les Special Interest Group peuvent être une aide précieuse. Il s’agit de mailing lists, dont vous pouvez consulter les archives, et sur lesquelles vous pouvez posez vos questions.Il existe actuellement une vingtaine de SIG

• R-SIG-Mac: R Special Interest Group on Mac ports of R
• R-SIG-DB: R SIG on Database Interfaces
• R-SIG-Debian: R Special Interest Group for Debian ports of R
• R-SIG-dynamic-models: Special Interest Group for Dynamic Simulation Models in R
• R-SIG-ecology: Using R in ecological data analysis
• R-SIG-Epi: R for epidemiological data analysis
• R-SIG-Fedora: R Special Interest Group for Fedora and Redhat ports of R
• R-SIG-Finance: Special Interest Group for ‘R in Finance’
• R-SIG-Geo: R Special Interest Group on using Geographical data and Mapping
• R-SIG-gR: R SIG on gRaphical models
• R-SIG-GUI: R Special Interest Group on GUI Development
• R-SIG-HPC: R SIG on High-Performance Computing
• R-SIG-Insurance: Special Interest Group on using R in actuarial science and insurance
• R-SIG-Jobs: R SIG List for Announcements of Jobs where R is used
• R-SIG-mediawiki: R SIG on the R Extension for Mediawiki
• R-SIG-meta-analysis: R SIG for discussing the use of R for conducting meta-analyses
• R-SIG-mixed-models: R SIG on Mixed Effect Models, notably lmer() related
• R-SIG-networks: R SIG for users and developers of network- or graph-related software within R
• R-SIG-phylo: R SIG on phylogenetic and comparative methods and analyses
• R-SIG-QA: R SIG on Quality Assurance & Validation
• R-SIG-Robust: R SIG on Robust Statistics
• R-SIG-teaching: SIG on Teaching Statistics (and more) using R

 

7. Utilisez Cross Validated pour toutes vos questions liées aux méthodologies statistiques

Si vous avez besoin d’aide sur une méthode statistique, plutôt que sur sa mise en application dans le logiciel R, alors utilisez le site Cross Validated. Il fonctionne sur le même principe que Stack Overflow.Et là encore, si vous ne trouvez pas de réponses à votre question dans les archives, posez la ! J’espère qu’avec cet article vous saurez à présent comment trouver efficacement de l’aide. Et vous, avez vous d’autres astuces pour trouver des réponses et dépasser vos difficultés lorsque vous utilisez le logiciel R ? Si cet article vous a plu, ou vous a été utile, et si vous le souhaitez, vous pouvez soutenir ce blog en faisant un don sur sa page Tipeee 🙏👉 Cliquez ici pour soutenir le blog Statistiques et Logiciel R   Crédits photos : GotCredit.