Thèses de physique : équations, unités et projets multi-fichiers sous contrôle

Notations, siunitx, projets à plusieurs chapitres, pièges des revues à deux colonnes et habitudes de compilation hors ligne pour les étudiants en physique et en astronomie.

Les manuscrits de physique contiennent plus de mathématiques par page que dans la plupart des disciplines. Ce n’est pas un problème, jusqu’à ce qu’un chapitre à moitié fini casse toute la compilation parce qu’une étiquette a bougé, ou que chaque coauteur invente une convention différente pour les vecteurs en gras.

Voici une configuration pratique pour des chapitres de master ou de doctorat, des notes de collaboration et des soumissions à des revues qui veulent encore deux colonnes.

Plusieurs fichiers dès le départ

Même une courte thèse gagne à avoir un fichier racine et des inclusions de chapitres :

\documentclass{report} % or the university class
\begin{document}
\include{chapters/intro}
\include{chapters/methods}
\include{chapters/results}
\end{document}

Utilisez \includeonly{chapters/methods} pendant la rédaction, pour ne pas recompiler trois chapitres afin de corriger une seule équation. Détails : un fichier racine, plusieurs chapitres.

Rangez les figures sous figures/ch2/ et nommez les équations avec des étiquettes qui tiennent compte du chapitre (eq:ch2-hamiltonian), pour que les fusions n’entrent pas en collision.

Les unités ne sont pas du texte

Écrivez $v = 3.0\,\mathrm{m\,s^{-1}}$ à la main si vous y tenez, ou chargez siunitx et utilisez \qty{3.0}{m.s^{-1}}. Les revues diffèrent sur l’espacement et les espaces fines ; choisissez une voie de package et tenez-vous-y. Des styles mélangés donnent l’impression de deux auteurs qui ne se sont jamais rencontrés.

Pour les tableaux de valeurs, les types de colonnes de siunitx alignent les décimales et gardent des en-têtes d’unités cohérents. Ne mélangez pas m/s et ms^{-1} dans un même article sans une raison indiquée dans les méthodes.

Dirac, vecteurs et conventions de gras

Les groupes de physique quantique et de matière condensée ont souvent besoin de la notation de Dirac. Des packages comme physics ou des macros dédiées pour \ket, \bra, \braket valent mieux que des combinaisons improvisées de chevrons. Les groupes de mécanique classique se disputent entre vecteurs en gras et vecteurs à flèche. Documentez la convention dans le préambule et refusez les exceptions improvisées en milieu de chapitre.

Voir la notation de Dirac et les mathématiques en gras.

Définissez les opérateurs une seule fois (\DeclareMathOperator) pour que les opérateurs différentiels et les fonctions nommées ne dérivent pas de police.

Numérotation et références croisées

Numérotez les équations que vous citerez ; laissez les autres sans numéro. Une page de (1)(2)(3)... est plus difficile à lire qu’un court récit avec deux lignes étiquetées. Utilisez \eqref pour les équations, avec des étiquettes stables. La vérification des références à l’échelle du projet repère une étiquette supprimée avant l’encadrant.

Les théorèmes et les lemmes (si vous en utilisez) doivent partager un schéma de numérotation clair avec le reste du modèle du département. Voir aussi théorèmes et démonstrations.

Pièges des revues à deux colonnes

Les classes APS, IOP et similaires changent le comportement des flottants. Une figure qui allait bien dans article peut refuser de se placer à côté du paragraphe qui la cite. Compilez tôt avec la vraie classe, pas le week-end précédant la soumission.

Réglages par défaut utiles :

  • largeur de figure d’environ 0.45\textwidth ou \columnwidth en deux colonnes
  • figures larges en figure* (souvent en haut de page uniquement)
  • longs calculs dans multline / split, ou déplacés en annexe

Ne réduisez pas la police des équations jusqu’à les rendre illisibles. Les relecteurs le remarquent.

Figures : graphiques et schémas

Exportez les graphiques en PDF depuis matplotlib, gnuplot ou Root quand c’est possible. Les PNG matriciels sont réservés aux photographies et aux images de détecteur, à une résolution (dpi) suffisante. Les schémas peuvent être en TikZ ou en dessin vectoriel externe ; gardez la source dans le dépôt. Rognez les marges blanches avant \includegraphics.

Hors ligne quand le réseau du laboratoire tombe

Les lignes de faisceau et les salles blanches ne sont pas réputées pour la stabilité de leur Wi‑Fi. Oleafly (s’ouvre dans un nouvel onglet) embarque les compilateurs et garde SyncTeX, l’espace PDF et l’aperçu des formules sur votre machine. Chaque projet est un vrai dépôt Git avec points de contrôle automatiques : une mauvaise modification d’équation se défait en une restauration. Le PDF se compile encore quand un éditeur de navigateur ne se charge pas.

Vous pouvez assembler une pile hors ligne comparable avec TeX Live, un lecteur de PDF et Git à la main. Dans les deux cas, la thèse ne doit pas dépendre d’un portail captif pour recompiler le chapitre trois.

Collaboration

Attribuez les chapitres par auteur quand c’est possible. Partagez une fiche de notations. Compilez le document entier chaque semaine pour que les références entre chapitres échouent tôt. Dépôt Git distant privé pour les résultats non publiés ; public seulement quand la politique de la collaboration l’autorise.

Annexes et documents complémentaires

Les longs calculs et les graphiques supplémentaires ont leur place dans une annexe ou dans un PDF de complément séparé quand la revue est à deux colonnes et limitée en pages. Faites des renvois explicites (« voir l’annexe B ») avec de vraies étiquettes. Ne supposez pas que le rapporteur ouvrira un zip de figures en vrac sans légendes.

Quand l’encadrant corrige sur papier

Reportez les annotations dans la source TeX le jour même si possible. Les piles de papier se périment. Si deux encadrants annotent des notations contradictoires, mettez à jour la fiche du préambule et envoyez un PDF d’une page sur les notations, pour que la discussion ne soit pas rouverte à chaque version.

Avant la soumission

Fiche de notations complète, vecteurs et bras/kets cohérents, unités via un seul système (siunitx ou un style manuel convenu). Les chapitres doivent s’inclure proprement, avec des \ref/\eqref résolus. Compilez avec la vraie classe de la revue ou de la thèse, sans surprise de polices. Les figures respectent les règles de dpi et de couleur ; les légendes se suffisent à elles-mêmes. Archivez la source et le PDF avec un hash de commit pour la version soumise.

Écrire de la physique est déjà assez difficile. La chaîne d’outils doit rester ennuyeuse.

Tous les articles