Comment r ediger un rapport de projet

A lintention des etudiants du LPM

Yuri L. de Meneses, F. Bourgeois

yuri@ieee.org,fabien.bourgeois@epfl.ch

15 novembre 2004
Il est certains esprits dont les sombres pens ees Sont dun nuage epais toujours embarrass es Le jour de la raison ne le sauroit percer Avant donc que d ecrire apprenez a ` penser Selon que notre id ee est plus ou moins obscure Lexpression la suit ou moins nette ou plus pure Ce que lon con coit bien s enonce clairement Et les mots pour le dire arrivent ais ement. Boileau, LArt po etique

Avant-propos
Ceci nest pas un document ni et mort, mais plut ot un processus vivant et evolutif, qui peut senrichir des nos exp eriences ult erieures et aussi des v otres. Nh esitez pas a ` nous contacter ; nous acceptons volontiers vos remarques et vos propositions dam eliorations.

Quest-ce quun rapport ?

Le rapport nest pas un journal de votre travail. Cela signie qu` a une description chronologique de votre travail, vous pr ef ererez une synth` ese th ematique de votre contribution au projet. Demandez-vous quel est le public cible de votre rapport. Le plus souvent, cest un etudiant comme vous, qui va continuer. Demandez-vous, quest-ce que je savais sur le sujet au d ebut ? et quelles sont les informations dont il faut disposer pour continuer le projet ?, et noubliez pas que votre professeur et quelques assistants vont le lire... Gardez en t ete lobjectif dint eresser le potentiel lecteur a ` votre projet. Votre rapport sera constitu e de la (des) r eponse(s) amen ees par votre travail au projet, basiquement constitu es d el ements th eoriques r ef erenc es, de r esultats si possible repr esent es graphiquement et interpr et es. Ces r eponses sont des informations scientiques, essentiellement quantitatives (limiter les informations qualitatives), exprim ees en des termes scientiques. Exprim e brutalement : vous n ecrivez ni un article dans un quotidien, ni un roman, ni une lettre a ` vos parents. La plupart des ing enieurs ont une m emoire tr` es visuelle, utilisez-le en compl etant votre texte de sch emas et graphiques, bien plus explicites que des textes, f ussent-ils soigneusement r edig es.

Les el ements dun rapport

Les rapports nont pas une structure d enie, a ` lexception de certains el ements impos es administrativement (page de garde, enonc e, r esum e). Cependant, tous les rapports de projet ont a ` peu pr` es les m emes el ements que nous d ecrirons de fa con plus d etaill e par la suite.

Les el ements typiques dun rapport sont les suivants : 1. Page de garde (sec.2.1) 2. Enonc e (sec. 2.2) 3. R esum e (sec. 2.3) 4. Table de mati` eres (sec. 2.4) 5. Introduction (sec. 2.5) 6. Etat de lart (sec. 2.6) 7. Th eorie (sec. 2.7) 8. Exp eriences (sec. 2.8) 9. Conclusions (sec. 2.9) 10. Bibliographie (sec. 3) 11. Annexes (sec. 2.11) Nous vous demandons de faire un travail de synth` ese. Ainsi, dans le Groupe Vision, les sections de lintroduction a ` la conclusion occuperont un maximum de 16 pages. Pensez a ` d eplacer a ` lannexe le contenu qui nest pas essentiel a ` la comprension g en erale du projet (ex : les longs calculs, instructions de dutilisation). Nous vous sugg` erons de commencer par ecrire un rapport etendu sans vous soucier de lext ension et ensuite l elaguer et d eplacer dans les annexes les informations moins essentielles. Les m emes el ements gureront dans la version papier et dans la version PDF qui vous sera demand ee. La version PDF doit etre une copie conforme de la version papier, a ` votre signature pr` es !

2.1

Page de garde

La page de garde doit contenir les informations suivantes : 1. Titre : Le titre est en principe d eni par lassistant ou le professeur. Dans certains cas, il est souhaitable de modier le titre pour mieux mettre en evidence un aspect particulier du projet. Discutez toute modication du titre avec vos superviseurs. 2. Auteur 3. Professeur 4. Assistant(s) 5. Laboratoire daccueil 6. Logo de lEPFL : Les r` egles dutilisation et de reproduction du logo de lEPFL pr econisent quil soit plac e en haut a ` droite de la page. Le logo de base est de 55 mm de large sur 26 mm de haut.
A En utilisant la feuille de style L TEX rapport etudiant.sty que nous proposons dans le Groupe Vision, vous ne devrez pas vous soucier de laspect graphique (mise en page) de la page de garde ni du reste du rapport. Cette feuille fait partie de linstallation chez nous, mais pour votre installation maison vous pouvez la trouver a ` http ://lpmvision.epfl.ch/intranet/ students/latex styles/.

