Documentation & FAQ.
Tout ce qu'il faut savoir pour démarrer avec DosiPlot, comprendre nos choix techniques, et trouver une réponse rapide aux questions fréquentes. Pour les concepts dosimétriques approfondis, consultez nos articles du blog.
Démarrage rapide
DosiPlot est utilisable en quelques secondes, sans installation lourde ni inscription. Trois chemins selon votre contexte :
- Version Web — la plus simple. Allez sur /tools/dosiplot/web, l'application se charge dans le navigateur. Une fois chargée, elle fonctionne hors-ligne. Aucun compte requis.
- Version Desktop (Windows)— recommandée pour les salles de TP. Téléchargez l'installeur depuis /tools/dosiplot (~15 MB), exécutez-le, lancez l'application. Aucune dépendance externe (Python, MATLAB, etc.) n'est requise.
- Version Android — en cours de validation. Sera publiée sur Google Play courant 2026.
À l'ouverture, l'interface présente la liste des modules disponibles dans le panneau de gauche. Cliquez sur un module pour afficher la courbe correspondante. Utilisez les sélecteurs en haut pour changer d'énergie ou de taille de champ. Survolez la courbe avec la souris pour lire les valeurs point par point.
Les 8 modules de DosiPlot v5.1
1 — PDD Photons
Affiche la courbe de rendement en profondeur pour un faisceau de photons. Sélectionnez l'énergie (6, 10, 15, 18 MV) et la taille du champ. Les marqueurs caractéristiques (build-up, d_max, décroissance exponentielle) sont visibles directement sur la courbe.
2 — Profils Photons
Distribution latérale de dose à différentes profondeurs. Permet d'évaluer visuellement la planéité, la symétrie et la pénombred'un faisceau — paramètres clés du contrôle qualité d'un accélérateur.
3 — PDD Électrons
Rendement en profondeur pour un faisceau d'électrons. Allure très différente des photons : dose en surface élevée, montée rapide jusqu'à d_max, chute brutale après d_max, traîne due au rayonnement de freinage (bremsstrahlung).
4 — Profils Électrons
Profils latéraux pour les faisceaux d'électrons, à différentes profondeurs. Pénombre plus large qu'en photons, divergence visible sous l'applicateur.
5 — Comparaison multi-courbes
Superposition de plusieurs configurations (énergies différentes, tailles de champ différentes) sur le même graphe. Idéal pour répondre à des questions comme : comment évolue d_max quand on passe de 6 à 18 MV ?
6 — Calculateur TRS-398
Calcul automatique du TPR₂₀/₁₀ et de l'énergie moyenne E₀ à partir des courbes PDD. Le module suit le formalisme de l'IAEA TRS-398, l'un des protocoles les plus utilisés pour la calibration absolue des faisceaux en radiothérapie.
7 — TP1 — Photons
Travaux pratiques guidés pour les faisceaux de photons. Une suite d'exercices courts : identifier le d_max, comparer deux énergies, mesurer la pénombre. Mode enseignant configurable.
8 — TP2 — Électrons
Pendant du TP1 pour les électrons. Couvre les notions spécifiques : dose en surface, R85 (profondeur thérapeutique), R50, traîne de bremsstrahlung.
Questions fréquentes
Est-ce que DosiPlot peut être utilisé pour la planification clinique réelle ?
Non. DosiPlot est exclusivement conçu pour l'enseignement et l'auto-formation. Aucune décision clinique (prescription, calcul de dose patient, validation de plan) ne doit s'appuyer sur ses données. Pour la pratique clinique, utilisez un système de planification (TPS) certifié et qualifié sur votre installation.
D'où viennent les courbes affichées dans DosiPlot ?
Toutes les courbes (PDD photons, PDD électrons, profils latéraux) proviennent de simulations Monte Carlo réalisées avec le code PRIMO, en fantôme d'eau homogène, SSD 100 cm. Chaque configuration utilise au minimum 10⁷ histoires de particules, ce qui garantit une incertitude relative inférieure à 1 % dans la zone d'intérêt clinique.
Quelles énergies sont disponibles ?
Côté photons : 6 MV, 10 MV, 15 MV et 18 MV (faisceaux d'accélérateur linéaire médical). Côté électrons : 6 MeV, 9 MeV, 12 MeV, 15 MeV et 18 MeV. Pour chaque énergie, plusieurs tailles de champ standards sont fournies (3×3 jusqu'à 40×40 cm² selon la modalité).
Faut-il une connexion internet pour utiliser DosiPlot ?
Non. Une fois la version desktop installée (ou la version web chargée une fois), DosiPlot fonctionne entièrement hors-ligne. Les données dosimétriques sont embarquées dans l'application, aucun appel réseau n'est nécessaire pour les consulter ou les comparer.
L'application est-elle vraiment gratuite ?
Oui, et elle le restera. DosiPlot est distribué sous licence Creative Commons BY-NC 4.0, ce qui autorise l'utilisation, la modification et la redistribution tant qu'elles restent non-commerciales et que la paternité du projet est mentionnée. Aucun abonnement, aucune publicité dans l'application.
Comment exporter les données pour les retraiter dans Python ou Excel ?
Chaque module qui affiche une courbe propose un export CSV. Le fichier exporté contient deux colonnes (profondeur ou position latérale, dose relative en %), prêt à être ouvert dans Excel, Pandas, MATLAB ou Origin pour des analyses complémentaires.
Puis-je importer mes propres mesures ou un plan DICOM-RT ?
Pas pour le moment. L'importation DICOM-RT et la génération de DVH font partie de notre roadmap (version 6, prévue pour le second semestre 2026). À ce jour, DosiPlot affiche uniquement des données de référence pré-calculées.
Le mode TP est-il adapté à un cours universitaire ?
Oui, c'est sa raison d'être. TP1 (photons) et TP2 (électrons) proposent un parcours pédagogique en plusieurs étapes : observation de courbes, mesure de paramètres caractéristiques (d_max, D₁₀, profondeur thérapeutique), calculs guidés. Un mode enseignant permet de paramétrer les exercices distribués aux étudiants.
DosiPlot est-il disponible en arabe ?
Oui. L'interface est traduite intégralement en français, anglais et arabe (avec support RTL). Les articles du blog sont également publiés dans ces trois langues.
Comment signaler un bug ou suggérer une fonctionnalité ?
Utilisez le formulaire de contact (rubrique « Bug » ou « Suggestion ») ou écrivez directement à dosiplot@gmail.com. Chaque retour est lu personnellement par l'équipe et alimente la prochaine version.
Glossaire dosimétrique
Les termes essentiels que vous croiserez dans DosiPlot et dans les articles du blog. Trilingue : chaque définition est valable en français, anglais et arabe.
Rendement en profondeur. Courbe représentant la dose absorbée en fonction de la profondeur dans un fantôme d'eau, normalisée à la dose maximale (100 % à d_max). C'est l'une des courbes fondamentales de la dosimétrie d'un faisceau.
Profondeur de la dose maximale. Pour les photons, d_max augmente avec l'énergie (≈ 1.5 cm à 6 MV, ≈ 3.3 cm à 18 MV). Pour les électrons, d_max dépend de l'énergie nominale et de la profondeur thérapeutique R85.
Distribution de dose mesurée perpendiculairement à l'axe du faisceau, à une profondeur donnée. Permet d'évaluer la planéité, la symétrie et la pénombre du champ.
Tissue-Phantom Ratio à 20 cm sur 10 cm. Indicateur de qualité de faisceau photons défini par le protocole IAEA TRS-398, utilisé pour la calibration absolue d'un faisceau.
Pour un faisceau d'électrons, énergie moyenne à la surface du fantôme. Sert à choisir les coefficients de stopping power lors d'une calibration TRS-398.
Indice gamma de Low. Méthode quantitative de comparaison entre une distribution de dose mesurée et une distribution de référence (souvent calculée), combinant un critère de différence de dose (typiquement 2–3 %) et un critère de distance (2–3 mm).
Histogramme dose-volume cumulatif. Représente, pour une structure anatomique donnée, le pourcentage de volume recevant au moins une dose donnée. Outil incontournable d'évaluation de plans cliniques.
Méthode numérique stochastique. En radiothérapie, simule la trajectoire individuelle de millions de particules (photons, électrons) à travers un milieu, en suivant les lois physiques d'interaction (effet photoélectrique, Compton, production de paires, ionisation, bremsstrahlung). Considérée comme la référence pour le calcul de dose en milieu hétérogène.
Code Monte Carlo gratuit développé par l'équipe du Dr. Lorenzo Brualla (Université Duisburg-Essen). Spécifiquement conçu pour modéliser les accélérateurs linéaires médicaux. Les données embarquées dans DosiPlot proviennent de simulations PRIMO.
Plateforme Monte Carlo open-source basée sur Geant4, développée par la collaboration OpenGATE. Plus polyvalente que PRIMO (TEP, SPECT, hadronthérapie) mais avec une courbe d'apprentissage plus raide.
Technical Report Series n°398 de l'IAEA. Protocole international de référence pour la calibration absolue des faisceaux photons et électrons utilisés en radiothérapie externe, basé sur la dosimétrie en eau.
Recommandations 2007 de la Commission Internationale de Protection Radiologique. Cadre actuel de la radioprotection des patients, des travailleurs et du public.
Aller plus loin
Notre blogregroupe une quinzaine d'articles approfondis qui couvrent la dosimétrie clinique, le contrôle qualité d'un accélérateur, la simulation Monte Carlo et l'application du machine learning à la radiothérapie. Quelques entrées recommandées :
- Dosimétrie en radiothérapie — introduction — les fondamentaux pour aborder le sujet sans pré-requis.
- Comprendre les courbes PDD et les profils latéraux — la lecture détaillée de ce que DosiPlot affiche.
- Le protocole TRS-398 — guide complet — pour comprendre ce que calcule le module TRS-398.
- Photons vs Électrons — quand utiliser chaque modalité — les indications cliniques typiques.
Pour toute question non couverte ici : formulaire de contact ou email direct à dosiplot@gmail.com.