From f8bddda10601497fefe22e138305769ffe20877c Mon Sep 17 00:00:00 2001 From: 3a8a08e9391701ee31513ee7080f15a0 <3a8a08e9391701ee31513ee7080f15a0@app-learninglab.inria.fr> Date: Wed, 8 Jun 2022 11:22:53 +0000 Subject: [PATCH] Update Markdown.md --- journal/Markdown.md | 75 ++++++++++++++++++++++++++++++++++++++------- 1 file changed, 64 insertions(+), 11 deletions(-) diff --git a/journal/Markdown.md b/journal/Markdown.md index bb913cd..b6c1a09 100644 --- a/journal/Markdown.md +++ b/journal/Markdown.md @@ -1,9 +1,8 @@ -# Journal de bord +**Journal de bord** -## 1 Notes pour écrire sur gitlab +# 1 Notes pour écrire sur gitlab - -_italique_ ou "italique", __gras__ ou ""gras"", 'chasse fixeé', --barré--, +_italique_ ou *italique*, __gras__ ou **gras**, un hyperlien : [Google Footbal](https://www.google.com/search?client=firefox-b-d&q=footbal) @@ -85,11 +84,65 @@ Symbole Commande \(\ddot{a}\) $\ddot{a}$ \(\overrightarrow{AB}\) $\overrightarrow{AB}$ -## Réponses aux exercices - - Quel est le numéro du commit ? -505c4e26 - correct - -Quel est l'auteur du commit ? -Arnaud Legrand - correct +# 2 Carnet de bord et réponses pertinantes aux exercices + +## Module 1 + +_Qu’est-ce qu’un fichier texte ?_ +Un fichier dont le contenu est fait de caractères UTF-8 + +_Un document computationnel permet de :_ +- Améliorer la traçabilité d’un calcul +- Présenter facilement ses travaux à des collègues +- Accéder à l’ensemble des calculs sous-jacents à une analyse + +_Dans les études que nous vous avons présentées, qu'est-ce qui empêche, parfois pendant plusieurs années, le débat sur la pertinence d’une étude ?_ +- La non publication des procédures de calcul +- La non publication des données utilisées + +_Dans les différents exemples présentés (économie, IRM, cristallographie), quelles sont les principales causes d’erreurs ?_ +- Acquisition des données (biais, calibrage de la machine, etc.) +- Erreurs de calcul +- Traitements de données ou statistiques inadaptés + +_Quelles sont les conséquences du manque de transparence ?_ +- Il est difficile de s’appuyer sur le travail des autres +- Les articles contiennent moins d'information (pas de détails sur les calculs, protocoles expérimentaux, analyse de données, etc.) et sont donc plus faciles à lire +- Il est difficile de vérifier et de reproduire les analyses présentées dans les articles +- Deux articles peuvent présenter des résultats en contradiction apparente les uns avec les autres, tout en étant tous deux parfaitement corrects, le manque de détails empêchant de déterminer les conditions exactes d'application + +_Quelles sont les causes techniques principales derrière les difficultés à reproduire les travaux de quelqu’un d’autre ?_ +- Le manque de documentation sur les choix effectués +- Les logiciels graphiques interactifs qui masquent les détails du calcul +- Les erreurs de calcul +- La perte de données (pas de backup ou bien format plus lisible) + +_Quelles solutions sont évoquées ?_ +- Le cahier de laboratoire +- La revue de code et l’intégration continue +- L’utilisation de gestionnaire de version et de plusieurs mécanismes de sauvegardes automatique + +_Que trouve-t-on généralement dans un document computationnel ?_ +- Des commentaires +- Du code +- Un aperçu des données +- Les résultats de calculs +- Des liens hypertextes +- Des images + +_Que permet un document computationnel ?_ +- Inspecter les calculs +- Réexécuter facilement les calculs si l'environnement d'origine est disponible +- Documenter le code +- Expliquer pourquoi tel ou tel calcul est effectué en fonction des données analysées +- Faire des tests de non régression systématiques +- Utiliser plusieurs langages pour faire des calculs (même si cela peut demander un peu de travail) + +_Qu’est-ce qu’un environnement comme Jupyter apporte par rapport à travailler dans la console Python ou bien exécuter directement des scripts R ?_ +- Il permet d'avoir un historique bien structuré des analyses effectuées . +- Il permet d’inspecter les données, de garder une trace de cette inspection, et d’expliquer au fur et à mesure les transformations que l’on effectue . +- Il sauvegarde les résultats intermédiaires, qu’ils soient textuels ou graphiques . +- Il intègre une intelligence artificielle qui rédige les articles pour vous et corrige votre code . +- Il vous permet de générer des documents au format HTML ou PDF . +- Il permet de s’assurer que la figure obtenue est bien le résultat du calcul décrit dans le document . -- 2.18.1