caMicroscope Development Environment : Contributor’s Guide

caMicroscope is an open-source a web-based Annotation and Visualization Platform for digitized Whole Slide Images. It is largely optimized for large biomedical image data viewing, with a strong emphasis on cancer pathology. You can find their repository here.

Image for post
Image for post
(Source: https://github.com/camicroscope/caMicroscope)

caMicroscope can use used as a standalone application (See here) or It can be deployed as a part of the stack by using Distro. Where you can deploy it using docker.

caMicroscope is new and fast-growing software it is attracting many new contributors. This blog aims at helping them set-up the environment for development. As it is the most difficult step for any new contributor.

You have to change the built steps in the caMicroscope.yml file in the Distro to see the changes.

Make the desired changes into the caMicroscope directory.

Now, you have to change the built steps in the caMicroscope.yml file in Distro. Go to the Distro directory and find develop.yml file and find the following part.

Image for post
Image for post

Make the following changes.

  1. Change the contex to the fork of yor local Caracal
  2. Mount the cloned caMicroscope directory as a volume.

After that go to the Dockerfile in Caracal repository and delete the line which runs the git clone. It is no more needed as we have our own clone of the repository with us.

Run the following command to build all the services.

Now you will see the live changes happening in the server.

Note: If you don’t have the docker-compose installed, make sure to install it first.

Work on frontend

If you want to work on the frontend there is not much to do. You can simply start the install “live Server” plugin on VSCode and serve the file in which you are currently working.

Thank You for reading.

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store