D4Scope Detector UI and Backend Software

• Begin a virtual environment and install dependencies:

  • $ pip install -r requirements.txt

• First it is necessary to deploy the server file. If the server is to run locally, run the following command in the base directory:

  • $ python final_server.py

• If server has been deployed to Duke University virtual machine it has the following information associated with it:

  • Hostname: vcm-9091.vm.duke.edu
  • Port: 5000
  • Operating System: Ubuntu18 Server
  • URL of root directory: http://vcm-9091.vm.duke.edu:5000/

• MongoDB has been deployed to the virtual machine and should be functional remotely.

• To run this application run the file: GUI_test.py

$ python GUI_test.py

GUI Overview and Functionality:

• GUI functionality has been distributed into three main python files:

  • launch_dialog.py
  • encodedUI.py
  • GUI_test.py

• GUI_test.py functions as the main driver and functions as the "controller" for the user interface. GUI_test.main() is the module that goes through the various windows of the program as such:

  • First, the launch window is deployed (contained in the file launch_dialog.py). Launch window prompts the user to enter their username, the D4 batch number, the data group, and the location that the sample was obtained.

  • Next, the user presses "ok" and if all fields have inputs, the window changed to the main functional window (contained in the files: encodedUI.py and GUI_test.py). This window contains five main buttons for image processes tasks.

    • "Open Image": Import a .tiff file into the application.

    • "Upload Image to Server": Send image to server. Server will respond with spots identified, their mean intensities, the background noise associated with the signal, and the dimensions of the pixel image.

    • "View entered filename from server": Command to find an image that has been stored on the server.

    • "Test Server!": Test to see if the server is functional.

    • "Pull Data to outputData.csv": Pull all of the data to a local csv file.

IMPORTANT NOTE: Depending on the client OS that the GUI is run on, you may not see information from the server appear on the GUI right away. You may need to switch to another window (out of the GUI) and back to the GUI.

More information can be found on the public GitHub Page: https://github.com/jl532/Detector-Software