Conseils pour l'écriture d'un rapport de TP (et pas que ...)

Écrit à l’origine pour m’éviter de répéter constamment les mêmes conseils à mes étudiants, ce manuel a connu une diffusion assez large.
Umberto Eco - Comment écrire sa thèse (1977)

  1. Le Contexte
  2. Le Mantra puis le modèle entrée/ plat/ dessert/ digestif
  3. La Moralité

Contexte

Initialement écrit pour les TP de CSOPT (Datasim), on se rend compte que ça sert à tout le monde.

Ce n’est pas pour être embêtant mais pour vous préparer à l’écriture de vos rapports de stage, vos projets biblios, … que vous continuiez en thèse ou dans le monde de l’entreprise et vous montrer l’importance du contexte dans les écrits que vous produirez pour vos supérieurs, clients, mamans et papas de thèses … (dixit Gwen).


Mantra

Le « Mantra » principal est

On doit pouvoir lire un rapport sans avoir à se référer au sujet.

Pour faire simple : **Pour chaque question, faire:**

Entrée, l’intro :

Une phrase de contexte où vous dites ce que vous allez faire, prouver, montrer, … On évite au maximum de faire appel au numéro des questions dans le sujet afin d’être cohérent avec le mantra ie. on évite:

1.a: la réponse est ...
...
2.f: on trouve x=9
...
42.z: ça converge.  

Plat, le développement :

  • Si question mathématique : de la rigueur ie. hypothèses (ou l’endroit d’où vous partez) , résultats de cours utilisés, étapes de calculs (pas besoin de tout mettre si les opérations sont triviales), …

Pensez au LaTeX pour la rédaction de vos documents avec un éditeur type Overleaf si vous rendez un CR à plusieurs.

  • Si tableau synthèse : Tout est dans le titre de cette section, c’est censé être une synthèse … ne pas hésiter à mettre en valeur (avec du gras ou de la couleur) les résultats que vous jugez utiles, pertinents. Par exemple, le code LaTeX:
