How thiebes/dice works
And Label Primary Components
• Simulation Engine (detailed breakdown)
• Parameter Input Module
• Output & Plotting Module
• Web Application Wrapper
• Entry Point / Utility Scripts
• Break out several sub-components:
• Profile Generation:
▸ Generates a time-series of Gaussian profiles with decay and diffusion. (Core computations in dice.py)
• Noise Addition:
▸ Adds uniform white noise to each profile simulating experimental uncertainty.
• Fitting Module:
▸ Performs Gaussian functional fitting on the noisy profiles.
▸ Computes Mean Squared Displacement (MSD) at each time point.
▸ Executes linear (weighted/unweighted) fit to extract diffusion coefficients.
• Analysis Module:
▸ Compares simulation-derived diffusion estimates to the nominal input.
▸ Evaluates precision by checking what fraction of the estimates are within defined proximity thresholds.
• Plotting and Visualization:
▸ Generates histogram plots and summary visualizations using matplotlib, seaborn, etc.
• Iteration & Parallel Processing Controller:
▸ Orchestrates multiple simulation runs based on the specified number of iterations.
▸ Manages parallel processing if enabled.
[Parameter Values] → [Gaussian Profile Generation] → [Noise Addition] → [Fit Computation] → [Analysis] → [Plotting]
• Represents files like parameters.txt and example_profile.csv.
• Reads and validates experimental/simulation parameters.
• Feeds configuration details (initial guess, simulation iterations, plotting options, spatial and temporal axis definitions) directly into the Simulation Engine.
• Handles generation of text summary, CSV results, and image plots.
• Groups all the web-related modules contained in the "webapp" folder (e.g., dice_web_app.py, dice.py under webapp, HTML templates, static assets).
• Acts as a front-end interface that calls the same Simulation Engine in the backend.
• Contains scripts like run_dice.py.
• Serves as the command-line interface to kick off the simulation process.
• Within the Simulation Engine, illustrate the internal flow, from data generation to analysis and plotting.
• Simulation Engine to the Output & Plotting Module, showing that processed simulation data is sent out as results.
• Similarly, show that the command-line Entry Point feeds into the same Simulation Engine.