2.2

Enonc e

L enonc e est une description sommaire des objectifs du projet que lassistant et le professeur r edigent au d ebut de votre projet. Cest un document administratif et il suivra le format d eni par chaque laboratoire. Vous placerez l enonc e en d ebut du rapport, apr` es la page de garde, pour permettre aux lecteurs du rapport de juger si les objectifs ont et e atteints et de la pertinence de la d emarche entreprise. 2

2.3

R esum e

Le r esum e fait la synth` ese du projet en une page au maximum. Par cons equent il devra contenir une br` eve description du probl` eme, des objectifs du projet (seulement ceux qui ont et e atteints), mentionneer les r esultats les plus importants et dresser une conclusion. Dans le r esume il faut surtout mettre en evidence les r esultats car ce sont eux qui rendre mieux compte de votre travail et donnent lenvie de lire votre rapport. Le r esum e est utilis e pour publier vos projets (brochures, pages web, etc.) et est souvent la premi` ere chose que le futur lecteur voit. Il faut donc l ecrire avec un langage et un ton agr eable, invitant a ` la lecture du reste du rapport, mais rigoureux et honn ete (il sagit dun travail ding enieur et non dun document publicitaire). Le format d eni par notre laboratoire exige que le r esum e contienne 2 images concernant le projet, le titre du projet, les noms de l etudiant, de lassistant(s) et du professeur. Il sera r edig e en deux colonnes. A Le style L TEX propos e se charge de la mise en forme.

2.4