\begin{table}[H]
\centering
\begin{tabular}{c|c|c|c|}
\cline{2-4}
\textbf{} & \textbf{Méthode 1} & \textbf{Methode 2} & \textbf{Méthode 3} \\ \hline
\multicolumn{1}{|c|}{\textbf{$\hat{x}$}} & $(.,.)^{\intercal}$ & $(.,.)^{\intercal}$ & $(.,.)^{\intercal}$ \\ \hline
\multicolumn{1}{|c|}{\textbf{$\hat{z} := f(\hat{x})$}} & 0 & \textcolor{blue}{$\infty$} & $\ln (3)$ \\ \hline
\multicolumn{1}{|c|}{Nb d'itérations} & $666$ & $24$ & $\begingroup \color{red}{4} \endgroup 2$ \\ \hline
\multicolumn{1}{|c|}{Nature de $\hat{x}$} & \textcolor{magenta}{$\min$ local} & $\max$ local & point col \\ \hline
\end{tabular}
\caption{Données obtenues avec $x_{0} = (\dots)^{\intercal} \in \mathbb{R}^{n}$ avec $\rho = \dots$ et un nombre d'itération maximal $\text{iter}_{\max} = \dots$ }
\label{tab:dummy_tab}
\end{table}

permet d’obtenir le tableau suivant:

Exemple d’un joli tableau

Et on discute les résultats obtenus ;).

Tip pour se simplifier la vie avec les tableaux latex: Créez vos tableaux dans un tableur et mettez en forme avec Table generator

  • Si on vous demande de tracer un truc :

Protocole de la jolie figure (en Matlab, mais généralisable à d’autres langages ):

figure ; hold on ; 
[box on ; grid on] ; // […] signifie optionnel.  
// Vos données à tracer (les couleurs sont importantes, 
// on doit voir directement ce que vous souhaitez montrer, 
// donc on va dans la doc de la fonction plot())
xlabel(‘’) ; ylabel(‘’) ; title(‘’) ; 
// et sgtitle(‘’) si vous avez décidé de faire des subplot() cf la doc.
legend(‘’) ; // idem, regardez la doc.

Tips pour des figures propres :

  • allez voir dans les docs le ‘Interpreter’,’latex’
  • gagnez du temps dans la création de la légende avec matlab :
p1 = plot(…,‘Displayname’, "bla") ;
p2 = plot(…,‘Displayname’, "blo") ;
// [...]
legend([p1,p2],…) ;  

Un exemple de jolie figure - Cours de B.Pascal Datasim/CSOPT

Pour les curieux, le cours de B.Pascal Nonsmooth convex optimization.

Exemple d’une jolie figure : Prox de la norme $\ell_{1}$ Le code Matlab correspondant (possible de faire la même chose avec Python ou Julia):

x = linspace(-10,10,1000);
figure; 
  sgtitle("$\ell_{1}$ norm",'Interpreter','latex','FontSize',20)
  subplot(1,2,1)
    hold on; box on; grid minor;
    plot(x,abs(x),'b','LineWidth',2);
    yline(0,'k--'); xline(0,'k--');
    ylim([-1,max(x)]);
    xlabel('$x$','Interpreter','latex','FontSize',12); 
    ylabel('$y$','Interpreter','latex','Rotation',0,'FontSize',12);    
    title("$f:x \mapsto |x|$",'Interpreter','latex','FontSize',16);
  subplot(1,2,2)
    hold on; box on; grid minor; 
    gamma = 1;  p = prox_l1(x,gamma);
    p1 = plot(x,p,'-','LineWidth',2,'Displayname',"$\gamma="+num2str(gamma)+"$",'Color','#7E2F8E');
    gamma = 2;  p = prox_l1(x,gamma);
    p2 = plot(x,p,'--','LineWidth',2,'Displayname',"$\gamma="+num2str(gamma)+"$",'Color','#EDB120');
    gamma = 3.5;  p = prox_l1(x,gamma);
    p3 = plot(x,p,':','LineWidth',2,'Displayname',"$\gamma="+num2str(gamma)+"$",'Color','#A2142F');
    yline(0,'k--'); xline(0,'k--');
    xlabel('$x$','Interpreter','latex','FontSize',12);
    ylabel('$y$','Interpreter','latex','Rotation',0,'FontSize',12);
    title("prox$_{\gamma \|\cdot\|_{1}}(x)$",'Interpreter','latex','FontSize',16)
    legend([p1,p2,p3],'Location','best','FontSize',16,'Interpreter','latex'); legend boxoff

Un peu d’auto-promo:

On peut faire de chouettes figures et animations avec Matlab:

  • un exemple avec le code Ariane pour le calcul de la matrice système en imagerie Compton:

    Ariane dans le plan Ariane dans l’espace
  • un exemple d’application d’une méthode Monte Carlo pour l’approximation de $\pi$ par Pluie aléatoire (cf. Maths EI1/TP5):

Dessert, la conclusion :

bon bah là, discutez la figure obtenue ou donnez le résultat mathématique obtenu, bref discutez et soyez critiques vis-à-vis de ce que vous présentez.

Le digestif, les remarques générales:

Si on file la métaphore du restaurant :

  • Le menu: c’est l’introduction générale du TP, ce que l’on va étudier dans ce rapport de TP. Même si cela suppose faire des paraphrases du sujet, c’est toujours bien de faire comprendre au lecteur/correcteur/rapporteur l’endroit d’où il part et à quelle sauce il va être mangé.
  • L’addition: c’est la conclusion générale du TP ; il faut donner les grandes lignes de l’étude qui a été réalisée durant le rapport, les idées et les conclusions. Pas besoin de trop de blabla si vous avez été efficaces dans les desserts de chaque question.

Moralité:

Moralité, maintenant que vous avez tout ça, nous serons intraitables sur les rapports que nous allons corriger et si vous avez des questions, n’hésitez pas à envoyer un mail

Mehdi LATIF
Mehdi LATIF
Doctorant - Algorithmique et Traitement du signal.

$\lambda$

Sur le même sujet