Troubleshooting & FAQ¶
Startup issues¶
| Problem | Fix |
|---|---|
| Qt / platform plugin errors on startup | Use a conda environment (conda-forge) for PyQt + VTK; mixed pip + system Qt installs are fragile on Linux |
| 3D view black / GL errors | Update GPU drivers; check that OpenGL works in other apps |
| VTK wheel fails to install | Match your Python version to the available wheels (try another 3.10–3.12 patch release) |
Performance¶
| Problem | Fix |
|---|---|
| Large volumes load slowly | Use .nii.gz; see Performance |
| 3D scene stutters with large tracts | Reduce bundles beforehand; surfaces use automatic LOD |
FAQ¶
Where do I get atlases? Via a Lead-DBS template directory — see Spaces & templates.
Does BrainDeer support DICOM?
Yes, via the dicom extra — see Loading data.
How do I report a bug? Via GitHub Issues.
(TODO: add more questions from real user feedback.)