add note about possible error and fix for problems opening czi images #92

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Nov 4, 2025

learners/setup.md

-Original file line number
+Diff line change
@@ Expand Up @@
     files. This may take up to 5 minutes - so give it some time. This will only
     happen once, and the `czi` image will open much faster next time.
+    ::::::::::::::::::::::::::::::::::::::::::: caution
+    ### Potential error
+    On some Windows systems `bioio-bioformats` dependencies prevent `czi` files
+    from opening in napari. If this is the case, napari may crash with the following
+    error message:
+    `failed with error: bioformats does not support the image`
+    Uninstalling the `bioio-bioformats` reader (which is not used in this material)
+    will fix this issue:
+    ```bash
+    pip uninstall bioio-bioformats
+    ```
+    Restart napari and try opening `Plate1-Blue-A-12-Scene-3-P3-F2-03.czi` again.
+    :::::::::::::::::::::::::::::::::::::::::::
     ::::::::::::::::::::::::::
     ::::::::::::::::::: solution
@@ Expand Down @@

Provide feedback