Comment fournir la bonne information dans un r exemple reproductible minimale

Une des parties les plus difficiles de la production d'un exemple reproductible minimale R est de garder un minimum. Un autre est en vous assurant que vous fournissez les informations nécessaires afin que votre problème est en effet reproductible.

Sommaire

Keep it minimale

Le défi consiste à identifier le plus petit exemple (les moins de lignes de code) qui reproduit le problème ou d'erreur. Avant de soumettre votre code, assurez-vous de décrire clairement les paquetages que vous utilisez. En d'autres termes, pensez à inclure le bibliothèque () déclarations.

Aussi, tester votre code dans un nouveau vide session, R pour assurer qu'il fonctionne sans erreur. Les gens devraient être en mesure de simplement copier et coller vos données et votre code dans la console et obtenir exactement les mêmes résultats que vous obtenez.

Fournir les informations nécessaires




Y compris un peu d'informations sur votre environnement de R aide les gens à répondre à vos questions. Vous devriez envisager de fournir ce qui suit:

  • Votre version R (par exemple, R 2.13-1)

  • Votre système d'exploitation (par exemple, Windows 7 64-bit)

La fonction sessionInfo () Affiche des informations sur votre version de R et certaines informations de localisation, ainsi que des forfaits attachés ou chargés. Parfois, la sortie de cette fonction peut vous aider à déterminer si il ya des conflits entre vos colis chargés. Voici un exemple des résultats de sessionInfo ():

> SessionInfo () version R 2.14.1 (2011-12-22) Plate-forme: x86_64-pc-mingw32 / x64 (64 bits) locale: [1] LC_COLLATE = English_United Kingdom.1252 [2] LC_CTYPE = English_United Kingdom.1252 [3] = LC_MONETARY English_United Kingdom.1252 [4] LC_NUMERIC = C [5] LC_TIME = paquets de base English_United Kingdom.1252attached: [1] Statistiques graphiques grDevices utils ensembles de données [6] méthodes baseother attachés colis: [1] rj_1.0.2- 5 devtools_0.5.1loaded via un espace de noms (et non jointe): [1] RCurl_1.6-10.1 tools_2.14.1

Les résultats vous dire que cette session est en cours d'exécution R Version 2.14 sur Windows 64 bits, avec un Royaume-Uni locale. Vous pouvez aussi voir que R a chargé deux colis: rj (version 1.0.2-5) et le paquet devtools (version 0.5.1).

Parfois, il est utile d'inclure les résultats de sessionInfo () dans votre question, parce que d'autres utilisateurs peuvent alors R dire si il pourrait y avoir un problème avec votre installation de R.


» » » » Comment fournir la bonne information dans un r exemple reproductible minimale