| Both sides previous revision
Previous revision
Next revision
|
Previous revision
|
software:micro-manager [2019/11/17 00:44]
Jon Daniels [Runnables in the plugin] |
software:micro-manager [2024/04/15 23:19] (current)
Jon Daniels [Micro-manager diSPIM Plugin] |
| Details about the plugin operation can be found in the manual section of this website in the [[:docs:mm_dispim_plugin_user_guide|Micro-manager diSPIM Plugin User Guide]]. **Please see that manual for information about using the plugin.** There is also a brief overview is on [[https://micro-manager.org/wiki/ASIdiSPIM_Plugin|its Micro-manager wiki page]]. | Details about the plugin operation can be found in the manual section of this website in the [[:docs:mm_dispim_plugin_user_guide|Micro-manager diSPIM Plugin User Guide]]. **Please see that manual for information about using the plugin.** There is also a brief overview is on [[https://micro-manager.org/wiki/ASIdiSPIM_Plugin|its Micro-manager wiki page]]. |
| |
| Currently the diSPIM plugin is supported in 1.4.x only, although there have been some efforts to port it to 2.0. At some point after the official release of Micro-manager 2.0, development on the 1.4.x plugin will slow and eventually stop and at that point only 2.0 will be supported. But that's all in the future as of early 2019 since 2.0 hasn't been released yet. | Currently the diSPIM plugin is supported in 1.4.x only. In 2023 there have been efforts to create a new plugin in Micro-Manager 2.0 called [[https://github.com/micro-manager/LightSheetManager|LightSheetManager]] that will operate the diSPIM as well as other types of light sheet microscopes. Contributions to the effort of making this new plugin are appreciated. As of August 2023 this is in alpha testing by the first few bleeding edge adopters, and we expect that by end of 2023 it will be ready for more adopters and a full replacement in 2024. |
| |
| You can download the nightly builds of Micro-manager 1.4 for Windows [[http://valelab4.ucsf.edu/~MM/nightlyBuilds/1.4/Windows/|here]]; the date is encoded in the file name and the latest date is at the top of the page. Make sure to get the appropriate 32bit or 64bit depending on your computer. | You can download the nightly builds of Micro-manager 1.4 for Windows [[https://download.micro-manager.org/nightly/1.4/Windows/|here]]; the date is encoded in the file name and the latest date is at the top of the page. Make sure to get the appropriate 32bit or 64bit depending on your computer. |
| |
| |
| ==== Scripting the plugin ==== | ==== Scripting the plugin ==== |
| |
| The Micro-Manager plugin has an API that allows most of its functionality to be accessed via Beanshell scripts run from within Micro-Manager. This allows users to orchestrate complex acquisitions and even use the plugin for adaptive microscopy where automated image analysis guides acquisition. The best way to see what functionality is exposed via the API is to look at the [[https://valelab4.ucsf.edu/trac/micromanager/browser/plugins/ASIdiSPIM/src/org/micromanager/asidispim/api/ASIdiSPIMInterface.java|source code of the Java interface]] which defines the API. The API includes are methods to get and set the most commonly changed settings within the plugin, launch acquisitions, move the microscope, and more. The API can be augmented if needed but every effort is made not to change the documented functionality. Furthermore there is support for Java RMI which allows the plugin API to be access from a completely separate Java VM. | The Micro-Manager plugin has an API that allows most of its functionality to be accessed via Beanshell scripts run from within Micro-Manager. This allows users to orchestrate complex acquisitions and even use the plugin for adaptive microscopy where automated image analysis guides acquisition. The best way to see what functionality is exposed via the API is to look at the [[https://github.com/micro-manager/micro-manager/blob/mm1/plugins/ASIdiSPIM/src/org/micromanager/asidispim/api/ASIdiSPIMInterface.java|source code of the Java interface]] which defines the API. The API includes are methods to get and set the most commonly changed settings within the plugin, launch acquisitions, move the microscope, and more. The API can be augmented if needed but every effort is made not to change the documented functionality. Furthermore there is support for Java RMI which allows the plugin API to be access from a completely separate Java VM. |
| |
| Here is a bare-bones example script: | Here is a bare-bones example script: |
| ==== Runnables in the plugin ==== | ==== Runnables in the plugin ==== |
| |
| Support for "runnables" has been added to the plugin. A runnable is a snippet of user-specified code that is executed at a pre-defined sequence during the overall acquisition. Runnables generally should not be used when exact timing matters because their exact execution time will be controlled by Micro-Manager and subject to the whims of the host computer and not done with exactly predictable timing (if you need exact timing, you can use the Tiger controller's flexible Programmable Logic Card (PLC) to implement). | Support for "runnables" was added to the plugin early July 2019 and extended November 2019. A runnable is a snippet of user-specified code that is executed at a pre-defined sequence during the overall acquisition. Runnables generally should not be used when exact timing matters because their exact execution time will be controlled by Micro-Manager and subject to the whims of the host computer and not done with exactly predictable timing (if you need exact timing, you can use the Tiger controller's flexible Programmable Logic Card (PLC) to implement). |
| |
| These runnables are normally defined in a Beanshell script executed from Micro-Manager's script window and "attached" to the plugin after the plugin has been invoked. See the below example. | These runnables are normally defined in a Beanshell script executed from Micro-Manager's script window and "attached" to the plugin after the plugin has been invoked. See the below example. |
