GUI Install - HenriquesLab/NanoJ-Fluidics GitHub Wiki

Installation instructions

NanoJ-Fluidics provides a simple, but powerful graphical user interface (GUI) which can allow any user to control the Lego pumps (as well as other types of pumps) without having to program anything them selves. The GUI can be run in any one of three ways.

1 - As an ImageJ Plugin

  1. Download the NanoJ-Fluidics_IJ.zip file from the latest release section.
  2. Extract the contents from the zip file directly to the root of your ImageJ installation.
  3. You can access the GUI from the Plugins>NanoJ-Fluidics menu option.

2 - As a Micro-Manager Plugin

  1. Download the NanoJ-Fluidics_MM.zip file from the latest release section.
  2. Extract the contents from the zip file directly to the root of your Micro-Manager installation.
  3. You can access the GUI from Micro-Manager window and choosing the Plugins>NanoJ-Fluidics menu option.

Please note: due to an update to Micro-Manager, the Plugin System doesn't work anymore. Therefore the Harvard Pump plugin is currently not functional inside micro-manager.

3 - As a stand-alone application

  1. Please ensure you have Java 8 installed.

Unfortunately, the stand-alone version is not compatible with Java 9 and 10 for the time being.

  1. Download the NanoJ-Fluidics.zip file from the latest release section.
  2. Extract the contents from the zip file directly to a new directory on your file system.
  3. You can start the GUI by double-clicking the NanoJ-Fluidics.jar file.

Note: If you have an issue where the GUI looks distorted, please read the below section.

High DPI scaling issue when running as a stand-alone application

If the GUI looks tiny and formatted incorrectly, it's because there is an issue with Java and modern high pixel density displays on Windows. The high density results in the proportions of the GUI getting distorted to the point where it is not usable. To solve this:

  1. Find where you have java.exe installed.
  2. Right-click on the file and choose Properties
  3. Go to the Compatibility tab
  4. Check the Override high DPI scaling behavior option.
  5. In the dropdown titled Scaling performed by`, choose System``.

If this is not enough to solve your issue, please start the program with the NanoJ-Fluidics.bat file instead of the .jar file.

Testing

If you would like to test the software, we provide a "Dummy" pump plugin, which allows you to use the software without having to connect to a real pump.