View on GitHub

Image Analysis Group

We are the Image Analysis Group at the Francis Crick Institute.

Accessing QuPath 0.7.0 on the HPC Cluster

This guide will walk you through how to use QuPath 0.7.0 on the Crick’s HPC cluster. If you need help at any step, see the support section.

This version of QuPath requires some libraries that are not compatible with NEMO’s. To solve this, QuPath runs in a “container” – a self-contained environment that has everything it needs. So rather than installing it ourselves, it is available in the apps folder in NEMO. These instructions will guide you on how to access it.

Looking for an older version? Earlier guides are available for QuPath 0.6 and QuPath 0.5.1.

Quick Navigation

What is QuPath 0.7.0?

QuPath is a popular, open-source tool for digital pathology and whole slide imaging analysis. The new version (0.7.0) brings several new features and improvements. To learn more about what’s new, see: QuPath v0.7.0 release notes & features

Instructions to Access QuPath v0.7 with OnDemand

Step 1: Start a Desktop Session

  1. Log in to the HPC cluster via Open OnDemand.
  2. Start a Nemo desktop session. For more information, see the HPC Wiki.

Step 2: Open a Terminal

OnDemand open terminal screenshot

Step 3: Load the Singularity Module

Every time you open a new terminal, you must laod the Singularity module – the container platform. Type the following and press Enter:

ml Singularity/3.11.3

Step 4: Run QuPath

Replace path/to/your/data with the folder where your data, project, and images are stored.

a) If you are using a GPU node:

singularity run --nv -B /path/to/your/data:/data /camp/apps/containers/QuPath/0.7.0/qupath_0.7.0.sif

b) If you are NOT using a GPU node:

singularity run -B /path/to/your/data:/data /camp/apps/containers/QuPath/0.7.0/qupath_0.7.0.sif

Important:

How to Set Up Your User Directory

First time only!

The first time you open QuPath, you will be asked to select a User Directory.

Accessing OMERO from QuPath

OMERO is an image server available at the Crick to store and manage microscopy images. It is the recommended location for storing image data, and QuPath can access OMERO images directly via an extension.

To install the OMERO extension: Follow the installation instructions in the Crick OMERO Guide.

Once installed, you’ll be able to browse and open your images directly from OMERO within QuPath, without needing to copy them locally.

Accessing your data in QuPath

When you open a project/image or are selecting your user directory, a file browser window will appear. Important: this window opens in “Home” by default, so your home directory, but this is NOT where your data is located.

Follow these steps to navigate to your data:

  1. In the file browser, click on “Other locations” (on the left sidebar)
  2. Select “Computer” to access the root file system.

  3. Navigate to the “data” folder. QuPath data location

  4. You will now see the path you specified when launching QuPath in the terminal (step 4). For example, /camp/lab/labname. From here, you can navigate to your project files.

Note: once you navigate into the /data folder, you won’t be able to navigate backwards to other system locations, so make sure the /path/to/your/data includes all the folders you need to access in your QuPath project.

Need Help? Contact Us!

If you have any questions or run into any issues, we’re here to help. Reach out to the Image Analysis team in CALM:

Happy analysing!