Table de mati` eres

Si le rapport contient plus de 10 pages, il est convenable dy ajouter une table de mati` eres avec les titres des chapitres et des sections, ainsi que leur num ero de page. Tous les traitements de texte modernes, et on veut bien donner cet adjectif a ` MS Word, g en` erent la table de mati` eres automatiquement. Ne le faites pas manuellement, car vous pourriez oublier dy apporter les modications introduites a posteriori.

2.5

Introduction

Il nest pas n ecessaire que le premier chapitre du rapport sintitule Introduction, mais il contient toujours a ` peu pr` es les m emes informations. Lintroduction doit : D enir le probl` eme1 que le projet a essay e de r esoudre ainsi que le cadre dans lequel le probl` eme sinscrit. D enir les objectifs du probl` eme. Vous devez d ecrire de fa con plus d etaill ee et avec vos propres mots les objectifs qui apparaissent dans l enonc e. D ecrivez le probl` eme du point de vue de lutilisateur (courtement rapport e) pour ensuite le formaliser en des termes utiles du point de vue de celui qui doit le r esoudre. Cette formalisation est partie int egrante du projet, elle est m eme capitale ! Parfois le projet qui vous occupe fait partie dun plus grand projet du laboratoire (th` ese, projet europ een, projet industriel, etc.) Expliquez comment votre travail sins` ere dans le projet global. D enissez le cadre de votre travail. Quelles ont et e les contraintes impos es pour r ealiser le travail ? Quelle a et e la m ethodologie ou la philosophie choisie et suivie ? Et pourquoi ?

2.6

Etat de lart

Si votre probl` eme nest heureusement pas identique a ` dautres, il contient certaines similarit es. Quantit e de probl` emes ont et e r esolus par vos pr edecesseurs, du scientique de renom au simple ing enieur en passant par vos coll` egues etudiants : protez de leurs travaux ! Le titre de ce chapitre peut varier dun rapport a ` lautre. L etat de lart situe votre projet dans le contexte actuel de la technique et de la science. Ce chapitre nest pas r eserv e aux seuls projets de recherche. Si vous concevez un produit commercial vous devez etre tr` es conscients des produits similaires ou concurrents, des brevets existants, voir des echecs commerciaux pr ec edents.
1 Statement

of the problem.

2.6.1

Recherche bibliographique

Des outils de recherche sur internet orent dint eressantes possibilit es. Certains sont sp eciques a ` la recherche scientique, tels le Web of Knowledge, qui comporte le Web of Science (revues) et le Web of Proceedings (conf erences) (http ://isi6.isiknowledge.com/). Dautres sont plus g en eraux, comme Google. Mais les moteurs de recherche sur internet ne sont pas la seule source dinformation. Elle est souvent limit ee, parce que peu de travaux ant erieurs a ` 1995 y gurent. La Biblioth` eque Centrale (http ://library.epfl.ch) ore dexcellentes bases de donn ees (http ://library.epfl.ch/db/) comme WebSpirs (permet lacc` es simultan ea ` BIOSIS Previews, COMPENDEX, Derwent Biotechnology Abstracts, EconLit, Fluidex, GeoRef, Iconda, Information Science Abstracts, INIS, INSPEC, Medline, PASCAL, Philosophers Index, PolTox I, SIGLE, Transport, Wilson Art Abstracts ; le COMPENDEX couvre bien ling enieurie) ou Cambridge Scientic Abstract (avec en particulier Materials Science Collection : METADEX, Ceramic Abstracts, Engineered Materials Abstracts,...) et le catalogue du r eseau NEBIS (http ://www.nebis.ch) ou des bases de donn ees de brevets. Dans tous les cas, ces recherches peuvent consommer enorm ement de temps, en particulier si elles sont mal orient ees. Nh esitez pas a ` discuter avec vos assistants pour conna tre les mots-cl es ad equats. De plus, les editeurs proposent des moteurs de recherche dans leurs journaux : IEEE Springer Sciencedirect Emerald Taylor&Francis ASME Elsevier Kluwer http http http http http http http http ://ieeexplore.ieee.org ://link.springer.de ://www.sciencedirect.com ://gottardo.emeraldinsight.com ://taylorandfrancis.metapress.com ://www.asme.org ://contentsdirect.elsevier.com/ ://www.wkap.nl/journal/

Ayez un regard critique sur ce qui est publi e : la persistence au travers du temps des citations de certains ecrits peut etre un indice de abilit e. Plus personne ne remet en cause les mod` eles newtoniens du mouvement des corps, mais les appliquer a ` des vitesses proches de celle de la lumi` ere nest pas judicieux, comme la montr e Einstein. Cet exemple montre quil faut attacher autant dimportance a ` la solution qu` a ses conditions dapplication. Vous devez contr oler vos sources et sp ecier pourquoi et comment vous pouvez les utiliser, cest-` a-dire les hypoth` eses simplicatrices que vous faites.

2.7

Th eorie

Dans cette partie vous devez donner au lecteur des el ements th eoriques pertinents pour le projet. Ainsi, vous devrez adapter les equations g en erales ou algorithmes de votre domaine de travail au probl` eme particulier qui vous concerne. Mettez le reste (equations g en erales, th eorie de base, cas particuliers, voir d eg ener es) dans les annexes ou les r ef erences.

2.8

Exp eriences ou R esultats

Le premier objectif des exp eriences est de prouver quantitativement que les el ements th eoriques (mod` eles et hypoth` eses) que vous avez d evelopp e et les conclusions que vous en tirez sont bel et bien valables. Le deuxi` eme objectif est de prouver que les objectifs du projet on et e atteints ou, a ` d efaut, montrer quels objectifs on et e atteints. Si vous avez con cu un appareil ou un programme, vous ne devez pas vous contenter de dire ca marche. Concevez des exp eriences pour montrer jusquo` u cela marche, pour quel type dentr ees du syst` eme, comment la sortie se d egrade, etc. Cest ce quon appelle caract eriser un syst` eme. Il ne faut donc pas inonder le rapport de r esultats mais plut ot choisir les exp eriences qui valident (ou invalident !) les d eveloppements des chapitres pr ecedents. Les r esultats de vos exp eriences ne sont utilisables que sils sont parfaitement document es. Votre documentation doit etre telle quune tierce personne puisse recr eer des conditions identiques dexp erimentation et obtenir si possible les m emes mesures que vous. Si votre projet a une partie de programmation en C++ par exemple, votre code doit etre comment e de telle sorte quun autre ing enieur puisse le reprendre facilement : chaque fonction, classe est courtement 4

mais pr ecis ement comment ee. (Nous vous proposons loutil Doxygen pour commenter facilement le code.) Des sch emas-blocs de vos algorithmes doivent gurer dans le rapport. Le code restera sur votre compte qui sera sauvegard ea ` la n du semestre. Les r esultats bruts de vos mesures prendront place dans les annexes, alors que leur repr esentation et/ou interpr etation seront dans le rapport. Un eort danalyse est sp eciquement requis pour cette partie.

2.9

Conclusions

Vous synth etisez votre apport au projet et revenez sur vos hypoth` eses simplicatrices et evaluez leur co ut (importance). Caract erisez votre solution en sp eciant son champ dapplication. Ayez un regard critique sur votre propre travail, ainsi que sur le projet. Vous devez porter un regard dexpert, reposant sur une vue densemble d evelopp ee au cours de votre travail. Cest ici quil faut mentionner et argumenter vos doutes ou certitudes quant a ` la viabilit e de la recherche ou du projet, votre vision et vos id ees de d eveloppement futur.

2.10

Bibliographie

Cette section du rapport contiendra la liste des r ef erences bibliographiques que vous aurez employ e dans le rapport et eventuellement des r ef erences de base du domaine. En revanche, ne r ef erencez pas ce que vous navez pas lu : une bibliographie alibi peut etre source de questions dangereuses a ` la pr esentation orale...

2.11

Annexes

Dans cette partie de votre rapport est reserv e aux informations qui ne sont pas essentielles a ` la comprension g en erale du projet, mais qui sont tout de m eme utiles et dint er et pour le lecteur qui voudrait approondir dans votre travail, comme par exemple l etudiant qui continuera votre projet. Ainsi les annexes contiendront par exemple, Des d emonstrations ou d erivations de formules ou equations. Des calculs d etaill es. Des instructions pour le d emarrage et utilisation de votre manip ou vos programmes. Des donn ees brutes de mesures. Des datasheets. Des dessins techniques, des listes de pi` eces ou composants. Des descriptions des protocoles ou formats de donn ees que vous avez utilis e, pour autant quils soient peu courants. Des glossaires.

Les r ef erences bibliographiques

Si jai pu voir plus loin que les autres, cest parce que je mappuyais sur les epaules de g eants, a dit Isaac Newton. De nos jours, la majorit e des travaux scientiques et techniques sont bas es sur des r esultats et des conclusions dautres travaux. Ceci est dautant plus vrai lorsquil sagit dune oeuvre de vulgarisation. Lutilisation de r ef erences bibliographiques r epondent a ` plusieurs objectifs : Lhonn etet e dindiquer quels r esultats ou conclusions ne sont pas de mouture propre. Le d esir de donner plus de force a ` vos propos en montrant que des autorit es dans la mati` ere sont en accord avec vous. La paresse ou lesprit de synth` ese qui veulent eviter un calcul ou une d emonstration compliqu ee simplement en se r ef erant a ` quelquun qui lait d ej` a fait. Lint er et de donner aux lecteurs assoi es des sources pour etancher leur soif. La vanit e de montrer que vous connaissez les autorit es du domaine... 5

Il est donc essentiel pour ling enieur de savoir comment r ef erencer les ouvrages consult es pour son travail. Cet alin ea d ecrit succinctement plusieurs formats actuels pour introduire des r ef erences bibliographiques dans les documents scientiques et techniques. Il y a plusieurs formats bibliographiques possibles. Nous avons retenu les deux les plus r epandus et pratiques. Le format IEEE est plus compact, alors que le format auteur-date (Chicago ou Apalike) est plus explicite.

3.1

Format IEEE (ou num erot e)

LInstitute of Electrical and Electronics Engineers est une institution am ericaine de port ee internationale qui est devenue une r ef erence scientique et technique dans ling enierie electronique, linformatique, les communications et la m ecanique. LIEEE a d eni un format bibliographique qui est appliqu e dans les publications de lInstitut, comme par exemple le Journal of Microelectromechanical Systems. 3.1.1 Comment citer une r ef erence

Dans votre texte, vous citerez les di erents ouvrages consult es en mettant entre crochets le num ero correspondant a ` louvrage dans la section bibliographie ou r ef erences. Les ouvrages seront ordonn ees par ordre dapparition dans le texte, et ceux qui ne sont pas cit es sont ajout es a ` la n. Exemples : Dapr` es les r esultats de Lavoisier [1], lair nest pas un el ement indivisible. On peut am eliorer le rendement par lintroduction dun catalyseur [5], en augmentant la pression [6] ou la temp erature [3]. Les logiciels de traitement de texte modernes ont le moyen de g erer automatiquement la num erotation des r ef erences. Protez-en ! 3.1.2 Comment pr esenter une r eference

A la n de votre document, vous ajouterez une section de bibliographie ou r ef erences dans laquelle seront indiqu es les r ef erences aux formats suivants : 1. Un article dans une revue ou conf erence Le format g en eral est : Auteur (Initiales+Nom), titre de larticle, titre de revue, volume, pages, mois, ann ee. Exemples : [1] T.E. Schaer and P.K. Hansma, Optimization of the detection sensitivity of an atomic force microscope for small cantile, Journal of Applied Physics, vol. 84, pp. 4661-4666, Nov. 1998. 2. Un livre Le format pour un livre est : Auteur (Initiales+Nom), titre du livre. Lieu de publication : maison, ann ee, page ou chapitre si d esir e. Exemple : [1] M. Madou, Fundamentals of Microfabrication. New York : McGraw-Hill, 1997. 3. Un rapport ou manuel technique Les rapports sont trait es de fa con similaire aux livres, mais il faut en plus sp ecier le type de rapport (de th` ese, de masters, de s eminaire, rapport technique, etc.) et linstitution qui le publie. Exemples : [1] C.Homan, H. Hopcroft, Quadratic Blending Surfaces, Technical Report No. 85-674, Cornell Univeristy, Ithaca, N.Y., 1985. [2] P. Klee, H. Erni, Limpression oset, S eminaire de Techniques de Production, DMT-EPFL, Lausanne, 1999.

Parfois les rapports ou manuels nont pas dauteur. La r ef erence appara tra comme : [3] Keyence User Manual, Keyence Corp., Woodcli LAke, N.J., 1998. 4. Une page web ou r ef erence electronique Les pages Web sont d econseill ees comme r ef erence bibliographique, car leurs contenus sont susceptibles de varier avec le temps. Toutefois, de plus en plus dinformations sont disponibles en format electronique, et ce type de r ef erences est accept e. Dans ces r ef erences on indiquera : lauteur, le titre du document ou page, ladresse URL, linstitution ou soci et e qui publie la page (si telle), et la derni` ere date a ` laquelle la page contenait linformation r ef erenc ee. Si ladresse nest plus valide, les informations additionnelles doivent permettre le lecteur de demander le document. Exemples : [1] E. Weisstein, Eric Weissteins World of Mathematics, http ://mathworld.wolfram.com, (current May 3, 2000)

[2] E. Weisstein, Rysers Formula, Eric Weissteins World of Mathematics, http ://mathworld.wolfram.com/Ryse (current May 3, 2000) [3] K. MacDonald, Introduction to Video 101, http ://www.pulnix.com/imaging/pdfs/primer.pdf, Pulnix America Inc, (current May 3, 2000). [4] Progressive Scan Technology, http ://www.pulnix.com/imaging/i-techC.html, (current May 3, 2000).

Format auteur-date (Chicago ou APA)

Ce format, conseill e par lUniversit e de Chicago et tr` es r epandu dans les sciences utilise le nom de lauteur et la date pour les r ef erences. Un citation dans le texte appara trait comme suit : Dapr` es les r esultats de Lavoisier (Lavoisier 1760) lair nest pas un el ement indivisible. On peut am eliorer le rendement par lintroduction dun catalysateur (Smith 1996), en augmentant la pression (Weson 1999) ou la temp erature (Colt 2000). A la n de votre document, vous ajouterez une section bibliographique avec les r ef erence ordonn ees alphab etiquement par ordre dauteur, en suivant le format suivant : 1. Un article dans une revue ou conf erence La format dun article est : Nom, Pr enom ( eventuellement abr eg e). Date. Titre de larticle. Titre de la revue. Volume :pageinit-pagen. Voici des exemples : Armitage, K.B and Johns, D.W. 1982. Kinship and reproductive strategies of ants. Behavioral Ecology and Sociology. 11 :55-63. 2. Un livre Le format dun livre est Nom, Pr enom. Ann ee. Titre. Lieu : Maison d editions. Lorsque le livre na pas dauteur d eni, on mettre le nom de la societ e qui la cr ee ou mandat e. Exemple : Blinsksworth, Roger. 1987. Converging on the evanescent. San Francisco : Threshold publications. European Space Agency (ESA). 1995. Ariane V stress analysis. Paris : Hermes. Smith, Roger and Weson, Mark and Colt, Ted. 1980. Marksmanship. Santa Fe : NRA publishers.

3. Un rapport Cela donnerait : Pache, Ch. et Mathey, O. 1999. D ecoupage laser. S eminaires de techniques de production. Lausanne : DMT-EPFL. 4. Une r ef erence electronique On indiquera lauteur, date de visite, le titre et ladresse o` u obtenir le document. E. Weisstein. 2000. Rysers Formula. In Eric Weissteins World of Mathematics [cited May 2000] Available from http ://mathworld.wolfram.com/RyserFormula.html

Soyez coh erents dans lutilisation des formats bibliographiques. Pour plus dinformation, consultez (Grossman 1993) et (IEEE 2000).
A Sur L TEX les formats sont g er es automatiquement par bibtex. Utilisez \bibliographystyle{ieeetr} A pour le format IEEE. Le format auteur-date peut etre g en er e avec les styles L TEX Chicago ou apalike. Pour Chicago il faut d eclarer en d ebut de chier

\usepackage{chicago} et aussi \bibliographystyle{chicago} Pour le format APA il sut de d eclarer \bibliographystyle{apalike} dans la bibliographie.

Les graphiques

Les graphiques de qualit e doivent communiquer au lecteur le plus dinformation possible, en un minimum de temps et en utilisant le minimum dencre (Tufte 2001). Les graphiques doivent r ev eler linformation pr esente dans les donn ees. Voici quelques r` egles de style pour les graphiques : La mise en page doit etre homog` ene a ` lint erieur dun graphique. Soyez coh erents. Des graphiques s epar es servant a ` etablir des comparaisons doivent aussi avoir une mise en page coh erente. Ils doivent notamment etre dessin es a ` la m eme echelle et dans le m eme domaine. Si ceci nest pas possible, il faut lindiquer tr` es clairement. Par souci dint egrit e, le nombre de dimensions informatives du graphique ne doit pas d epasser le nombre de dimensions des donn ees (Tufte 2001). Ainsi, le donn ees unidimensionnelles ne doivent pas etre repr esent ees par des el ements bidimensionnels (surfaces). Pour de petits ensembles de donn ees, moins de 20 donn ees, les tableaux sont plus informatifs que les graphiques (Tufte 2001). Etiquetez correctement vos graphiques : Placez la variable independante (la cause ) sur laxe des abcisses (X) et la variable d ependante (le r esultat ) sur laxe des ordonn ees (Y). Indiquez les unit es et leurs multiples sur les axes, typiquement entre crochets. Ex. [mV]. (En revanche, on nutilise pas les crochets apr` es des valeurs num eriques. Ex. 10 mV). Pour les abreviations des unit es consultez (IEEE 2000).

 Accompagnez les graphiques dune description ou explication succincte. Le graphique doit etre lisible sans recours au texte principal. Accompagnez les donn ees issues de mesures de leurs erreurs, par exemple a ` laide des intervalles de conance ou par des boxplots (cf. //lpmvision/ipmvislib/matlab/sboxplot.m) Du point de vue pratique, sauvez vos graphiques en EPS (vectoriaux), car ils sadaptent tr` es bien aux changements de taille, permettant leur utilisation dans un rapport, un poster ou une page web. Mais prenez lhabitude de conserver les donn ees brutes des graphiques, car il se peut que en cours de r edaction vous trouviez quil faut changer le graphique, par exemple pour superposer des valeurs th eoriques aux mesures. Et rappellez-vous, if the statistics are boring, then youve got the wrong numbers (Tufte 2001).

Style

Utilisez un langage simple, objectif, quanti e, pr ecis et rigoureux. Faites des phrases courtes et directes. La quantit e ne fait pas la qualit e. Choisissez a ` quel pronom vous allez ecrire votre rapport (souvent on ou nous, rarement je ), et tenezvous a ` celui-ci tout au long du rapport. Ne passez pas continuellement de on a ` nous, par exemple. Consacrez chaque paragraphe a ` une id ee di erente et donnez toujours des preuves ou exemples en soutien de vos opinions ou conclusions. Nh esitez pas a ` donner une br` eve d enition a ` la premi` ere apparition dun nouveau terme, sp ecique a ` votre probl` eme. Noubliez pas quun texte orthographiquement et grammaticalement correct est plus facile a ` lire que sil ne l etait pas.

Gestion du temps

Ecrire un rapport est un eort de synth` ese sur le travail eectu e. Il peut etre dicile de mener cet exercice sous une pression intense en n de semestre. Certaines parties ( etat de lart, th eorie) devraient etre r edig ees aux deux tiers du projet (typiquement avant No el pour des projets de semestre dhiver ou de dipl ome). Non seulement cela limite leort nal, mais cela force a ` eclaircir ses id ees rapidement. Une version compl` ete contenant tous les principaux el ements de chaque section du rapport devrait etre pr esent ee a ` lassistant un mois avant la n du projet. Certaines parties peuvent ne pas etre totalement r edig ees, mais se pr esentent alors sous forme de liste de points a ` d etailler. Au plus tard deux semaines avant le d elai, le rapport devraient etre sous sa forme nale (r esum e, traitement des r esultats, introduction et conclusion inclus), laissant le temps a ` l etudiant de prendre du recul par rapport au projet (pour faire une autocritique du projet et am eliorer ce qui est possible), et a ` lassistant un peu de temps pour corriger le rapport. Ces deux derni` eres semaines devraient etre mises a ` prot pour critiquer la m ethodologie employ ee pour atteindre les objectifs et v erier que tous les objectifs x es soient atteints (caract eriser ou quantier). En quelque sorte, il sagit de revenir au cahier des charges, quantier les performances obtenues et qualier la mani` ere de les obtenir. Il est evidemment mieux de faire cet exercice tout au long du projet, mais cest alors le dernier moment pour le faire.

Remarques nales

Le rapport est un exercice qui fait partie int egrante du projet est nest pas a ` n egliger. Un mauvais rapport rend le travail inutilisable, ce qui est peu gratiant en soi, mais en plus il rendra la pr esentation 9

orale dautant plus risqu ee ! Vos assistants sont aussi l` a pour vous servir de critiques dans cette t ache, et seront certainement daccord de vous relire et critiquer si vous leur soumettez des parties de rapport a ` lavance (merci de ne pas les utiliser comme correcteurs orthographiques).

R ef erences
Bertin, J. (1967). S emiologie graphique. Cheney, T. (1983). Getting words right. Cincinnatti, OH, USA : Writers Digest Books. Globus, A. (1994, July). Fourteen Ways to Say Nothing with Scientic Visualization. IEEE Computer , 8688. Grevisse (1993). Le bon usage (13eme ed.). Paris : De BoeckDuculot. Grossman, J. (Ed.) (1993). The Chicago Manual of Style (14th ed.). Chicago, USA : University of Chicago Press. IEEE (2000). Information for authors. Technical report, http ://www.ieee.org/organizations/pubs/transactions/information.htm. IEEE.

Strunk, W. and E. White (1979). The Elements of Style (3rd ed.). Needham Heights, MA, USA : Allyn and Bacon. Tufte, E. (1990). Envisioning Information. Graphics Press. Tufte, E. (2001). The Visual Display of Quantitative Information (2nd ed.). Graphics Press. Van Lintel, H., R. Holzer, and P.-A. Besse (2001). Guide for writing technical reports. IMSDMT EPFL, Lausanne, Switzerland.

10

A D emarrage dun rapport sur L TEX

Ecrivez votre rapport dans un chier texte a ` extension .tex et la liste bibliographique dans un autre chier texte a ` extension .bib. Sur Windows, vous pouvez utiliser le logiciel WinEdt (seulement a ` lEPFL) ou tout autre traitement de texte. Sur Linux, nous vous conseillons emacs. Le chier .tex aura la structure suivante : \documentclass[a4paper,11pt,twoside]{report} % Ajouter loption pdf lorsque vous compilez avec pdflatex \usepackage[french]{rapport_etudiant} \usepackage{graphicx} \project{dipl^ ome} \author{...} \professor{...} \assistant{...} \secassistant{...} \terassistant{...} \title{Titre} \begin{document} \maketitle \begin{enonce} ... \end{enonce} \begin{resume} ... \end{resume} \chapter{Introduction} ... ... ... \bibliography{exemple} % Utilise exemple.bib % Prints all the non-cited references \nocite{*} % Use style alphakey or alpha for the draft, and then switch % to unsrt or plain or ieeetr styles for the final version, % since they are the IEEE preferred ones. \bibliographystyle{ieeetr} %\bibliographystyle{alpha} \cleardoublepage \appendix \chapter{Annexe 1} ... \end{document} Pour g en erer le rapport (compiler), vous pouvez utiliser les compilateurs latex ou pdflatex. Le premier produit un chier PostScript et le deuxi` eme en PDF. Les deux compilateurs sont gratuits pour Linux et Windows et disponibles dans http ://www.tug.org/teTeX/ (Linux) et http ://www.miktex.org (Windows).

11

Pour g en erer le rapport, il faut lancer la compilation dans cet ordre : latex rapport.tex bibtex rapport.aux latex rapport.tex latex rapport.tex Si vous obtenez une erreur de compilation, corrigez-la avant de continuer. Cela produira le chier rapport.dvi, duquel vous obtiendrez rapport.ps avec dvips. Pour obtenir un PDF, vous soit pouvez convertir le PS en PDF, soit utiliser pdflatex a ` la place de latex. Mais attention, pdflatex accepte seulement des images TIFF ou PNG !

12