Page MenuHomec4science

Image Combiner Warpy
Updated 16 Days AgoPublic

Warpy documentation main page: https://c4science.ch/w/warpy/

ImageCombinerWarpy is a QuPath (v0.3) extension for the non-linear overlay of whole slide images.

It is based on the ImageCombiner.
In addition to the affine transformation used in the ImageCombiner, the ImageCombinerWarpy uses the BIOP Warpy project to combine whole slide image on a cellular resolution (Warpy).

Whole slide images aligned with Warpy can be combined to a new QuPath image entry.

Multiple images can be selected and overlaid.
The only condition is that Warpy transform files exist for all overlay images, and that all overlay images have been transformed to the same base image.

(Combinations of affine transformations and Warpy transformations are not possible.)

WARNING: The ImageCombinerWarpy is an experimental tool. Please read the notes at the end of the document carefully!

INSTALLATION

USAGE / APPLICATION

In the QuPath menu you will find the new entry Analyze>ImageCombinerWarpy .

Open your QuPath project for which you created the Warpy transform.
Open your fixed/base image in the viewer.

Before starting ImageCombinerWarpy, make sure that your base image viewer is selected! (The image used as fixed image in the Warpy procedure MUST be the base image in ImageCombiner!)

Open ImageCombinerWarpy and choose an overlay image from your project.

Select the overlay image in the image list.
In the ‘Warpy Info’ section you should see the ID of the image and - if present in the project data folder - the Warpy transform file.

Click the ‘Warpy’ command to create the new, permanent project entry with the image overlay.
(The Warpy command is ONLY active if Warpy transform file exists for all overlay images.)

NOTE: It is possible to combine only certain image channels in the warped image. To do this, adjust the Brightness&Contrast settings as well as the channel selection for all images (base or overlay image) displayed in a separate viewer before using the ‘Warpy’ command. Further information is described in (•ᴗ•)/ QuPath scripting (#4): Image Combiner (register images and create project entry) .

Use the Brightness&Contrast dialog to select the color channels and display settings of the new image.

WARNING: The ImageCombinerWarpy is thought as an experimental tool. It is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
WARNING: I When transformed and overlaid images are created, the original pixel contents of the images are altered ! The pixel difference between the original and transformed image depends not only on the transformation but also on the downsampling used in the current viewer. This must be taken into account in all analysis steps performed on such transformed images.
WARNING: II The Warpy transformation is based on a special TransformingImageServer class provided via a QuPath Extension package. Additionally, the Warpy transformation is based on slide-specific information regarding spatial deformation in Json format. Should the extension or format of the transformation information change in future versions, or should one of these two important components not be present, old projects may no longer load or may not load correctly. It is therefore strongly recommended to save the images created with ImageCombinerWarpy and thus make them independent of the ImageCombinerWarpy extension and the Warpy transformation.
Last Author
chiarutt
Last Edited
Wed, Nov 17, 20:57

Event Timeline

phaub created this document.Wed, Nov 17, 16:52
phaub edited the content of this document. (Show Details)
chiarutt edited the content of this document. (Show Details)Wed, Nov 17, 16:55
phaub edited the content of this document. (Show Details)Wed, Nov 17, 17:17
phaub edited the content of this document. (Show Details)Wed, Nov 17, 17:20
phaub edited the content of this document. (Show Details)Wed, Nov 17, 17:25
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Wed, Nov 17, 17:27
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Wed, Nov 17, 17:29
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Wed, Nov 17, 17:33
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Wed, Nov 17, 17:40
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Wed, Nov 17, 17:46
phaub edited the content of this document. (Show Details)
phaub added a subscriber: phaub.
phaub published a new version of this document.Wed, Nov 17, 17:50
chiarutt edited the content of this document. (Show Details)Wed, Nov 17, 20:57
vqtrinh added a subscriber: vqtrinh.Mon, Nov 22, 22:00

Hi - I'm interested in trying this approach out - the link for Image Combiner Warpy is down would it be possible to create a new link?