Skip to content
seto edited this page Mar 23, 2026 · 40 revisions

Troubleshooting

Common issues and solutions for ReciPro.


OpenGL issues

Symptom: Black screen or crash on startup

Cause: Incompatible GPU or remote desktop environment.

Solution:

  1. Go to Option → Disable OpenGL (needs restart)
  2. Restart ReciPro
  3. Structure Viewer and some 3D features will use software rendering

Symptom: Poor rendering quality

Solution: Update your GPU drivers. An external (discrete) GPU with OpenGL 1.5 support is recommended.


.NET Runtime

Symptom: Application won't start

Cause: .NET Desktop Runtime 9.0 is not installed.

Solution: Download and install from https://dotnet.microsoft.com/download/dotnet/9.0


Dynamical calculations

Symptom: Very slow or out of memory

Cause: Too many Bloch waves or too large an image.

Solution:

  • Reduce No. of Bloch waves (50–200 is usually sufficient for routine calculations)
  • Use the Eigen solver for ≤ 500 waves; MKL for > 500 waves
  • Reduce image resolution for STEM simulations
  • Close other memory-intensive applications

Symptom: HAADF-STEM image is black

Cause: Atomic temperature factors (B) are set to zero.

Solution: Set B ≥ 0.5 Ų for all atoms. TDS intensity requires non-zero temperature factors.


File I/O

Symptom: CIF file won't load

Solution:

  • Check that the CIF file is well-formed
  • Try dragging and dropping the file onto the Crystal Information area
  • Some non-standard CIF extensions may not be supported

Symptom: dm3/dm4 file shows wrong scale

Solution: Verify calibration in the original Digital Micrograph software. ReciPro reads the embedded metadata; if the metadata is incorrect, manually set the pixel size and camera length in the Optics panel.


Registry reset

If settings become corrupted:

  1. Option → Reset registry (after restart)
  2. Restart ReciPro — window positions, wavelength, camera length, etc. will be reset to defaults

Reporting bugs

Report issues at: https://github.com/seto77/ReciPro/issues

Please include:

  • ReciPro version number
  • Steps to reproduce the problem
  • Any error messages or screenshots

Clone this wiki locally