Troubleshooting

General

Things always go wrong in real life. If you tried analyzing your data in pylinac and it threw an error, you can try a few simple things to fix it.

  • First, See if the demo works - If not, pylinac may not have installed correctly or you may not have a dependency or the minimum version of a dependency.

  • Second, Check the error - If it’s an error that makes sense, maybe you just forgot something; e.g. analyzing an image before it’s loaded will raise an error. Asking for a gamma result of a fluence before calculating the fluence will raise an error. Such things are easy to fix.

  • Third, Check the Troubleshooting section of the specific module - Each module may fail in different ways, and also have different methods of resolution.

  • And if none of those work, Post a question on the forum - You may have found a bug and it needs fixing!

Loading TIFF Files

Loading TIFF files can be tricky since there are many variations of the TIFF image format. Pillow is the package for image I/O in Python and is what pylinac uses. But sometimes even Pillow has trouble. If you’ve tried loading a TIFF file and it just doesn’t seem to be working you can try two things:

  • Install pillow with conda; when installing this way more libraries are installed (vs. pip) that pillow can leverage.

  • Resave the image with another program. While I can’t tell you exactly what will work, one solution that’s worked for me is using GIMP. It’s free; just open up your TIFF files and then export them back to TIFF. It may not seem like that should change anything, but my anecdotal evidence is that every TIFF image that didn’t work that I reconverted using GIMP allowed me to read it in, especially when combined with the above strategy.