User Guide
The user guide is under construction. It will cover:
- Getting started with stopping power calculations
- Choosing particles, materials, and programs
- Understanding energy units (MeV, MeV/nucl, MeV/u)
- Creating and comparing plots
- Exporting data to CSV and PDF
- Using advanced options (density override, MSTAR modes)
- Loading external .webdedx data files
Shareable URL examples
The app stores calculator and plot state in the URL so you can bookmark or share exact
scenarios. These examples use the current urlv=2 syntax.
Basic calculator example
Open Calculator in Basic mode with proton, liquid water, ICRU 49, and a single 100 MeV row:
Advanced calculator example
Open Calculator in Advanced mode with carbon-12 in liquid water and three energy rows:
Loading external datasets
External stopping-power tables can be loaded by opening Calculator or Plot with an extdata query parameter. The format is extdata=<label>:<encoded dataset URL>, where the dataset URL points
to the root of a hosted .webdedx directory.
After loading, the source appears in a collapsible External Data Sources panel below the entity selectors. Programs from the loaded source are listed in the Program selector under an External group with a 🔗 prefix and an (ext) suffix. External-only particles and materials (those that don't merge with a built-in libdedx
entry) appear in External groups in their respective selectors.
Calculator example
Open Calculator with the public SRIM GUI reference dataset, proton in liquid water, ICRU 49, and a single 100 MeV row:
Plot example
Open Plot with the same SRIM dataset, proton in liquid water, and ICRU 49 as the selected program:
Keyboard shortcuts
The entity picker (Particle / Material / Program) supports keyboard-first navigation:
| Key | Action |
|---|---|
| / | Focus the search field (expands panel if collapsed) |
| ↑ / ↓ | Move highlight up / down through the list |
| ↵ Enter | Select highlighted item; advances to the next empty field automatically |
| Escape | Blur focus and collapse the picker (on the Calculator page) |
| ← / → | Cycle between Particle / Material / Program tabs (when a tab button is focused) |
Tip: press /, type to
filter, use ↑↓ to highlight, then ↵ to confirm and automatically move to the next field.