{"id":1254,"date":"2026-08-21T14:31:45","date_gmt":"2026-08-21T14:31:45","guid":{"rendered":"https:\/\/matforge.org\/?p=1254","raw":"https:\/\/matforge.org\/?p=1254"},"modified":"2026-08-21T14:31:45","modified_gmt":"2026-08-21T14:31:45","slug":"reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document","status":"publish","type":"post","link":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/","title":{"rendered":"Flux de travail de simulation reproductible dans la recherche sur la chimie et les mat\u00e9riaux\u00a0: quelles \u00e9quipes doivent documenter","raw":"Flux de travail de simulation reproductible dans la recherche sur la chimie et les mat\u00e9riaux\u00a0: quelles \u00e9quipes doivent documenter"},"content":{"rendered":"<span class=\"span-reading-time rt-reading-time\" style=\"display: block;\"><span class=\"rt-label rt-prefix\">Reading Time: <\/span> <span class=\"rt-time\"> 8<\/span> <span class=\"rt-label rt-postfix\">minutes<\/span><\/span><p>La reproductibilit\u00e9 dans la chimie et la simulation des mat\u00e9riaux ne consiste pas seulement \u00e0 stocker un script, \u00e0 t\u00e9l\u00e9charger un ensemble de donn\u00e9es ou \u00e0 conserver un dossier de fichiers d&rsquo;entr\u00e9e. Un flux de travail est reproductible lorsqu&rsquo;un autre chercheur peut comprendre comment une question scientifique est devenue un mod\u00e8le, comment ce mod\u00e8le est devenu un ex\u00e9cutable, comment l&rsquo;ex\u00e9cution a produit des r\u00e9sultats et comment ces sorties sont devenues un r\u00e9sultat signal\u00e9.<\/p>\n<p>Cette cha\u00eene est facile \u00e0 casser. Une d\u00e9pendance modifi\u00e9e, un param\u00e8tre de solveur non document\u00e9, un fichier de sortie renomm\u00e9 ou une figure g\u00e9n\u00e9r\u00e9e \u00e0 partir d&rsquo;une feuille de calcul modifi\u00e9e manuellement peut rendre difficile une analyse par ailleurs pr\u00e9cieuse. Le probl\u00e8me n&rsquo;est pas toujours une mauvaise science. Souvent, il manque le contexte.<\/p>\n<p>Pour les \u00e9quipes de recherche de chimie et de mat\u00e9riaux informatiques, la documentation doit pr\u00e9server plus que la r\u00e9ponse finale. Il doit pr\u00e9server le raisonnement, la configuration, l&rsquo;\u00e9tat d&rsquo;ex\u00e9cution et le chemin d&rsquo;interpr\u00e9tation qui ont rendu la r\u00e9ponse possible.<\/p>\n<h2>Ce que signifie r\u00e9ellement un flux de travail de simulation reproductible<\/h2>\n<p>Un flux de travail de simulation reproductible est le chemin document\u00e9 de l&rsquo;intention scientifique au r\u00e9sultat interpr\u00e9table. Il comprend le mod\u00e8le, les entr\u00e9es, l&rsquo;\u00e9tat du logiciel, l&rsquo;environnement d&rsquo;ex\u00e9cution, les donn\u00e9es g\u00e9n\u00e9r\u00e9es, les \u00e9tapes de post-traitement et le raisonnement utilis\u00e9 pour connecter les sorties \u00e0 une revendication.<\/p>\n<p>Dans un contexte de chimie ou de mat\u00e9riaux, cela peut impliquer des structures mol\u00e9culaires, des mod\u00e8les de champ de phase, des hypoth\u00e8ses de r\u00e9action, des potentiels interatomiques, des conditions aux limites, des choix de maillage, des crit\u00e8res de convergence, des param\u00e8tres thermodynamiques ou des param\u00e8tres de solveur num\u00e9rique. En pratique, les \u00e9l\u00e9ments exacts varient selon la m\u00e9thode. Le principe ne le fait pas.<\/p>\n<p>Un flux de travail reproductible devrait permettre \u00e0 un futur lecteur de r\u00e9pondre \u00e0 quatre questions :<\/p>\n<ul>\n<li>Qu&rsquo;est-ce que la simulation essayait de tester ou de d\u00e9montrer&nbsp;?<\/li>\n<li>Quelles hypoth\u00e8ses et param\u00e8tres ont fa\u00e7onn\u00e9 le r\u00e9sultat&nbsp;?<\/li>\n<li>Quel \u00e9tat de calcul exact a produit la sortie&nbsp;?<\/li>\n<li>Comment les r\u00e9sultats ont-ils \u00e9t\u00e9 transform\u00e9s en interpr\u00e9tation rapport\u00e9e&nbsp;?<\/li>\n<\/ul>\n<p>Sans ces r\u00e9ponses, un r\u00e9sultat peut toujours \u00eatre int\u00e9ressant, mais il est plus difficile de faire confiance, de comparer, d&rsquo;\u00e9tendre ou de d\u00e9boguer.<\/p>\n<h2>La cha\u00eene de documentation des revendications \u00e0 ex\u00e9cuter<\/h2>\n<p>Le moyen le plus utile de documenter le travail de simulation est de commencer par la revendication que le flux de travail prend en charge et de remonter jusqu&rsquo;\u00e0 la course qui l&rsquo;a produit. Cela \u00e9vite un \u00e9chec de documentation courant : pr\u00e9server les fragments techniques sans montrer comment ils se connectent.<\/p>\n<p>La cha\u00eene de revendications \u00e0 ex\u00e9cuter a cinq couches.<\/p>\n<h3>1. La couche de revendication<\/h3>\n<p>Cette couche enregistre la conclusion, la figure, la tendance, la comparaison ou la propri\u00e9t\u00e9 que le flux de travail est cens\u00e9 prendre en charge. Il doit indiquer le r\u00e9sultat de la simulation utilis\u00e9 pour argumenter, et non seulement le fichier g\u00e9n\u00e9r\u00e9.<\/p>\n<p>Par exemple, un flux de travail peut prendre en charge une affirmation concernant le comportement de diffusion, la stabilit\u00e9 de phase, l&rsquo;\u00e9nergie de formation de d\u00e9fauts, les effets de solvant, l&rsquo;\u00e9volution de la morphologie ou les performances relatives de deux configurations de mod\u00e8le. La documentation doit rendre ce but visible.<\/p>\n<h3>2. Le calque du mod\u00e8le<\/h3>\n<p>Cette couche explique la repr\u00e9sentation scientifique et math\u00e9matique derri\u00e8re la course. Il comprend des hypoth\u00e8ses, des \u00e9quations r\u00e9gissant, des approximations, des limites de mod\u00e8les, des param\u00e8tres s\u00e9lectionn\u00e9s et des simplifications connues.<\/p>\n<p>Le but n&rsquo;est pas d&rsquo;\u00e9crire un manuel dans chaque dossier de projet. L&rsquo;objectif est de laisser suffisamment de contexte pour qu&rsquo;un autre membre de l&rsquo;\u00e9quipe puisse voir pourquoi ce mod\u00e8le a \u00e9t\u00e9 choisi et o\u00f9 ses limites commencent.<\/p>\n<h3>3. La couche d&rsquo;ex\u00e9cution<\/h3>\n<p>Cette couche capture l&rsquo;\u00e9tat de calcul de l&rsquo;ex\u00e9cution&nbsp;: versions du logiciel, validations, d\u00e9pendances, fichiers d&rsquo;environnement, configuration des t\u00e2ches, contexte mat\u00e9riel, graines al\u00e9atoires et journaux d&rsquo;ex\u00e9cution.<\/p>\n<p>Les d\u00e9tails d&rsquo;ex\u00e9cution sont souvent trait\u00e9s comme un bruit administratif jusqu&rsquo;\u00e0 ce que quelque chose change. Ensuite, ils deviennent le seul moyen d&rsquo;expliquer pourquoi une rediffusion diff\u00e8re de l&rsquo;original.<\/p>\n<h3>4. La couche de donn\u00e9es<\/h3>\n<p>Cette couche pr\u00e9serve les sorties brutes, les sorties d\u00e9riv\u00e9es, les m\u00e9tadonn\u00e9es, les conventions de nommage, les unit\u00e9s, les transformations et les relations de fichiers. Il doit \u00eatre clair quels fichiers sont des produits de simulation directe et lesquels ont \u00e9t\u00e9 cr\u00e9\u00e9s par analyse ou filtrage.<\/p>\n<h3>5. La couche d&rsquo;interpr\u00e9tation<\/h3>\n<p>Cette couche relie les sorties \u00e0 l&rsquo;interpr\u00e9tation scientifique finale. Il comprend des scripts d&rsquo;analyse, du code de tra\u00e7age, des ex\u00e9cutions exclues, des \u00e9checs, des d\u00e9cisions manuelles, des notes de probl\u00e8mes et des \u00e9tapes de g\u00e9n\u00e9ration de chiffres.<\/p>\n<p>C&rsquo;est l\u00e0 que de nombreux workflows perdent leur reproductibilit\u00e9. La simulation peut \u00eatre r\u00e9examin\u00e9e, mais le chiffre ou la conclusion rapport\u00e9s peuvent ne pas \u00eatre tra\u00e7ables.<\/p>\n<h2>Quoi documenter avant la course<\/h2>\n<p>La documentation en pr\u00e9-ex\u00e9cution doit expliquer pourquoi la simulation existe et quelles conditions d\u00e9finissent un r\u00e9sultat significatif. Ceci est particuli\u00e8rement important lorsqu&rsquo;un flux de travail sera r\u00e9examin\u00e9 apr\u00e8s un brouillon de papier, un changement de code, un commentaire d&rsquo;examen par les pairs ou un transfert d&rsquo;\u00e9quipe.<\/p>\n<p>Au minimum, les \u00e9quipes doivent documenter la question de recherche, le syst\u00e8me chimique ou des mat\u00e9riaux, l&rsquo;approche de mod\u00e9lisation, les hypoth\u00e8ses formul\u00e9es et les crit\u00e8res utilis\u00e9s pour juger si la course a r\u00e9ussi.<\/p>\n<p>Pour la recherche sur la chimie et les mat\u00e9riaux, cela signifie souvent enregistrer :<\/p>\n<ul>\n<li>Composition, structure, g\u00e9om\u00e9trie ou description de phase du syst\u00e8me;<\/li>\n<li>hypoth\u00e8ses de mod\u00e8les et simplifications connues&nbsp;;<\/li>\n<li>conditions initiales et limites ;<\/li>\n<li>unit\u00e9s et sources de param\u00e8tres&nbsp;;<\/li>\n<li>Param\u00e8tres de solveur, de discr\u00e9tisation, de maillage ou de convergence&nbsp;;<\/li>\n<li>Crit\u00e8res d&rsquo;acceptation pour un r\u00e9sultat stable ou utilisable ;<\/li>\n<li>r\u00e9sultats attendus et comment ils seront interpr\u00e9t\u00e9s.<\/li>\n<\/ul>\n<p>Cette information n&rsquo;a pas besoin d&rsquo;\u00eatre longue. Un fichier de lecture concise, une note d&rsquo;ex\u00e9cution structur\u00e9e ou un mod\u00e8le de projet peut suffire s&rsquo;il capture les d\u00e9cisions qui sont par ailleurs faciles \u00e0 oublier.<\/p>\n<h2>Que capturer lors de l&rsquo;ex\u00e9cution<\/h2>\n<p>La documentation d&rsquo;ex\u00e9cution est la partie de la reproductibilit\u00e9 qui semble souvent routini\u00e8re jusqu&rsquo;\u00e0 ce qu&rsquo;elle soit manquante. Une simulation peut produire une sortie en apparence valide tout en masquant les avertissements, les changements de d\u00e9pendance, les interruptions du planificateur, les chemins d&rsquo;entr\u00e9e modifi\u00e9s ou le comportement de repli silencieux.<\/p>\n<p>L&rsquo;enregistrement d&rsquo;ex\u00e9cution doit inclure l&rsquo;\u00e9tat exact du logiciel utilis\u00e9 pour l&rsquo;ex\u00e9cution. Cela signifie que les num\u00e9ros de version, le r\u00e9f\u00e9rentiel valident, le cas \u00e9ch\u00e9ant, les fichiers de d\u00e9pendance, les fichiers de configuration, les arguments de ligne de commande et les d\u00e9tails de l&rsquo;environnement. Pour les syst\u00e8mes HPC ou partag\u00e9s, les param\u00e8tres du planificateur et l&rsquo;allocation des ressources peuvent \u00e9galement avoir une importance.<\/p>\n<p>Lorsque des r\u00e9sultats inattendus apparaissent, ces enregistrements font partie du processus de diagnostic. Les \u00e9quipes qui traitent <a href=\"https:\/\/matforge.org\/reproducibility-and-its-role-in-debugging\/\">reproductibilit\u00e9 comme une aide de d\u00e9bogage pratique<\/a> sont g\u00e9n\u00e9ralement mieux plac\u00e9es pour d\u00e9terminer si un changement provenait du mod\u00e8le, des donn\u00e9es, du logiciel ou de l&rsquo;environnement d&rsquo;ex\u00e9cution.<\/p>\n<p>Les journaux ne doivent pas \u00eatre \u00e9cart\u00e9s trop rapidement. Les avertissements, les messages de convergence, les diagnostics de solveur, les erreurs d&rsquo;ex\u00e9cution et le comportement de red\u00e9marrage peuvent expliquer pourquoi un r\u00e9sultat doit \u00eatre approuv\u00e9, r\u00e9p\u00e9t\u00e9 ou exclu.<\/p>\n<h2>Que conserver apr\u00e8s la course<\/h2>\n<p>La documentation post-ex\u00e9cution doit rendre la voie de sortie visible. Un flux de travail reproductible ne s&rsquo;arr\u00eate pas \u00e0 la fin de la simulation. Cela se termine lorsque l&rsquo;\u00e9quipe peut montrer comment les sorties brutes sont devenues des donn\u00e9es, des chiffres, des tableaux ou des revendications.<\/p>\n<p>Conservez les sorties brutes s\u00e9par\u00e9ment des sorties trait\u00e9es. Gardez les scripts d&rsquo;analyse \u00e0 proximit\u00e9 des donn\u00e9es qu&rsquo;ils transforment. Enregistrer les unit\u00e9s, les filtres, les choix de lissage, les seuils et les cas exclus. Si une figure appara\u00eet dans un rapport ou un manuscrit, le flux de travail doit indiquer quel ex\u00e9cution, script et ensemble de donn\u00e9es l&rsquo;ont produit.<\/p>\n<p>Les courses rat\u00e9es m\u00e9ritent \u00e9galement un record. Une simulation \u00e9chou\u00e9e peut expliquer pourquoi les param\u00e8tres ont chang\u00e9, pourquoi un mod\u00e8le a \u00e9t\u00e9 r\u00e9duit ou pourquoi un r\u00e9sultat a \u00e9t\u00e9 r\u00e9ex\u00e9cut\u00e9 ult\u00e9rieurement. Lorsque les anomalies ou les rediffusions affectent l&rsquo;interpr\u00e9tation, cela aide \u00e0 pr\u00e9server la connexion entre la sortie et la d\u00e9cision de l&rsquo;\u00e9quipe qui a suivi, y compris <a href=\"https:\/\/matforge.org\/linking-simulation-results-to-reported-issues\/\">Connexion des r\u00e9sultats de simulation \u00e0 l&rsquo;historique des probl\u00e8mes derri\u00e8re eux<\/a>.<\/p>\n<blockquote>\n<p><strong>Test utile&nbsp;:<\/strong> Si un chiffre ne peut pas \u00eatre r\u00e9g\u00e9n\u00e9r\u00e9 \u00e0 partir d&rsquo;entr\u00e9es, de scripts et de sorties document\u00e9es, le flux de travail n&rsquo;est pas enti\u00e8rement document\u00e9 m\u00eame si l&rsquo;image finale est enregistr\u00e9e.<\/p>\n<\/blockquote>\n<h2>Une carte de documentation pratique<\/h2>\n<table class=\"custom-table\">\n<tbody>\n<tr>\n<th>\u00c9tape du flux de travail<\/th>\n<th>Quoi documenter<\/th>\n<th>Pourquoi c&rsquo;est important<\/th>\n<th>Enregistrement minimum acceptable<\/th>\n<\/tr>\n<tr>\n<td>Cadre scientifique<\/td>\n<td>Question, revendication, syst\u00e8me, sortie attendue<\/td>\n<td>Montre pourquoi la simulation a \u00e9t\u00e9 ex\u00e9cut\u00e9e<\/td>\n<td>Note de projet courte ou section Lisez-moi<\/td>\n<\/tr>\n<tr>\n<td>Configuration du mod\u00e8le<\/td>\n<td>Hypoth\u00e8ses, \u00e9quations, param\u00e8tres, conditions aux limites<\/td>\n<td>Rend la base scientifique inspectable<\/td>\n<td>Note de mod\u00e8le avec unit\u00e9s et sources de param\u00e8tres<\/td>\n<\/tr>\n<tr>\n<td>Ex\u00e9cution<\/td>\n<td>Version du logiciel, validation, d\u00e9pendances, environnement, commande, journaux<\/td>\n<td>Permet les rediffusions et le d\u00e9bogage<\/td>\n<td>Fichier d&rsquo;environnement, ex\u00e9cution de la commande, journaux enregistr\u00e9s<\/td>\n<\/tr>\n<tr>\n<td>Sorties<\/td>\n<td>Fichiers bruts, fichiers d\u00e9riv\u00e9s, m\u00e9tadonn\u00e9es, conventions de d\u00e9nomination<\/td>\n<td>Emp\u00eache la confusion entre les donn\u00e9es originales et trait\u00e9es<\/td>\n<td>Manifeste de sortie avec descriptions de fichiers<\/td>\n<\/tr>\n<tr>\n<td>Une analyse<\/td>\n<td>Scripts, filtres, transformations, \u00e9tapes de tra\u00e7age<\/td>\n<td>Connecter les donn\u00e9es aux chiffres et conclusions<\/td>\n<td>Script d&rsquo;analyse et carte de la figure<\/td>\n<\/tr>\n<tr>\n<td>Exceptions<\/td>\n<td>Ex\u00e9cutions \u00e9chou\u00e9es, exclusions, avertissements, corrections manuelles<\/td>\n<td>Explique les \u00e9carts et emp\u00eache les fausses certitudes<\/td>\n<td>Note d&rsquo;issue ou journal des \u00e9carts<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>Les gestionnaires de flux de travail, les ordinateurs portables, les scripts et les travaux HPC n\u00e9cessitent des enregistrements diff\u00e9rents<\/h2>\n<p>Toutes les \u00e9quipes de recherche n&rsquo;ont pas besoin du m\u00eame syst\u00e8me de documentation. Un petit ordinateur portable exploratoire, un balayage de param\u00e8tres script\u00e9s, un flux de travail conteneuris\u00e9 et un pipeline HPC en plusieurs \u00e9tapes pr\u00e9sentent des risques de reproductibilit\u00e9 diff\u00e9rents.<\/p>\n<p>Pour les ordinateurs portables, le principal risque est l&rsquo;\u00e9tat cach\u00e9. Les cellules peuvent \u00eatre ex\u00e9cut\u00e9es dans le d\u00e9sordre, les variables interm\u00e9diaires peuvent rester en m\u00e9moire et les chiffres peuvent d\u00e9pendre des \u00e9tapes manuelles. La documentation doit clarifier l&rsquo;ordre d&rsquo;ex\u00e9cution, les donn\u00e9es d&rsquo;entr\u00e9e, les versions des packages et l&rsquo;\u00e9tat final du script ou du bloc-notes utilis\u00e9 pour les r\u00e9sultats rapport\u00e9s.<\/p>\n<p>Pour les scripts ad hoc, le risque est un contexte dispers\u00e9. Une commande peut d\u00e9pendre des chemins d&rsquo;acc\u00e8s locaux, des valeurs par d\u00e9faut non document\u00e9es ou des fichiers en dehors du contr\u00f4le de version. Les \u00e9quipes doivent capturer des exemples de commandes, des fichiers de configuration, une structure de r\u00e9pertoires attendues et des emplacements de sortie.<\/p>\n<p>Pour les gestionnaires de flux de travail, le risque est de supposer que l&rsquo;automatisation est \u00e9gale \u00e0 la compr\u00e9hension. La provenance automatis\u00e9e est pr\u00e9cieuse, mais une documentation lisible par l&rsquo;homme est toujours n\u00e9cessaire pour expliquer pourquoi un flux de travail a \u00e9t\u00e9 configur\u00e9 d&rsquo;une certaine mani\u00e8re.<\/p>\n<p>Pour les courses de HPC, le risque est la d\u00e9rive environnementale. Les param\u00e8tres de file d&rsquo;attente, les modules, les types de n\u0153uds, les choix de parall\u00e9lisation, le stockage temporaire et le comportement de red\u00e9marrage peuvent influer sur le fait qu&rsquo;une ex\u00e9cution est vraiment reproductible sur un autre syst\u00e8me.<\/p>\n<h2>Points faibles communs qui cassent la reproductibilit\u00e9<\/h2>\n<p>La plupart des \u00e9checs de reproductibilit\u00e9 ne sont pas dramatiques. Ce sont de petits \u00e9carts qui s&rsquo;aggravent avec le temps.<\/p>\n<ul>\n<li><strong>Unit\u00e9s manquantes&nbsp;:<\/strong> Une valeur de param\u00e8tre est enregistr\u00e9e, mais son unit\u00e9 ne l&rsquo;est pas.<\/li>\n<li><strong>Origine de param\u00e8tre incertaine&nbsp;:<\/strong> Une valeur s&rsquo;affiche dans un fichier de configuration sans aucune explication quant \u00e0 savoir s&rsquo;il provient de la litt\u00e9rature, de l&rsquo;\u00e9talonnage ou de la commodit\u00e9.<\/li>\n<li><strong>D\u00e9pendances modifi\u00e9es&nbsp;:<\/strong> Un script s&rsquo;ex\u00e9cute toujours, mais une mise \u00e0 jour de la biblioth\u00e8que change de comportement.<\/li>\n<li><strong>Modifications de fichiers manuels&nbsp;:<\/strong> Un jeu de donn\u00e9es corrig\u00e9 est utilis\u00e9, mais la correction n&rsquo;est pas document\u00e9e.<\/li>\n<li><strong>Chiffres d\u00e9tach\u00e9s&nbsp;:<\/strong> Un graphique survit, mais les donn\u00e9es et le script qui l&rsquo;ont cr\u00e9\u00e9 ne sont pas clairs.<\/li>\n<li><strong>Circuits \u00e9chou\u00e9s invisibles&nbsp;:<\/strong> Il ne reste que des sorties r\u00e9ussies, masquant le chemin qui a conduit \u00e0 des choix de param\u00e8tres finaux.<\/li>\n<li><strong>Param\u00e8tres du solveur non document\u00e9&nbsp;:<\/strong> Un r\u00e9sultat d\u00e9pend des tol\u00e9rances, de la r\u00e9solution du maillage ou des crit\u00e8res de convergence qui ne sont pas enregistr\u00e9s.<\/li>\n<\/ul>\n<p>Ces points faibles sont importants parce qu&rsquo;ils rendent l&rsquo;interpr\u00e9tation ult\u00e9rieure fragile. Un futur chercheur peut relancer le flux de travail et obtenir une r\u00e9ponse diff\u00e9rente sans savoir si la diff\u00e9rence est scientifique, num\u00e9rique, environnementale ou proc\u00e9durale.<\/p>\n<h2>Documentation minimale viable pour les \u00e9quipes de recherche<\/h2>\n<p>Une \u00e9quipe n&rsquo;a pas besoin d&rsquo;une infrastructure parfaite avant de pouvoir documenter de mani\u00e8re reproductible. Un enregistrement minimum viable est souvent suffisant pour \u00e9viter les pires pertes de contexte.<\/p>\n<p>Pour de nombreux projets de chimie et de simulation de mat\u00e9riaux, la structure suivante est un point de d\u00e9part r\u00e9aliste :<\/p>\n<ul>\n<li>un Lisez-moi expliquant la question scientifique et la mise en page du flux de travail&nbsp;;<\/li>\n<li>une note de mod\u00e8le r\u00e9pertoriant les hypoth\u00e8ses, les param\u00e8tres, les unit\u00e9s et les crit\u00e8res d&rsquo;acceptation&nbsp;;<\/li>\n<li>un fichier d&rsquo;environnement ou un enregistrement de d\u00e9pendance&nbsp;;<\/li>\n<li>un r\u00e9pertoire de fichiers d&rsquo;entr\u00e9e versionn\u00e9s ;<\/li>\n<li>une commande d&rsquo;ex\u00e9cution enregistr\u00e9e ou une configuration de workflow&nbsp;;<\/li>\n<li>journaux et avertissements d&rsquo;ex\u00e9cution&nbsp;;<\/li>\n<li>un manifeste de sortie qui distingue les fichiers bruts et trait\u00e9s ;<\/li>\n<li>scripts d&rsquo;analyse utilis\u00e9s pour g\u00e9n\u00e9rer des tableaux et des figures ;<\/li>\n<li>une figure cartographique reliant les visuels rapport\u00e9s \u00e0 des donn\u00e9es et des scripts&nbsp;;<\/li>\n<li>Un court journal des \u00e9carts pour les ex\u00e9cutions, les exclusions et les rediffusions.<\/li>\n<\/ul>\n<p>Il ne s&rsquo;agit pas de cr\u00e9er de la paperasse pour elle-m\u00eame. Le but est de rendre le flux de travail compr\u00e9hensible au moment o\u00f9 la m\u00e9moire n&rsquo;est plus fiable.<\/p>\n<h2>La reproductibilit\u00e9 est la m\u00e9moire d&rsquo;\u00e9quipe<\/h2>\n<p>Les flux de travail de simulation survivent souvent \u00e0 la personne qui les a construites en premier. Un chercheur dipl\u00f4m\u00e9 part, une d\u00e9pendance change, un examinateur demande des \u00e9claircissements, un collaborateur interroge un chiffre ou une \u00e9quipe d\u00e9cide d&rsquo;\u00e9tendre un ancien mod\u00e8le \u00e0 un nouveau syst\u00e8me chimique.<\/p>\n<p>Dans ces moments-l\u00e0, la documentation devient la m\u00e9moire d&rsquo;\u00e9quipe. Cela explique non seulement ce qui a \u00e9t\u00e9 ex\u00e9cut\u00e9, mais aussi pourquoi il a \u00e9t\u00e9 ex\u00e9cut\u00e9 de cette fa\u00e7on, ce qui a chang\u00e9 le long du chemin et comment le r\u00e9sultat final doit \u00eatre interpr\u00e9t\u00e9.<\/p>\n<p>Les flux de travail reproductibles les plus solides n&rsquo;archivent pas simplement les artefacts de calcul. Ils pr\u00e9servent la relation entre la revendication scientifique, le mod\u00e8le, l&rsquo;\u00e9tat ex\u00e9cutable, les donn\u00e9es et l&rsquo;interpr\u00e9tation. Cette relation est ce qui permet aux \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux de faire confiance \u00e0 un r\u00e9sultat apr\u00e8s que le contexte d&rsquo;origine s&rsquo;est estomp\u00e9.<\/p>\n","protected":false,"raw":"<p>La reproductibilit\u00e9 dans la chimie et la simulation des mat\u00e9riaux ne consiste pas seulement \u00e0 stocker un script, \u00e0 t\u00e9l\u00e9charger un ensemble de donn\u00e9es ou \u00e0 conserver un dossier de fichiers d'entr\u00e9e. Un flux de travail est reproductible lorsqu'un autre chercheur peut comprendre comment une question scientifique est devenue un mod\u00e8le, comment ce mod\u00e8le est devenu un ex\u00e9cutable, comment l'ex\u00e9cution a produit des r\u00e9sultats et comment ces sorties sont devenues un r\u00e9sultat signal\u00e9.<\/p>\n<p>Cette cha\u00eene est facile \u00e0 casser. Une d\u00e9pendance modifi\u00e9e, un param\u00e8tre de solveur non document\u00e9, un fichier de sortie renomm\u00e9 ou une figure g\u00e9n\u00e9r\u00e9e \u00e0 partir d'une feuille de calcul modifi\u00e9e manuellement peut rendre difficile une analyse par ailleurs pr\u00e9cieuse. Le probl\u00e8me n'est pas toujours une mauvaise science. Souvent, il manque le contexte.<\/p>\n<p>Pour les \u00e9quipes de recherche de chimie et de mat\u00e9riaux informatiques, la documentation doit pr\u00e9server plus que la r\u00e9ponse finale. Il doit pr\u00e9server le raisonnement, la configuration, l'\u00e9tat d'ex\u00e9cution et le chemin d'interpr\u00e9tation qui ont rendu la r\u00e9ponse possible.<\/p>\n<h2>Ce que signifie r\u00e9ellement un flux de travail de simulation reproductible<\/h2>\n<p>Un flux de travail de simulation reproductible est le chemin document\u00e9 de l'intention scientifique au r\u00e9sultat interpr\u00e9table. Il comprend le mod\u00e8le, les entr\u00e9es, l'\u00e9tat du logiciel, l'environnement d'ex\u00e9cution, les donn\u00e9es g\u00e9n\u00e9r\u00e9es, les \u00e9tapes de post-traitement et le raisonnement utilis\u00e9 pour connecter les sorties \u00e0 une revendication.<\/p>\n<p>Dans un contexte de chimie ou de mat\u00e9riaux, cela peut impliquer des structures mol\u00e9culaires, des mod\u00e8les de champ de phase, des hypoth\u00e8ses de r\u00e9action, des potentiels interatomiques, des conditions aux limites, des choix de maillage, des crit\u00e8res de convergence, des param\u00e8tres thermodynamiques ou des param\u00e8tres de solveur num\u00e9rique. En pratique, les \u00e9l\u00e9ments exacts varient selon la m\u00e9thode. Le principe ne le fait pas.<\/p>\n<p>Un flux de travail reproductible devrait permettre \u00e0 un futur lecteur de r\u00e9pondre \u00e0 quatre questions :<\/p>\n<ul>\n<li>Qu'est-ce que la simulation essayait de tester ou de d\u00e9montrer&nbsp;?<\/li>\n<li>Quelles hypoth\u00e8ses et param\u00e8tres ont fa\u00e7onn\u00e9 le r\u00e9sultat&nbsp;?<\/li>\n<li>Quel \u00e9tat de calcul exact a produit la sortie&nbsp;?<\/li>\n<li>Comment les r\u00e9sultats ont-ils \u00e9t\u00e9 transform\u00e9s en interpr\u00e9tation rapport\u00e9e&nbsp;?<\/li>\n<\/ul>\n<p>Sans ces r\u00e9ponses, un r\u00e9sultat peut toujours \u00eatre int\u00e9ressant, mais il est plus difficile de faire confiance, de comparer, d'\u00e9tendre ou de d\u00e9boguer.<\/p>\n<h2>La cha\u00eene de documentation des revendications \u00e0 ex\u00e9cuter<\/h2>\n<p>Le moyen le plus utile de documenter le travail de simulation est de commencer par la revendication que le flux de travail prend en charge et de remonter jusqu'\u00e0 la course qui l'a produit. Cela \u00e9vite un \u00e9chec de documentation courant : pr\u00e9server les fragments techniques sans montrer comment ils se connectent.<\/p>\n<p>La cha\u00eene de revendications \u00e0 ex\u00e9cuter a cinq couches.<\/p>\n<h3>1. La couche de revendication<\/h3>\n<p>Cette couche enregistre la conclusion, la figure, la tendance, la comparaison ou la propri\u00e9t\u00e9 que le flux de travail est cens\u00e9 prendre en charge. Il doit indiquer le r\u00e9sultat de la simulation utilis\u00e9 pour argumenter, et non seulement le fichier g\u00e9n\u00e9r\u00e9.<\/p>\n<p>Par exemple, un flux de travail peut prendre en charge une affirmation concernant le comportement de diffusion, la stabilit\u00e9 de phase, l'\u00e9nergie de formation de d\u00e9fauts, les effets de solvant, l'\u00e9volution de la morphologie ou les performances relatives de deux configurations de mod\u00e8le. La documentation doit rendre ce but visible.<\/p>\n<h3>2. Le calque du mod\u00e8le<\/h3>\n<p>Cette couche explique la repr\u00e9sentation scientifique et math\u00e9matique derri\u00e8re la course. Il comprend des hypoth\u00e8ses, des \u00e9quations r\u00e9gissant, des approximations, des limites de mod\u00e8les, des param\u00e8tres s\u00e9lectionn\u00e9s et des simplifications connues.<\/p>\n<p>Le but n'est pas d'\u00e9crire un manuel dans chaque dossier de projet. L'objectif est de laisser suffisamment de contexte pour qu'un autre membre de l'\u00e9quipe puisse voir pourquoi ce mod\u00e8le a \u00e9t\u00e9 choisi et o\u00f9 ses limites commencent.<\/p>\n<h3>3. La couche d'ex\u00e9cution<\/h3>\n<p>Cette couche capture l'\u00e9tat de calcul de l'ex\u00e9cution&nbsp;: versions du logiciel, validations, d\u00e9pendances, fichiers d'environnement, configuration des t\u00e2ches, contexte mat\u00e9riel, graines al\u00e9atoires et journaux d'ex\u00e9cution.<\/p>\n<p>Les d\u00e9tails d'ex\u00e9cution sont souvent trait\u00e9s comme un bruit administratif jusqu'\u00e0 ce que quelque chose change. Ensuite, ils deviennent le seul moyen d'expliquer pourquoi une rediffusion diff\u00e8re de l'original.<\/p>\n<h3>4. La couche de donn\u00e9es<\/h3>\n<p>Cette couche pr\u00e9serve les sorties brutes, les sorties d\u00e9riv\u00e9es, les m\u00e9tadonn\u00e9es, les conventions de nommage, les unit\u00e9s, les transformations et les relations de fichiers. Il doit \u00eatre clair quels fichiers sont des produits de simulation directe et lesquels ont \u00e9t\u00e9 cr\u00e9\u00e9s par analyse ou filtrage.<\/p>\n<h3>5. La couche d'interpr\u00e9tation<\/h3>\n<p>Cette couche relie les sorties \u00e0 l'interpr\u00e9tation scientifique finale. Il comprend des scripts d'analyse, du code de tra\u00e7age, des ex\u00e9cutions exclues, des \u00e9checs, des d\u00e9cisions manuelles, des notes de probl\u00e8mes et des \u00e9tapes de g\u00e9n\u00e9ration de chiffres.<\/p>\n<p>C'est l\u00e0 que de nombreux workflows perdent leur reproductibilit\u00e9. La simulation peut \u00eatre r\u00e9examin\u00e9e, mais le chiffre ou la conclusion rapport\u00e9s peuvent ne pas \u00eatre tra\u00e7ables.<\/p>\n<h2>Quoi documenter avant la course<\/h2>\n<p>La documentation en pr\u00e9-ex\u00e9cution doit expliquer pourquoi la simulation existe et quelles conditions d\u00e9finissent un r\u00e9sultat significatif. Ceci est particuli\u00e8rement important lorsqu'un flux de travail sera r\u00e9examin\u00e9 apr\u00e8s un brouillon de papier, un changement de code, un commentaire d'examen par les pairs ou un transfert d'\u00e9quipe.<\/p>\n<p>Au minimum, les \u00e9quipes doivent documenter la question de recherche, le syst\u00e8me chimique ou des mat\u00e9riaux, l'approche de mod\u00e9lisation, les hypoth\u00e8ses formul\u00e9es et les crit\u00e8res utilis\u00e9s pour juger si la course a r\u00e9ussi.<\/p>\n<p>Pour la recherche sur la chimie et les mat\u00e9riaux, cela signifie souvent enregistrer :<\/p>\n<ul>\n<li>Composition, structure, g\u00e9om\u00e9trie ou description de phase du syst\u00e8me;<\/li>\n<li>hypoth\u00e8ses de mod\u00e8les et simplifications connues&nbsp;;<\/li>\n<li>conditions initiales et limites ;<\/li>\n<li>unit\u00e9s et sources de param\u00e8tres&nbsp;;<\/li>\n<li>Param\u00e8tres de solveur, de discr\u00e9tisation, de maillage ou de convergence&nbsp;;<\/li>\n<li>Crit\u00e8res d'acceptation pour un r\u00e9sultat stable ou utilisable ;<\/li>\n<li>r\u00e9sultats attendus et comment ils seront interpr\u00e9t\u00e9s.<\/li>\n<\/ul>\n<p>Cette information n'a pas besoin d'\u00eatre longue. Un fichier de lecture concise, une note d'ex\u00e9cution structur\u00e9e ou un mod\u00e8le de projet peut suffire s'il capture les d\u00e9cisions qui sont par ailleurs faciles \u00e0 oublier.<\/p>\n<h2>Que capturer lors de l'ex\u00e9cution<\/h2>\n<p>La documentation d'ex\u00e9cution est la partie de la reproductibilit\u00e9 qui semble souvent routini\u00e8re jusqu'\u00e0 ce qu'elle soit manquante. Une simulation peut produire une sortie en apparence valide tout en masquant les avertissements, les changements de d\u00e9pendance, les interruptions du planificateur, les chemins d'entr\u00e9e modifi\u00e9s ou le comportement de repli silencieux.<\/p>\n<p>L'enregistrement d'ex\u00e9cution doit inclure l'\u00e9tat exact du logiciel utilis\u00e9 pour l'ex\u00e9cution. Cela signifie que les num\u00e9ros de version, le r\u00e9f\u00e9rentiel valident, le cas \u00e9ch\u00e9ant, les fichiers de d\u00e9pendance, les fichiers de configuration, les arguments de ligne de commande et les d\u00e9tails de l'environnement. Pour les syst\u00e8mes HPC ou partag\u00e9s, les param\u00e8tres du planificateur et l'allocation des ressources peuvent \u00e9galement avoir une importance.<\/p>\n<p>Lorsque des r\u00e9sultats inattendus apparaissent, ces enregistrements font partie du processus de diagnostic. Les \u00e9quipes qui traitent <a href=\"https:\/\/matforge.org\/reproducibility-and-its-role-in-debugging\/\">reproductibilit\u00e9 comme une aide de d\u00e9bogage pratique<\/a> sont g\u00e9n\u00e9ralement mieux plac\u00e9es pour d\u00e9terminer si un changement provenait du mod\u00e8le, des donn\u00e9es, du logiciel ou de l'environnement d'ex\u00e9cution.<\/p>\n<p>Les journaux ne doivent pas \u00eatre \u00e9cart\u00e9s trop rapidement. Les avertissements, les messages de convergence, les diagnostics de solveur, les erreurs d'ex\u00e9cution et le comportement de red\u00e9marrage peuvent expliquer pourquoi un r\u00e9sultat doit \u00eatre approuv\u00e9, r\u00e9p\u00e9t\u00e9 ou exclu.<\/p>\n<h2>Que conserver apr\u00e8s la course<\/h2>\n<p>La documentation post-ex\u00e9cution doit rendre la voie de sortie visible. Un flux de travail reproductible ne s'arr\u00eate pas \u00e0 la fin de la simulation. Cela se termine lorsque l'\u00e9quipe peut montrer comment les sorties brutes sont devenues des donn\u00e9es, des chiffres, des tableaux ou des revendications.<\/p>\n<p>Conservez les sorties brutes s\u00e9par\u00e9ment des sorties trait\u00e9es. Gardez les scripts d'analyse \u00e0 proximit\u00e9 des donn\u00e9es qu'ils transforment. Enregistrer les unit\u00e9s, les filtres, les choix de lissage, les seuils et les cas exclus. Si une figure appara\u00eet dans un rapport ou un manuscrit, le flux de travail doit indiquer quel ex\u00e9cution, script et ensemble de donn\u00e9es l'ont produit.<\/p>\n<p>Les courses rat\u00e9es m\u00e9ritent \u00e9galement un record. Une simulation \u00e9chou\u00e9e peut expliquer pourquoi les param\u00e8tres ont chang\u00e9, pourquoi un mod\u00e8le a \u00e9t\u00e9 r\u00e9duit ou pourquoi un r\u00e9sultat a \u00e9t\u00e9 r\u00e9ex\u00e9cut\u00e9 ult\u00e9rieurement. Lorsque les anomalies ou les rediffusions affectent l'interpr\u00e9tation, cela aide \u00e0 pr\u00e9server la connexion entre la sortie et la d\u00e9cision de l'\u00e9quipe qui a suivi, y compris <a href=\"https:\/\/matforge.org\/linking-simulation-results-to-reported-issues\/\">Connexion des r\u00e9sultats de simulation \u00e0 l'historique des probl\u00e8mes derri\u00e8re eux<\/a>.<\/p>\n<blockquote>\n<p><strong>Test utile&nbsp;:<\/strong> Si un chiffre ne peut pas \u00eatre r\u00e9g\u00e9n\u00e9r\u00e9 \u00e0 partir d'entr\u00e9es, de scripts et de sorties document\u00e9es, le flux de travail n'est pas enti\u00e8rement document\u00e9 m\u00eame si l'image finale est enregistr\u00e9e.<\/p>\n<\/blockquote>\n<h2>Une carte de documentation pratique<\/h2>\n<table class=\"custom-table\">\n<tbody><tr>\n<th>\u00c9tape du flux de travail<\/th>\n<th>Quoi documenter<\/th>\n<th>Pourquoi c'est important<\/th>\n<th>Enregistrement minimum acceptable<\/th>\n<\/tr>\n<tr>\n<td>Cadre scientifique<\/td>\n<td>Question, revendication, syst\u00e8me, sortie attendue<\/td>\n<td>Montre pourquoi la simulation a \u00e9t\u00e9 ex\u00e9cut\u00e9e<\/td>\n<td>Note de projet courte ou section Lisez-moi<\/td>\n<\/tr>\n<tr>\n<td>Configuration du mod\u00e8le<\/td>\n<td>Hypoth\u00e8ses, \u00e9quations, param\u00e8tres, conditions aux limites<\/td>\n<td>Rend la base scientifique inspectable<\/td>\n<td>Note de mod\u00e8le avec unit\u00e9s et sources de param\u00e8tres<\/td>\n<\/tr>\n<tr>\n<td>Ex\u00e9cution<\/td>\n<td>Version du logiciel, validation, d\u00e9pendances, environnement, commande, journaux<\/td>\n<td>Permet les rediffusions et le d\u00e9bogage<\/td>\n<td>Fichier d'environnement, ex\u00e9cution de la commande, journaux enregistr\u00e9s<\/td>\n<\/tr>\n<tr>\n<td>Sorties<\/td>\n<td>Fichiers bruts, fichiers d\u00e9riv\u00e9s, m\u00e9tadonn\u00e9es, conventions de d\u00e9nomination<\/td>\n<td>Emp\u00eache la confusion entre les donn\u00e9es originales et trait\u00e9es<\/td>\n<td>Manifeste de sortie avec descriptions de fichiers<\/td>\n<\/tr>\n<tr>\n<td>Une analyse<\/td>\n<td>Scripts, filtres, transformations, \u00e9tapes de tra\u00e7age<\/td>\n<td>Connecter les donn\u00e9es aux chiffres et conclusions<\/td>\n<td>Script d'analyse et carte de la figure<\/td>\n<\/tr>\n<tr>\n<td>Exceptions<\/td>\n<td>Ex\u00e9cutions \u00e9chou\u00e9es, exclusions, avertissements, corrections manuelles<\/td>\n<td>Explique les \u00e9carts et emp\u00eache les fausses certitudes<\/td>\n<td>Note d'issue ou journal des \u00e9carts<\/td>\n<\/tr>\n<\/tbody><\/table>\n<h2>Les gestionnaires de flux de travail, les ordinateurs portables, les scripts et les travaux HPC n\u00e9cessitent des enregistrements diff\u00e9rents<\/h2>\n<p>Toutes les \u00e9quipes de recherche n'ont pas besoin du m\u00eame syst\u00e8me de documentation. Un petit ordinateur portable exploratoire, un balayage de param\u00e8tres script\u00e9s, un flux de travail conteneuris\u00e9 et un pipeline HPC en plusieurs \u00e9tapes pr\u00e9sentent des risques de reproductibilit\u00e9 diff\u00e9rents.<\/p>\n<p>Pour les ordinateurs portables, le principal risque est l'\u00e9tat cach\u00e9. Les cellules peuvent \u00eatre ex\u00e9cut\u00e9es dans le d\u00e9sordre, les variables interm\u00e9diaires peuvent rester en m\u00e9moire et les chiffres peuvent d\u00e9pendre des \u00e9tapes manuelles. La documentation doit clarifier l'ordre d'ex\u00e9cution, les donn\u00e9es d'entr\u00e9e, les versions des packages et l'\u00e9tat final du script ou du bloc-notes utilis\u00e9 pour les r\u00e9sultats rapport\u00e9s.<\/p>\n<p>Pour les scripts ad hoc, le risque est un contexte dispers\u00e9. Une commande peut d\u00e9pendre des chemins d'acc\u00e8s locaux, des valeurs par d\u00e9faut non document\u00e9es ou des fichiers en dehors du contr\u00f4le de version. Les \u00e9quipes doivent capturer des exemples de commandes, des fichiers de configuration, une structure de r\u00e9pertoires attendues et des emplacements de sortie.<\/p>\n<p>Pour les gestionnaires de flux de travail, le risque est de supposer que l'automatisation est \u00e9gale \u00e0 la compr\u00e9hension. La provenance automatis\u00e9e est pr\u00e9cieuse, mais une documentation lisible par l'homme est toujours n\u00e9cessaire pour expliquer pourquoi un flux de travail a \u00e9t\u00e9 configur\u00e9 d'une certaine mani\u00e8re.<\/p>\n<p>Pour les courses de HPC, le risque est la d\u00e9rive environnementale. Les param\u00e8tres de file d'attente, les modules, les types de n\u0153uds, les choix de parall\u00e9lisation, le stockage temporaire et le comportement de red\u00e9marrage peuvent influer sur le fait qu'une ex\u00e9cution est vraiment reproductible sur un autre syst\u00e8me.<\/p>\n<h2>Points faibles communs qui cassent la reproductibilit\u00e9<\/h2>\n<p>La plupart des \u00e9checs de reproductibilit\u00e9 ne sont pas dramatiques. Ce sont de petits \u00e9carts qui s'aggravent avec le temps.<\/p>\n<ul>\n<li><strong>Unit\u00e9s manquantes&nbsp;:<\/strong> Une valeur de param\u00e8tre est enregistr\u00e9e, mais son unit\u00e9 ne l'est pas.<\/li>\n<li><strong>Origine de param\u00e8tre incertaine&nbsp;:<\/strong> Une valeur s'affiche dans un fichier de configuration sans aucune explication quant \u00e0 savoir s'il provient de la litt\u00e9rature, de l'\u00e9talonnage ou de la commodit\u00e9.<\/li>\n<li><strong>D\u00e9pendances modifi\u00e9es&nbsp;:<\/strong> Un script s'ex\u00e9cute toujours, mais une mise \u00e0 jour de la biblioth\u00e8que change de comportement.<\/li>\n<li><strong>Modifications de fichiers manuels&nbsp;:<\/strong> Un jeu de donn\u00e9es corrig\u00e9 est utilis\u00e9, mais la correction n'est pas document\u00e9e.<\/li>\n<li><strong>Chiffres d\u00e9tach\u00e9s&nbsp;:<\/strong> Un graphique survit, mais les donn\u00e9es et le script qui l'ont cr\u00e9\u00e9 ne sont pas clairs.<\/li>\n<li><strong>Circuits \u00e9chou\u00e9s invisibles&nbsp;:<\/strong> Il ne reste que des sorties r\u00e9ussies, masquant le chemin qui a conduit \u00e0 des choix de param\u00e8tres finaux.<\/li>\n<li><strong>Param\u00e8tres du solveur non document\u00e9&nbsp;:<\/strong> Un r\u00e9sultat d\u00e9pend des tol\u00e9rances, de la r\u00e9solution du maillage ou des crit\u00e8res de convergence qui ne sont pas enregistr\u00e9s.<\/li>\n<\/ul>\n<p>Ces points faibles sont importants parce qu'ils rendent l'interpr\u00e9tation ult\u00e9rieure fragile. Un futur chercheur peut relancer le flux de travail et obtenir une r\u00e9ponse diff\u00e9rente sans savoir si la diff\u00e9rence est scientifique, num\u00e9rique, environnementale ou proc\u00e9durale.<\/p>\n<h2>Documentation minimale viable pour les \u00e9quipes de recherche<\/h2>\n<p>Une \u00e9quipe n'a pas besoin d'une infrastructure parfaite avant de pouvoir documenter de mani\u00e8re reproductible. Un enregistrement minimum viable est souvent suffisant pour \u00e9viter les pires pertes de contexte.<\/p>\n<p>Pour de nombreux projets de chimie et de simulation de mat\u00e9riaux, la structure suivante est un point de d\u00e9part r\u00e9aliste :<\/p>\n<ul>\n<li>un Lisez-moi expliquant la question scientifique et la mise en page du flux de travail&nbsp;;<\/li>\n<li>une note de mod\u00e8le r\u00e9pertoriant les hypoth\u00e8ses, les param\u00e8tres, les unit\u00e9s et les crit\u00e8res d'acceptation&nbsp;;<\/li>\n<li>un fichier d'environnement ou un enregistrement de d\u00e9pendance&nbsp;;<\/li>\n<li>un r\u00e9pertoire de fichiers d'entr\u00e9e versionn\u00e9s ;<\/li>\n<li>une commande d'ex\u00e9cution enregistr\u00e9e ou une configuration de workflow&nbsp;;<\/li>\n<li>journaux et avertissements d'ex\u00e9cution&nbsp;;<\/li>\n<li>un manifeste de sortie qui distingue les fichiers bruts et trait\u00e9s ;<\/li>\n<li>scripts d'analyse utilis\u00e9s pour g\u00e9n\u00e9rer des tableaux et des figures ;<\/li>\n<li>une figure cartographique reliant les visuels rapport\u00e9s \u00e0 des donn\u00e9es et des scripts&nbsp;;<\/li>\n<li>Un court journal des \u00e9carts pour les ex\u00e9cutions, les exclusions et les rediffusions.<\/li>\n<\/ul>\n<p>Il ne s'agit pas de cr\u00e9er de la paperasse pour elle-m\u00eame. Le but est de rendre le flux de travail compr\u00e9hensible au moment o\u00f9 la m\u00e9moire n'est plus fiable.<\/p>\n<h2>La reproductibilit\u00e9 est la m\u00e9moire d'\u00e9quipe<\/h2>\n<p>Les flux de travail de simulation survivent souvent \u00e0 la personne qui les a construites en premier. Un chercheur dipl\u00f4m\u00e9 part, une d\u00e9pendance change, un examinateur demande des \u00e9claircissements, un collaborateur interroge un chiffre ou une \u00e9quipe d\u00e9cide d'\u00e9tendre un ancien mod\u00e8le \u00e0 un nouveau syst\u00e8me chimique.<\/p>\n<p>Dans ces moments-l\u00e0, la documentation devient la m\u00e9moire d'\u00e9quipe. Cela explique non seulement ce qui a \u00e9t\u00e9 ex\u00e9cut\u00e9, mais aussi pourquoi il a \u00e9t\u00e9 ex\u00e9cut\u00e9 de cette fa\u00e7on, ce qui a chang\u00e9 le long du chemin et comment le r\u00e9sultat final doit \u00eatre interpr\u00e9t\u00e9.<\/p>\n<p>Les flux de travail reproductibles les plus solides n'archivent pas simplement les artefacts de calcul. Ils pr\u00e9servent la relation entre la revendication scientifique, le mod\u00e8le, l'\u00e9tat ex\u00e9cutable, les donn\u00e9es et l'interpr\u00e9tation. Cette relation est ce qui permet aux \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux de faire confiance \u00e0 un r\u00e9sultat apr\u00e8s que le contexte d'origine s'est estomp\u00e9.<\/p>\n"},"excerpt":{"rendered":"<p><span class=\"span-reading-time rt-reading-time\" style=\"display: block;\"><span class=\"rt-label rt-prefix\">Reading Time: <\/span> <span class=\"rt-time\"> 8<\/span> <span class=\"rt-label rt-postfix\">minutes<\/span><\/span>La reproductibilit\u00e9 dans la chimie et la simulation des mat\u00e9riaux ne consiste pas seulement \u00e0 stocker un script, \u00e0 t\u00e9l\u00e9charger un ensemble de donn\u00e9es ou \u00e0 conserver un dossier de fichiers d&rsquo;entr\u00e9e. Un flux de travail est reproductible lorsqu&rsquo;un autre chercheur peut comprendre comment une question scientifique est devenue un mod\u00e8le, comment ce mod\u00e8le est [&hellip;]<\/p>\n","protected":false,"raw":""},"author":2,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_locale":"fr_FR","_original_post":"https:\/\/matforge.org\/?p=323","iawp_total_views":3,"footnotes":""},"categories":[1],"tags":[],"class_list":["post-1254","post","type-post","status-publish","format-standard","hentry","category-simulation-modeling-projects","fr-FR"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v28.3 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Flux de travail de simulation reproductible\u00a0: que documenter<\/title>\n<meta name=\"description\" content=\"Un guide pratique pour les \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux sur la documentation des flux de travail de simulation, du choix du mod\u00e8le aux r\u00e9sultats rapport\u00e9s.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/\" \/>\n<meta property=\"og:locale\" content=\"fr_FR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Flux de travail de simulation reproductible\u00a0: que documenter\" \/>\n<meta property=\"og:description\" content=\"Un guide pratique pour les \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux sur la documentation des flux de travail de simulation, du choix du mod\u00e8le aux r\u00e9sultats rapport\u00e9s.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/\" \/>\n<meta property=\"og:site_name\" content=\"matforge.org\" \/>\n<meta property=\"article:published_time\" content=\"2026-08-21T14:31:45+00:00\" \/>\n<meta name=\"author\" content=\"Elena Markovska\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"\u00c9crit par\" \/>\n\t<meta name=\"twitter:data1\" content=\"Elena Markovska\" \/>\n\t<meta name=\"twitter:label2\" content=\"Dur\u00e9e de lecture estim\u00e9e\" \/>\n\t<meta name=\"twitter:data2\" content=\"14 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/#article\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/\"},\"author\":{\"name\":\"Elena Markovska\",\"@id\":\"https:\\\/\\\/matforge.org\\\/#\\\/schema\\\/person\\\/980162bb5de46742daece973661d93da\"},\"headline\":\"Flux de travail de simulation reproductible dans la recherche sur la chimie et les mat\u00e9riaux\u00a0: quelles \u00e9quipes doivent documenter\",\"datePublished\":\"2026-08-21T14:31:45+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/\"},\"wordCount\":2821,\"commentCount\":0,\"articleSection\":[\"Simulation &amp; Projets de mod\u00e9lisation\"],\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/\",\"url\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/\",\"name\":\"Flux de travail de simulation reproductible\u00a0: que documenter\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/matforge.org\\\/#website\"},\"datePublished\":\"2026-08-21T14:31:45+00:00\",\"author\":{\"@id\":\"https:\\\/\\\/matforge.org\\\/#\\\/schema\\\/person\\\/980162bb5de46742daece973661d93da\"},\"description\":\"Un guide pratique pour les \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux sur la documentation des flux de travail de simulation, du choix du mod\u00e8le aux r\u00e9sultats rapport\u00e9s.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/#breadcrumb\"},\"inLanguage\":\"fr-FR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/matforge.org\\\/fr\\\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/matforge.org\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Flux de travail de simulation reproductible dans la recherche sur la chimie et les mat\u00e9riaux\u00a0: quelles \u00e9quipes doivent documenter\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/matforge.org\\\/#website\",\"url\":\"https:\\\/\\\/matforge.org\\\/\",\"name\":\"matforge.org\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/matforge.org\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"fr-FR\"},{\"@type\":\"Person\",\"@id\":\"https:\\\/\\\/matforge.org\\\/#\\\/schema\\\/person\\\/980162bb5de46742daece973661d93da\",\"name\":\"Elena Markovska\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"fr-FR\",\"@id\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/2de4e35b6581d7d8a839335156c6b5834cfaa0aef537a1c837e882dc57eea1e7?s=96&d=mm&r=g\",\"url\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/2de4e35b6581d7d8a839335156c6b5834cfaa0aef537a1c837e882dc57eea1e7?s=96&d=mm&r=g\",\"contentUrl\":\"https:\\\/\\\/secure.gravatar.com\\\/avatar\\\/2de4e35b6581d7d8a839335156c6b5834cfaa0aef537a1c837e882dc57eea1e7?s=96&d=mm&r=g\",\"caption\":\"Elena Markovska\"},\"sameAs\":[\"http:\\\/\\\/matforge.org\"],\"url\":\"https:\\\/\\\/matforge.org\\\/author\\\/elena-markovska\\\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Flux de travail de simulation reproductible\u00a0: que documenter","description":"Un guide pratique pour les \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux sur la documentation des flux de travail de simulation, du choix du mod\u00e8le aux r\u00e9sultats rapport\u00e9s.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/","og_locale":"fr_FR","og_type":"article","og_title":"Flux de travail de simulation reproductible\u00a0: que documenter","og_description":"Un guide pratique pour les \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux sur la documentation des flux de travail de simulation, du choix du mod\u00e8le aux r\u00e9sultats rapport\u00e9s.","og_url":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/","og_site_name":"matforge.org","article_published_time":"2026-08-21T14:31:45+00:00","author":"Elena Markovska","twitter_card":"summary_large_image","twitter_misc":{"\u00c9crit par":"Elena Markovska","Dur\u00e9e de lecture estim\u00e9e":"14 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/#article","isPartOf":{"@id":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/"},"author":{"name":"Elena Markovska","@id":"https:\/\/matforge.org\/#\/schema\/person\/980162bb5de46742daece973661d93da"},"headline":"Flux de travail de simulation reproductible dans la recherche sur la chimie et les mat\u00e9riaux\u00a0: quelles \u00e9quipes doivent documenter","datePublished":"2026-08-21T14:31:45+00:00","mainEntityOfPage":{"@id":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/"},"wordCount":2821,"commentCount":0,"articleSection":["Simulation &amp; Projets de mod\u00e9lisation"],"inLanguage":"fr-FR","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/","url":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/","name":"Flux de travail de simulation reproductible\u00a0: que documenter","isPartOf":{"@id":"https:\/\/matforge.org\/#website"},"datePublished":"2026-08-21T14:31:45+00:00","author":{"@id":"https:\/\/matforge.org\/#\/schema\/person\/980162bb5de46742daece973661d93da"},"description":"Un guide pratique pour les \u00e9quipes de recherche sur la chimie et les mat\u00e9riaux sur la documentation des flux de travail de simulation, du choix du mod\u00e8le aux r\u00e9sultats rapport\u00e9s.","breadcrumb":{"@id":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/#breadcrumb"},"inLanguage":"fr-FR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/matforge.org\/fr\/reproducible-simulation-workflows-in-chemistry-and-materials-research-what-teams-should-document\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/matforge.org\/"},{"@type":"ListItem","position":2,"name":"Flux de travail de simulation reproductible dans la recherche sur la chimie et les mat\u00e9riaux\u00a0: quelles \u00e9quipes doivent documenter"}]},{"@type":"WebSite","@id":"https:\/\/matforge.org\/#website","url":"https:\/\/matforge.org\/","name":"matforge.org","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/matforge.org\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"fr-FR"},{"@type":"Person","@id":"https:\/\/matforge.org\/#\/schema\/person\/980162bb5de46742daece973661d93da","name":"Elena Markovska","image":{"@type":"ImageObject","inLanguage":"fr-FR","@id":"https:\/\/secure.gravatar.com\/avatar\/2de4e35b6581d7d8a839335156c6b5834cfaa0aef537a1c837e882dc57eea1e7?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/2de4e35b6581d7d8a839335156c6b5834cfaa0aef537a1c837e882dc57eea1e7?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/2de4e35b6581d7d8a839335156c6b5834cfaa0aef537a1c837e882dc57eea1e7?s=96&d=mm&r=g","caption":"Elena Markovska"},"sameAs":["http:\/\/matforge.org"],"url":"https:\/\/matforge.org\/author\/elena-markovska\/"}]}},"_links":{"self":[{"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/posts\/1254","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/comments?post=1254"}],"version-history":[{"count":1,"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/posts\/1254\/revisions"}],"predecessor-version":[{"id":1436,"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/posts\/1254\/revisions\/1436"}],"wp:attachment":[{"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/media?parent=1254"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/categories?post=1254"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/matforge.org\/wp-json\/wp\/v2\/tags?post=1254"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}