Skip to content

Commit

Permalink
Merge pull request #28 from petebankhead/version
Browse files Browse the repository at this point in the history
Update readme and version to 0.1.0
  • Loading branch information
petebankhead authored Aug 23, 2023
2 parents d6a438a + d4b2383 commit 3129e77
Show file tree
Hide file tree
Showing 2 changed files with 35 additions and 2 deletions.
35 changes: 34 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,38 @@
# QuPath extension WSInfer

This repo contains a *work-in-progress* extension to work with WSInfer models in QuPath.
This repo contains the extension to work with WSInfer models in QuPath.

This helps make deep learning-based patch classification in pathology images easy and interactive.

See https://wsinfer.readthedocs.io for details.

> **If you use this extension, please cite both the WSInfer preprint and the [QuPath paper](https://qupath.readthedocs.io/en/0.4/docs/intro/citing.html)!**
## Installation

Download the latest version of the extension from the [releases page](https://github.com/qupath/qupath-extension-wsinfer/releases).

Then drag & drop the downloaded .jar file onto the main QuPath window to install it.

## Usage

The WSInfer extension adds a new menu item to QuPath's **Extensions** menu, which can be used to open a WSInfer dialog.

The dialog tries to guide you through the main steps, from top to bottom.

Briefly: after selecting a WSInfer model, you'll need to select one or more tiles to use for inference.
The easiest way to do this is generally to draw an annotation, and leave it up to QuPath to create the tiles.

Pressing run will download the model and PyTorch (if necessary), then run the model across the tiles.

You can see the results in the form of measurement maps, as a results table, or as colored tiles in the QuPath viewer.

> Tip: To see the tiles properly, you'll need to ensure that they are both displayed and filled in the viewer (i.e. ensure the two buttons showing three green objects are selected).
## Additional options

It's worth checking out the *Additional options* to see where models will be stored.

You can also use this to select whether inference should use the CPU or GPU - if a GPU is available and compatible.

> GPU acceleration is selected by choosing *MPS* on an Apple Silicon Mac, for *Metal Performance Shaders*.
2 changes: 1 addition & 1 deletion build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ plugins {

ext.moduleName = 'io.github.qupath.extension.wsinfer'

version = "0.1.0-SNAPSHOT"
version = "0.1.0"
description = 'An extension to run WSInfer in QuPath'

// The default 'gradle.ext.qupathVersion' reads this from settings.gradle.
Expand Down

0 comments on commit 3129e77

Please sign in to comment.