Skip to content

Instantly share code, notes, and snippets.

@Hemansh31
Last active August 17, 2021 11:46
Show Gist options
  • Star 0 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save Hemansh31/9230c0b10aafeb2e4712cac6d55c97b7 to your computer and use it in GitHub Desktop.
Save Hemansh31/9230c0b10aafeb2e4712cac6d55c97b7 to your computer and use it in GitHub Desktop.
GSoC2021_caMicroscope_Hemansh-Khaneja

GSoC 2021 Work Product - Hemansh Khaneja

Why this Project?

Often, it's useful for users to compare different results on a pathology slide image. To facilitate this, caMicrocope supports viewing the same image with different results, such as heatmaps, segmentations, and annotations, in a coordinated fashion. Since adjacent tissue slice images are usually quite similar, it can be useful to have a similar coordination between different images.

Aim

This project focuses on extending the support for comparing different results on two tissue slice images simultaneously in a coordinated fashion. The two different tissue samples may be differently situated in their images, and may require a user to change scale, position, and rotation to sync up the two images. Since caMicroscope does not yet support comparison of different results on a rotated image, support for rotation is also to be extended.

Project Summary

  • Feature Name: crossviewer
  • Functionalities Introduced:
    • Viewing two different tissue slice images simultaneously
    • Rotation of tissue slice images
    • Pan, Zoom and Rotation synchronisation of two different slice images
    • Comparison of different results(annotations, preset labels, rulers, segmentations, magnifyer) on two tissue slice images simultaneously
    • Screenshot of the two tissue images in side by side mode
  • Pull Requests:
  • Commits List

Project Milestones

  • First Milestone

    • Pull Request
    • Features Developed
      • Choosing Slides to view in crossviewer.
      • Panning, Zooming of the two slides in crossviewer independently.
      • Viewing and Adding Labels, Rulers, annotations and Heatmaps on the two slides in crossviewer independently.
      • Using magnifier tool and the screenshot feature which takes screenshot of the two slides together.
  • Second Milestone

    • Pull Request
    • Features Developed
      • Panning and Zooming the two slides simultaneously and synchronously.
      • Support for including rulers in the screenshot of the two slides of crossviewer.
      • Support for adding rulers on rotated slides.
  • Third Milestone

    • Pull Request
    • Features Developed
      • Support for viewing annotations, labels and heatmaps on rotated slides.
      • Support for adding annotations and labels on rotated slides.
      • Panning, Zooming and Rotating the two slides simultaneously and synchronously.
      • Support for screenshot of the two slides of crossviewer whilst they are rotated.
      • Tutorial of the crossviewer tools.

Project Feature Guide

  • How to open two slides in crossviewer?

    1. Open one of the two slides you want to view in viewer.
    2. In viewer page, click on the crossviewer tool.
    3. A popup window listing all the available slides appears, click on the open button of the slide you want to view in crossviewer along with the already visible slide.

  • What features are offered by crossviewer?

Tool Name Function
Layer Manager Opens the Layers Manager panel, where you can:
  • Select which layers to view
  • Rotate and Zoom an image
  • Synchronise pan, zoom and rotate of the two slides
Viewer Return to the viewer so that you can open another slide in crossviewer along with the slide in left viewer
Draw Draw thin lines, thick lines, or polygons on the image. To maintain the integrity of measurements, avoid drawing shapes that overlap or intersect one another.This is a dropdown menu consisting of a button for draw on left viewer (icon : left arrow) and right viewer (icon : right arrow)
Preset Labels Use a preset annotation type immediately to quickly annotate the two slides consistently.
Magnifier The Magnifier works like a magnifying glass and allows you to see the slide at normal magnification (1.0), low magnification (0.5), or high magnification (2.0). Click a magnification level and place the bounding box on the area of the slide you want to magnify.
Measurement Drag this tool on any of the two slides to learn the measurement in micrometers.
Slide Capture Click to take a screenshot of the slides and results on it (annotations, heatmaps and rulers).
Tutorial Click to view a guided tour of the crossviewer tools.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment