Document computationnels

Etudes discutées

Pourquoi est-ce difficile ?

Le cahier de labo peut nous aider

Doc computationnel

Rstudio

  • Partage de doc: Knit et publish permet de l’envoyer sur les serveurs pou être accéder par les autres en html.

Prise en main de l’outil Rstudio:

  • Problème de connexion ssh: Rstudio fait la liaison tout seul à parti du moment ou la clefs ssh se trouve ur mon profil gitlab. Problème au moment d’appliquer la commande

ssh -T git@app-learninglab.inria.fr

Le port n’étant pas le port ssh par défaut (22), il fallait en faite taper: ssh -T git@app-learninglab.inria.fr -p 9418

Travailler à plusieurs

  • Rpubs outil idéal pour partager rapidement mais pas pérenne
  • Gitlab/Github => Prendre en compte le fait que tout (commentaires aux reviewers etc…) sera public.
  • Site compagnion Runmycode, Editeurs….
  • Archive ouvertes: HAL, Figshare/zenodo

Comparaison des outils:

  • Pour les cours ou tuto: Jupyter

  • Journal de bord: orgmode: organisation chronologique + tags intensif !!!

  • Cahier de labo => Idem mais orga sémantique avec des sections: analyses, scripts …. puis orga chonologique.

  • Article reproductible: orgmode

  • Navigation limitée avec jupyter et rstudio/knitr mais puissante avec orgmode

  • Article faisable en Rstudio et orgmode mais plus compliqué en Jupyter

Exemple de structure:

Intro

Results / biblio

Devlopment, méthodo

Biblio

Journal

conclu

week 1

week 2

work done

questions

work planned