Magboltz-GUI: a Python-based graphical user interface for Magboltz

Dit artikel introduceert Magboltz-GUI, een open-source Python-gebaseerde grafische interface die de workflow voor het simuleren van elektronentransport in gasmengsels met Magboltz vereenvoudigt voor onderzoek en onderwijs in gassensoren.

De kern

Stel je voor dat Magboltz een zeer slimme, maar wat stijve kok is. Deze kok is een legende in de wereld van de deeltjesfysica: hij kan precies berekenen hoe elektronen zich gedragen in een mengsel van gassen. Dit is cruciaal voor het bouwen van detectoren (zoals die in deeltjesversnellers) die ons helpen de geheimen van het universum te ontrafelen.

Het probleem? Deze kok werkt alleen met handgeschreven receptkaarten (tekstbestanden). Als je niet precies weet welke code je moet schrijven, of als je één lettertje verkeerd typt, weigert de kok te koken en krijg je geen resultaat. Voor een beginnende kok of iemand die alleen af en toe een gerechtje wil maken, is dit erg intimiderend en lastig.

Magboltz-GUI is de oplossing: het is een moderne, gebruiksvriendelijke keukenkast die je voor deze kok zet.

Hier is wat deze nieuwe tool doet, vertaald naar alledaags taal:

1. Van tekst naar knoppen (De Interface)

In plaats van een recept op een vel papier te typen, krijg je nu een grafisch menu.

• De Ingrediënten: Je kunt je gasmengsel (je "recept") samenstellen door op knoppen te klikken en schuifbalkjes te bewegen, net zoals je ingrediënten in een bakje zou wegen. Je ziet direct hoeveel van welk gas erin zit, zelfs met een mooi taartdiagram dat de verdeling laat zien.
• De Uitleg: Twijfel je over een instelling? Houd je muis erboven en er verschijnt een klein tekstballonnetje met uitleg. Geen giswerk meer.

2. De Kok aan het werk (Het Draaien van Simulaties)

Vroeger moest je het recept opslaan, een commando in een zwart scherm typen en hopen dat het werkte. Met Magboltz-GUI klik je gewoon op een grote "Start"-knop.

• De tool praat gewoon met de oude kok (Magboltz) op de achtergrond. Hij verandert de kok niet, hij geeft hem alleen de instructies op een manier die de kok begrijpt, maar die voor jou makkelijk is.
• Je kunt zelfs meerdere recepten tegelijk laten draaien, alsof je meerdere pannen op het fornuis hebt staan.

3. Het Eten serveren (Resultaten bekijken)

Zodra de kok klaar is, krijg je niet alleen een stapel cijfers, maar een mooi verzorgd buffet.

• Visueel: Je ziet direct grafieken van hoe snel de elektronen gaan, hoe vaak ze botsen en hoe ze zich verspreiden. Het is alsof je het gerecht eerst proeft voordat je het serveert.
• Exporteren: Wil je de resultaten meenemen naar een ander programma? Je kunt ze met één klik opslaan in een handig formaat (zoals Excel of JSON), klaar voor verder onderzoek.

Waarom is dit belangrijk?

• Voor studenten en leraren: Het maakt het leren van deze complexe fysica veel makkelijker. Je hoeft geen expert in computercode te zijn om te begrijpen hoe gassen werken.
• Voor onderzoekers: Het bespaart tijd. Geen tijd meer besteden aan het zoeken naar typfouten in tekstbestanden, maar meer tijd om de echte wetenschap te doen.
• Voor iedereen: Het is gratis, open source (iedereen mag het gebruiken en verbeteren) en werkt op je gewone computer.

Een eerbetoon

Deze tool is speciaal opgedragen aan Stephen Biagi, de man die de oorspronkelijke "kok" (Magboltz) heeft bedacht. Hij is helaas in 2025 overleden. Magboltz-GUI is een manier om zijn werk toegankelijker te maken voor de volgende generatie onderzoekers, zodat zijn legaat blijft leven en nog meer mensen kunnen helpen de mysteries van deeltjesfysica op te lossen.

Kortom: Magboltz-GUI is de brug tussen de complexe wereld van deeltjesfysica en de menselijke gebruiker, zodat iedereen mee kan doen aan het ontdekken van het heelal.

Technische samenvatting

Probleemstelling

Magboltz is een gevestigde en veelgebruikte softwaretool voor het simuleren van elektronentransport in gasmengsels, essentieel voor het ontwerp en de analyse van gasdetectoren (zoals TPC's, Micromegas en GEM's). Ondanks zijn wetenschappelijke waarde, vormt de traditionele werkwijze een barrière voor routinegebruik:

