Skip to content

Instructions Manual for the Thermal Image Analysis software

rakshith95 edited this page May 7, 2020 · 2 revisions

General instructions and notes:

  • The software runs as a Command Line Interface. The options are displayed on the command line, and the user input is entered either in the terminal itself or on the image (whenever an image is present)
  • All the image interactions are with OpenCV which makes use of the QT backend. When an image is present, and options are displayed on the command line, change the main window to the image window and press the option number key on the keyboard followed by the Enter key. Note: In some cases, you might have to Alt+Tab to the image window. (Will fix this later if I can)
  • When no image window pops up, you'll have to enter the input in the terminal followed by Enter
  • The initial image displayed at the beginning is NOT the raw image. It is the image with the values scaled wrt a line parallel to the Y-Axis through centre of the image. To invert the scale of the image between the raw, and this default scaled image, use the Invert Image Scale option.

Program Flow:

  • Press Enter to move through stages
  1. Tools/Features options displayed on the terminal with an 'Enter Input' image window where you choose the appropriate option on the image window.
  2. Depending on the option chosen, another image window pops up where you draw (contour,rectangle,line,etc..) or enter in the command line.
  3. A 'Main Window' where all interactions happen. Continuously loops between the above three until the user wishes to exit which he can do so by choosing the 'Exit' option in the Enter Input stage.

Notes on drawing contours, and other figures:

For ROI Scaling, Draw Areas, Draw Lines, and Draw Spots, the user will have to draw the figures as appropriate. The following notes are for the different figures and their behaviour in the Main Window.

  1. ROI Scaling: If ROI Scaling is chosen, it opens a window names as Image where the user will have to draw the are with respect to which the entire image is scaled.
    • To draw the area: Click the left mouse button on the starting point in the image and hold--> Draw the required shape --> Release the left mouse button --> Press the Enter key.
      Note: The figure will close itself even if the drawn shape is not closed
  2. Draw Areas: If this option is chosen, it prompts another on input from the user on whether the measurement area required is a free hand area, or a rectangle. This must be entered on the command line itself. Press Enter after choosing the option, and it opens up the Image window. Multiple areas can be drawn, but not simultaneously. They will have to be drawn in multiple iterations by choosing the option. This will be changed in the future.
    • If Freehand option was chosen, proceed like drawing the shape following instructions from ROI Scaling
    • For Rectangle: Left click on the image where the TOP LEFT of the rectangle would be, and hold --> Drag to the BOTTOM RIGHT of the rectangle --> Release --> Enter.
  3. Draw Lines: On choosing the option, the Image window pops up where the line can be drawn to obtain a Temperature vs Distance along the line plot. This line cannot be moved unlike the others, and immediately produces the plot once Enter is pressed.
    • Left click on point1 of the intended line --> Release --> Left click on point2 --> Enter.
      Note: The line is not displayed while drawing
  4. Draw Spots: The Image window opens where spots can be placed on the image.
    • Multiple spots of fixed radius can be placed on the image by Left Clicking on the image. For each click, a spot will be placed centred on the point --> Press Enter when done.

Main Window behaviour, and user interactions:

  • All areas (Roi Scaling, Draw areas, Spots) can be moved from their originally drawn positions. For ROI Scaling, the image is scaled dynamically as the area is moved. To move:
    Right Click inside the area --> Hold and drag --> Release
    Note: Corner Behavior: If the shape is tried to move beyond the edges, it throws warnings
  • To get the area information (Draw Areas, spots) double click (Left button) inside the area. The information is displayed on the terminal.