Skip to content

Latest commit

 

History

History
56 lines (37 loc) · 2.89 KB

README.md

File metadata and controls

56 lines (37 loc) · 2.89 KB

Documentation Status License Python Version PyPI PyPI - Downloads

pycromanager is a Python library for customized microscope hardware control and integration with image processing. It works together with Micro-manager and Micro-magellan.

Check out to the pre-print or the documentation for an idea of the capabilities and how to get started.

Have a cool example of something you've done with pycromanager or an idea for improvement? Reach out on the issues page.

Installing pycro-manager

  1. Download the lastest version of micro-manager 2.0
  2. Install pycro-manager using pip install pycromanager
  3. Run Micro-Manager, select tools-options, and check the box that says Run server on port 4827 (you only need to do this once)

To verify everything is working, run the following code:

from pycromanager import Bridge

bridge = Bridge()
bridge.get_core()

which will give an output like:

Out[1]: JavaObjectShadow for : mmcorej.CMMCore

Troubleshooting

Upon creating the Bridge, you may see an error with something like:

UserWarning: Version mistmatch between Java ZMQ server and Python client.
Java ZMQ server version: 2.4.0
Python client expected version: 2.5.0

In this case case your Micro-manager version Pycro-manager versions are out of sync. Usually, this can be fixed by downloading the latest versions of both. Uprgade to the latest Pycro-manager with:

pip install pycromanager --upgrade

Contributing

We welcome community contributions to improve Pycro-manager, including bug fixes, improvements to documentation, examples of different use cases, or internal improvements. Check out the contributing guide to see more about the workflow. Areas where community contributions would be especially helpful can be found on the Issues page with a Help wanted label

Information about how to setup a development environment for the Java parts of Pycro-manager can be found here