• Tekstgebaseerde invoer: De tool vereist handmatig opgestelde tekstbestanden ("input cards"), wat onhandig is voor dagelijkse taken.
• Gebruiksvriendelijkheid: Voor nieuwe of incidentele gebruikers is de leercurve steil.
• Foutgevoeligheid: Kleine invoerfouten leiden vaak tot mislukte simulaties of maken debugging moeilijk.
• Beperkte visualisatie: Het ontbreken van een grafische interface maakt het moeilijk om resultaten direct te inspecteren of te exporteren voor verdere analyse.

Methodologie

De auteurs hebben Magboltz-GUI ontwikkeld als een lichtgewicht grafische gebruikersinterface (GUI) die de onderliggende Magboltz-simulatiecode niet wijzigt, maar de interactie ermee vereenvoudigt.

• Technische Stack: De software is geschreven in Python 3.11 met gebruik van de Qt 6-bindingen. Dit zorgt voor cross-platform compatibiliteit (Windows, macOS, Linux) en eenvoudige packaging.
• Architectuur: De GUI communiceert met Magboltz via standaard invoer/uitvoer (stdin/stdout). Dit betekent dat de tool werkt met een bestaande lokale installatie van Magboltz.
• Distributie: De software is beschikbaar als open-source pakket via PyPI (Python Package Index) en een GitLab-repository, met versiebeheer via git.
• Installatie: Er zijn twee installatiemethoden:
  1. Met ingebouwde Qt-afhankelijkheden (via pipx install "magboltz-gui[qt]").
  2. Met gebruik van een systeemgebonden Qt-omgeving.
     De tool vereist Python ≥3.11 en een grafische desktopomgeving.

Kernbijdragen en Functionaliteiten

De interface is ontworpen om bekend te blijven voor ervaren gebruikers, maar toegankelijker voor beginners. De belangrijkste functionaliteiten zijn:

1. Invoer en Configuratie:
   • Een tabblad met alle invoerparameters, waarbij eenheden direct worden weergegeven en tooltips korte beschrijvingen bieden.
   • Definitie van gasmengsels (tot zes gassen, conform Magboltz-standaard) met een visuele taartgrafiek (gegenereerd via matplotlib) voor de samenstelling.
2. Simulatiebeheer:
   • Directe uitvoering van Magboltz-simulaties vanuit de GUI.
   • Ondersteuning voor het lanceren van meerdere runs parallel, nuttig voor parameter-scans.
3. Data-export:
   • Een geavanceerd exportdialoogvenster dat resultaten kan opslaan in CSV, JSON of XML.
   • Ondersteuning voor diverse exporttypes: samenvattingen, convergentietabellen, energieverdelingen, botsingsfrequenties en volledige archieven.
   • Optionele opname van eenheden, metadata en uitgebreide gasmengselinformatie.
4. Visualisatie:
   • Een "Results plots"-venster voor grafische weergave van simulatieuitkomsten, waaronder energieverdelingen, driftsnelheden, diffusiecoëfficiënten en botsingsfrequenties.
   • Aanpasbare kleurenpaletten en plotstijlen.

Resultaten

Het paper presenteert de software als een operationeel en gebruiksklaar hulpmiddel:

• De tool is succesvol gedemonstreerd tijdens de DRD1 WG4-bijeenkomst (februari 2026), waar feedback van de gemeenschap is verzameld.
• Het systeem maakt het mogelijk om Magboltz te gebruiken zonder de broncode aan te passen, wat de compatibiliteit met bestaande workflows (zoals Garfield++ en Geant4) behoudt.
• De modulariteit van de Python/Qt6-architectuur faciliteert hergebruik en uitbreiding in gerelateerde onderzoeksstudies.

Betekenis en Toekomstperspectief

Magboltz-GUI verlaagt de instapdrempel voor nieuwe gebruikers in de deeltjesfysica en gasdetectortechnologie, terwijl het de efficiëntie en reproduceerbaarheid van routine-onderzoek voor ervaren gebruikers verbetert.

• Onderwijs en Onderzoek: De tool is specifiek ontworpen voor zowel dagelijkse praktijk als educatieve doeleinden, waar een grafische interface de toegang tot complexe simulaties vergemakkelijkt.
• Toekomstige Ontwikkeling: De focus ligt momenteel op gebruiksvriendelijkheid en workflow-versimpeling. Toekomstige updates zullen gericht zijn op interfaceverbeteringen, uitgebreidere plotmogelijkheden en verdere optimalisaties op basis van gebruikersfeedback.
• Erkenning: Het project is opgedragen aan de nagedachtenis van Stephen Francis Biagi (1949–2025), de oorspronkelijke ontwikkelaar van Magboltz, als een eerbetoon aan zijn blijvende nalatenschap in de modellering van elektronentransport.

De software is vrij beschikbaar onder de MIT-licentie, wat gebruik, modificatie en redistributie zonder beperkingen toestaat.