Polo Version 0.2.0

Update overview: Post April 2023 users please read!

This updated version of Polo adds the most recent National High-Throughput Crystallization Center @ HWI cocktail formulations which rolled out in April of 2023.

Users of the National High-Throughput Crystallization Center who would also like to use Polo for image analysis and classification should be sure to use this version of the software as previous versions do not include the most up to date formulations and are likely to apply an incorrect screen version to your imaging data which is likely to result in the incorrect cocktail information being assigned to wells.

Therefore it is critical runs submitted to the screening center post April 2023 use Polo version 0.2.0 or greater for all image analysis.

Analysis of images pre-April 2023 will still function normally with any version of Polo.

If you would like to compare cocktail screening versions, all formulations are available as part of this repository in scr/data/cocktail_data

Program installation

Download the software version that is appropriate for your machine. Currently Windows 10 and 11, Ubuntu 22 LTS, and Mac (non Apple silicon) should be supported. Other operating systems will need to install the dependencies described in the environment.yml file and run src/Polo.py as a Python program.

• Windows 10 and 11 = PoloWindows0.2.0.exe
• Mac Ventura = PoloMac0.2.0.dmg
• Ubuntu 22 LTS = PoloUbuntu0.2.0

Windows users should be able to run Polo simply by downloading and running the .exe file. You will likely get a warning telling you Polo is an unrecognized program; allow it to run anyway to use the software.

Due to increased security measures on newer Mac operating systems, Mac users may have additional hurdles to overcome to get Polo running. First, download the .dmg file, open and drag to applications then attempt to run the Polo program. Answer yes to any permission type questions the OS gives you or Polo may fail to execute. If Polo is not recognized as an executable file you may have to mark the program as executable using the terminal. Apple has a guide on how to do use this at this link.

If you have issues installing on these operating systems please reach out to the crystallization center; htslab@hwi.buffalo.edu.

Getting starting with Polo

If you have successfully installed Polo and are a new user you can checkout written and video tutorials on the main features of the program at
this link

Other changes

• Updated cocktail_metadata to reflect new formulation start date
• Updated PyInstaller version to utilize Tensorflow hooks to hopefully make packaging into exes more reliable on all operating systems
• Included commercial codes when cocktail data is displayed to the user
• Minor bug fixes relating to exporting images of a selected classification as a PowerPoint presentation