D.2 Contenu
Le rapport sert à restituer de façon synthétique les résultats d’une étude scientifique et les interprétations. Le tout est remis dans le contexte de la bibliographie existante en la synthétisant dans l’introduction et en comparant les résultats avec d’autres études connexes dans la discussion. Il faut garder à l’esprit qu’un lecteur doit comprendre l’intégralité du rapport avec un minimum de connaissances a priori sur l’étude réalisée, mais avec des connaissances générales dans la spécialité. Donc, un rapport sur un sujet biologique est adressé à un lecteur biologiste pour lequel il ne faut pas rappeler les concepts de base dans sa discipline. Par contre, il faut expliquer avec suffisamment de détails comment l’étude a été réalisée dans la section “matériel et méthodes”.
En général, les phrases sont simples, directes, courtes et précises (veillez à utiliser le vocabulaire adéquat et précis). Les explications sont, autant que possible, linéaires. Évitez les renvois dans différentes autres parties du rapport, si ce n’est pour rappeler un élément évoqué plus haut, ou pour se référer à une figure ou une table. À ce sujet, les figures (dont les images, photos, schémas et graphiques) sont numérotées (Figure 1, Figure 2, …) et accompagnées d’une légende en dessous d’elles. La figure et sa légende doivent être compréhensibles telles quelles. Dans le texte, vous pourrez alors vous référer à la figure, par exemple : “Tel phénomène est observable (voir Fig. 3)”, ou “La Figure 4 montre …”. idem pour les tableaux qui sont également numérotés (Table 1, Table 2, …) et légendés, mais au dessus du tableau. Les règles de lisibilité du tableau + légende et de renvoi vers les tableaux sont identiques que pour les figures. Les équations peuvent aussi être numérotées et des renvois de type (eq. 5) peuvent être alors utilisés. Enfin, toute affirmation doit être soit démontrée dans le rapport, soit complétée d’une citation vers un autre document scientifique qui la démontre. La partie bibliographie regroupe la liste de tous les documents qui sont ainsi cités à la fin du rapport.
Veillez à respecter les notations propres au système métrique international, les abréviations usuelles dans la discipline, et le droit d’auteur et les licences si vous voulez citer un passage ou reprendre une illustration provenant d’un autre auteur (sans omettre d’indiquer qui en est l’auteur). Enfin, en vue de rendre le document parfaitement reproductible, vous pouvez indiquer dans les annexes où trouver la source de votre rapport (le document .Rmd) et les données analysées. Vous pouvez également terminer avec un “chunk” qui renseigne de l’état du système R utilisé, y compris l’ensemble des packages employés. Ce chunk, présenté en annexe, contiendra l’instruction utils::sessionInfo(), ou mieux : sessioninfo::session_info(). Cela donnera quelque chose du genre :
─ Session info ───────────────────────────────────────────────────────────────
setting value
version R version 4.1.3 (2022-03-10)
os macOS Big Sur/Monterey 10.16
system x86_64, darwin17.0
ui X11
language (EN)
collate fr_FR.UTF-8
ctype fr_FR.UTF-8
tz Europe/Brussels
date 2024-03-19
pandoc 3.1.1 @ /Applications/RStudio.app/Contents/Resources/app/quarto/bin/tools/ (via rmarkdown)
─ Packages ───────────────────────────────────────────────────────────────────
package * version date (UTC) lib source
abind 1.4-5 2016-07-21 [1] CRAN (R 4.1.0)
anytime 0.3.9 2020-08-27 [1] CRAN (R 4.1.0)
assertthat 0.2.1 2019-03-21 [1] CRAN (R 4.1.0)
backports 1.4.1 2021-12-13 [1] CRAN (R 4.1.0)
base64enc 0.1-3 2015-07-28 [1] CRAN (R 4.1.0)
bit 4.0.4 2020-08-04 [1] CRAN (R 4.1.0)
bit64 4.0.5 2020-08-30 [1] CRAN (R 4.1.0)
bookdown 0.26 2022-04-15 [1] CRAN (R 4.1.2)
broom * 0.8.0 2022-04-13 [1] CRAN (R 4.1.2)
bslib 0.3.1 2021-10-06 [1] CRAN (R 4.1.0)
car 3.0-12 2021-11-06 [1] CRAN (R 4.1.0)
carData 3.0-5 2022-01-06 [1] CRAN (R 4.1.2)
chart * 1.4.0 2022-12-30 [1] Github (SciViews/chart@f5e354a)
checkmate 2.0.0 2020-02-06 [1] CRAN (R 4.1.0)
cli 3.2.0 2022-02-14 [1] CRAN (R 4.1.2)
cluster 2.1.3 2022-03-28 [1] CRAN (R 4.1.2)
codetools 0.2-18 2020-11-04 [2] CRAN (R 4.1.3)
collapse * 1.7.6 2022-02-11 [1] CRAN (R 4.1.2)
colorspace 2.0-3 2022-02-21 [1] CRAN (R 4.1.2)
cowplot 1.1.1 2020-12-30 [1] CRAN (R 4.1.0)
crayon 1.5.1 2022-03-26 [1] CRAN (R 4.1.2)
curl 4.3.2 2021-06-23 [1] CRAN (R 4.1.0)
data.io * 1.4.1 2022-12-30 [1] Github (SciViews/data.io@7e6e659)
data.table * 1.14.2 2021-09-27 [1] CRAN (R 4.1.0)
DBI 1.1.2 2021-12-20 [1] CRAN (R 4.1.0)
digest 0.6.29 2021-12-01 [1] CRAN (R 4.1.0)
dplyr * 1.0.8 2022-02-08 [1] CRAN (R 4.1.2)
dtplyr * 1.2.1 2022-01-19 [1] CRAN (R 4.1.2)
ellipse 0.4.2 2020-05-27 [1] CRAN (R 4.1.0)
ellipsis 0.3.2 2021-04-29 [1] CRAN (R 4.1.0)
evaluate 0.15 2022-02-18 [1] CRAN (R 4.1.2)
fansi 1.0.3 2022-03-24 [1] CRAN (R 4.1.2)
fastmap 1.1.0 2021-01-25 [1] CRAN (R 4.1.0)
forcats * 0.5.1 2021-01-27 [1] CRAN (R 4.1.0)
foreign 0.8-82 2022-01-16 [2] CRAN (R 4.1.3)
Formula 1.2-4 2020-10-16 [1] CRAN (R 4.1.0)
fs * 1.5.2 2021-12-08 [1] CRAN (R 4.1.0)
generics 0.1.2 2022-01-31 [1] CRAN (R 4.1.2)
getPass 0.2-2 2017-07-21 [1] CRAN (R 4.1.0)
ggplot2 * 3.3.5 2021-06-25 [1] CRAN (R 4.1.0)
ggplotify 0.1.0 2021-09-02 [1] CRAN (R 4.1.0)
ggpubr 0.4.0 2020-06-27 [1] CRAN (R 4.1.0)
ggsignif 0.6.3 2021-09-09 [1] CRAN (R 4.1.0)
glue 1.6.2 2022-02-24 [1] CRAN (R 4.1.2)
gridExtra 2.3 2017-09-09 [1] CRAN (R 4.1.0)
gridGraphics 0.5-1 2020-12-13 [1] CRAN (R 4.1.0)
gtable 0.3.0 2019-03-25 [1] CRAN (R 4.1.0)
Hmisc 4.7-0 2022-04-19 [1] CRAN (R 4.1.2)
hms 1.1.1 2021-09-26 [1] CRAN (R 4.1.0)
htmlTable 2.4.0 2022-01-04 [1] CRAN (R 4.1.2)
htmltools 0.5.2 2021-08-25 [1] CRAN (R 4.1.0)
htmlwidgets 1.5.4 2021-09-08 [1] CRAN (R 4.1.0)
httpuv 1.6.5 2022-01-05 [1] CRAN (R 4.1.2)
httr 1.4.2 2020-07-20 [1] CRAN (R 4.1.0)
igraph 1.3.1 2022-04-20 [1] CRAN (R 4.1.3)
jpeg 0.1-9 2021-07-24 [1] CRAN (R 4.1.0)
jquerylib 0.1.4 2021-04-26 [1] CRAN (R 4.1.0)
jsonlite 1.8.0 2022-02-22 [1] CRAN (R 4.1.2)
keyring 1.3.0 2021-11-29 [1] CRAN (R 4.1.0)
knitr 1.38 2022-03-25 [1] CRAN (R 4.1.2)
later 1.3.0 2021-08-18 [1] CRAN (R 4.1.0)
lattice * 0.20-45 2021-09-22 [1] CRAN (R 4.1.0)
latticeExtra 0.6-29 2019-12-19 [1] CRAN (R 4.1.0)
learnitdown 1.5.2 2022-12-30 [1] Github (SciViews/learnitdown@c3e5866)
learnr 0.11.0 2022-12-30 [1] Github (rstudio/learnr@8af781a)
lifecycle 1.0.1 2021-09-24 [1] CRAN (R 4.1.0)
lubridate 1.8.0 2021-10-07 [1] CRAN (R 4.1.0)
magick 2.7.3 2021-08-18 [1] CRAN (R 4.1.0)
magrittr 2.0.3 2022-03-30 [1] CRAN (R 4.1.2)
markdown 1.1 2019-08-07 [1] CRAN (R 4.1.0)
MASS * 7.3-56 2022-03-23 [1] CRAN (R 4.1.2)
Matrix 1.4-1 2022-03-23 [1] CRAN (R 4.1.2)
mime 0.12 2021-09-28 [1] CRAN (R 4.1.0)
mongolite 2.6.0 2022-04-11 [1] CRAN (R 4.1.2)
munsell 0.5.0 2018-06-12 [1] CRAN (R 4.1.0)
nanotime 0.3.6 2022-03-06 [1] CRAN (R 4.1.2)
nnet 7.3-17 2022-01-16 [2] CRAN (R 4.1.3)
pillar 1.7.0 2022-02-01 [1] CRAN (R 4.1.2)
pkgconfig 2.0.3 2019-09-22 [1] CRAN (R 4.1.0)
PKI 0.1-11 2022-03-16 [1] CRAN (R 4.1.2)
png 0.1-7 2013-12-03 [1] CRAN (R 4.1.0)
promises 1.2.0.1 2021-02-11 [1] CRAN (R 4.1.0)
proto 1.0.0 2016-10-29 [1] CRAN (R 4.1.0)
pryr 0.1.5 2021-07-26 [1] CRAN (R 4.1.0)
purrr 0.3.4 2020-04-17 [1] CRAN (R 4.1.0)
R6 2.5.1 2021-08-19 [1] CRAN (R 4.1.0)
RColorBrewer 1.1-3 2022-04-03 [1] CRAN (R 4.1.2)
Rcpp 1.0.8.3 2022-03-17 [1] CRAN (R 4.1.2)
RcppCCTZ 0.2.10 2021-12-15 [1] CRAN (R 4.1.0)
readr 2.1.2 2022-01-30 [1] CRAN (R 4.1.2)
remotes 2.4.2 2021-11-30 [1] CRAN (R 4.1.0)
rlang * 1.0.2 2022-03-04 [1] CRAN (R 4.1.2)
rmarkdown 2.13 2022-03-10 [1] CRAN (R 4.1.2)
rpart 4.1.16 2022-01-24 [1] CRAN (R 4.1.2)
rprojroot 2.0.3 2022-04-02 [1] CRAN (R 4.1.2)
rstatix 0.7.0 2021-02-13 [1] CRAN (R 4.1.0)
rstudioapi 0.13 2020-11-12 [1] CRAN (R 4.1.0)
sass 0.4.1 2022-03-23 [1] CRAN (R 4.1.2)
scales 1.2.0 2022-04-13 [1] CRAN (R 4.1.2)
SciViews * 1.5.0 2022-12-30 [1] Github (SciViews/SciViews@aa5dce1)
sessioninfo 1.2.2 2021-12-06 [1] CRAN (R 4.1.0)
shiny 1.7.1 2021-10-02 [1] CRAN (R 4.1.0)
shinylogs 0.2.1 2022-04-18 [1] CRAN (R 4.1.2)
shinytoastr 2.1.1 2016-06-06 [1] CRAN (R 4.1.0)
stringi 1.7.6 2021-11-29 [1] CRAN (R 4.1.0)
stringr 1.4.0 2019-02-10 [1] CRAN (R 4.1.0)
survival 3.3-1 2022-03-03 [1] CRAN (R 4.1.2)
svBase * 1.3.0 2023-05-05 [1] local
svFlow * 1.2.1 2022-12-30 [1] Github (SciViews/svFlow@b81a609)
svMisc * 1.3.1 2022-12-30 [1] Github (SciViews/svMisc@8cc4fe9)
tibble * 3.1.6 2021-11-07 [1] CRAN (R 4.1.0)
tidyr * 1.2.0 2022-02-01 [1] CRAN (R 4.1.2)
tidyselect 1.1.2 2022-02-21 [1] CRAN (R 4.1.2)
tsibble 1.1.1 2021-12-03 [1] CRAN (R 4.1.0)
tzdb 0.3.0 2022-03-28 [1] CRAN (R 4.1.2)
utf8 1.2.2 2021-07-24 [1] CRAN (R 4.1.0)
vctrs 0.4.1 2022-04-13 [1] CRAN (R 4.1.2)
viridis 0.6.2 2021-10-13 [1] CRAN (R 4.1.0)
viridisLite 0.4.0 2021-04-13 [1] CRAN (R 4.1.0)
webshot 0.5.3 2022-04-14 [1] CRAN (R 4.1.2)
withr 2.5.0 2022-03-03 [1] CRAN (R 4.1.2)
xfun 0.30 2022-03-02 [1] CRAN (R 4.1.2)
xtable 1.8-4 2019-04-21 [1] CRAN (R 4.1.0)
yaml 2.3.5 2022-02-21 [1] CRAN (R 4.1.2)
yulab.utils 0.0.4 2021-10-09 [1] CRAN (R 4.1.0)
zeallot 0.1.0 2018-01-28 [1] CRAN (R 4.1.0)
zoo 1.8-10 2022-04-15 [1] CRAN (R 4.1.2)
[1] /Users/phgrosjean/Library/R/x86_64/4.1/library
[2] /Library/Frameworks/R.framework/Versions/4.1/Resources/library
──────────────────────────────────────────────────────────────────────────────D.2.1 Table des matières
La table des matières est d’une importance capitale pour un long document (mais facultative pour un plus court rapport) afin de présenter la structure de votre œuvre aux lecteurs. Heureusement, il n’est pas nécessaire de l’écrire manuellement. La table des matières est générée automatiquement dans un rapport R Markdown. L’instruction à ajouter dans le préambule du document R Notebook afin d’obtenir une table des matières est toc: yes (ne l’encodez pas directement, mais sélectionnez l’option Include table of contents dans les options de formatage du document accessibles à partir du bouton engrenage à droite de Preview ou Knit -> Output Options...). Lorsque vous fermerez cette boite de dialogue de configuration, l’entrée ad hoc sera ajoutée pour vous dans le préambule.
Vous pouvez aussi choisir de numéroter vos titres automatiquement. L’instruction à ajouter en plus de toc: yes dans le préambule du document R Notebook afin d’obtenir une table des matières avec des titres numérotés est number_sections: yes. Encore une fois, passez par la boite de dialogue de configuration, et cochez-y l’entrée Number section headings.
Voyez l’animation ci-dessous pour accéder à la boite de dialogue de configuration du document R Markdown/R Notebook.
D.2.2 Introduction
L’introduction d’un travail scientifique a pour principal objectif de replacer l’étude scientifique réalisée dans son contexte. La règle la plus importante est qu’un lecteur n’ayant jamais entendu parler de cette étude doit comprendre l’intégralité du rapport. L’introduction doit donc permettre de :
- Remettre l’expérience dans son contexte,
- Décrire l’organisme étudié : caractéristiques générales de l’organisme, distribution géographique, biotope…
Notez que l’ajout d’images ou d’une carte de distribution est un plus dans l’introduction.
D.2.3 But
Le but permet de synthétiser la question posée en fonction du contexte de l’expérience expliqué dans l’introduction. Il s’agit donc généralement d’un seul paragraphe court.
D.2.4 Matériel & méthodes
La section matériel & méthodes permet de décrire les aspects techniques de l’étude comme le matériel employé et les méthodes mises en œuvre (protocoles des manipulations et des mesures effectuées) afin d’acquérir les données. Cette section est également le lieu de description des techniques statistiques utilisées pour analyser les données, des programmes informatiques employés (pensez toujours à citer un logiciel en indiquant son no et son numéro de version ainsi qu’un lien vers où le trouver), …
D.2.5 Résultats
Les résultats vont généralement contenir deux parties :
- La description des données, via l’exploration des données récoltées (avec graphiques et/ou estimateurs statistiques)
- L’application des outils statistiques pertinents pour répondre à la question posée
D.2.6 Discussion
Cette section comprend l’interprétation biologique des résultats et la remise dans un contexte plus général, notamment en les comparant à des observations connexes réalisées par d’autres auteurs scientifiques. Il est crucial d’avoir un regard critique sur les résultats obtenus. Cette mise en contexte aide en ce sens.
D.2.7 Conclusion(s)
La section conclusion(s) (et perspectives) va résumer les principales implications à retenir de notre étude et, éventuellement, proposer des perspectives afin de poursuivre la recherche dans cette thématique.
D.2.8 Bibliographie (ou références)
La rédaction de travaux s’appuie toujours sur une recherche bibliographique au préalable. Il faut documenter convenablement les sources bibliographiques au sein de cette section afin d’éviter le plagiat volontaire ou involontaire. Une multitude de programmes existent pour faciliter la gestion de votre base de données bibliographique comme Mendeley, Zotero ou encore Endnote.
- Pour générer correctement ses références bibliographiques dans un document R Markdown/R Notebook, consulter ceci. Il s’agit d’un manuel en anglais de RStudio qui explique comment encoder sa bibliographie et comment la citer dans le texte à l’aide de balises Markdown spécifiques.