Page MenuHomec4science

Image Combiner Warpy
Updated 203 Days AgoPublic

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

ImageCombinerWarpy is a QuPath (v0.3.x) 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

ImageCombinerWarpy is included in the BIOP EPFL QuPath Warpy extension.

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 Additional Information.

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

WARNING: I 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: II Images in QuPath project entries, created with ImageCombinerWarpy, may not show the pixel contents of the original images! The pixel difference between the original and the transformed image depends on the transformation, the used interpolation as well as the downsampling used in the current viewer. This must be taken into account in all analysis steps performed on such transformed images.
WARNING: III 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.

Additional Information can be found on https://c4science.ch/w/warpy/imagecombinerwarpy/addinfo/.

Last Author
phaub
Last Edited
Jan 17 2022, 15:29

Event Timeline

phaub created this document.Nov 17 2021, 16:52
phaub edited the content of this document. (Show Details)
chiarutt edited the content of this document. (Show Details)Nov 17 2021, 16:55
phaub edited the content of this document. (Show Details)Nov 17 2021, 17:17
phaub edited the content of this document. (Show Details)Nov 17 2021, 17:20
phaub edited the content of this document. (Show Details)Nov 17 2021, 17:25
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Nov 17 2021, 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.Nov 17 2021, 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.Nov 17 2021, 17:33
phaub edited the content of this document. (Show Details)
phaub changed the title from Imagecombinerwarpy to Image Combiner Warpy.Nov 17 2021, 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.Nov 17 2021, 17:46
phaub edited the content of this document. (Show Details)
phaub added a subscriber: phaub.
phaub published a new version of this document.Nov 17 2021, 17:50
chiarutt edited the content of this document. (Show Details)Nov 17 2021, 20:57
vqtrinh added a subscriber: vqtrinh.Nov 22 2021, 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?

phaub edited the content of this document. (Show Details)Dec 16 2021, 13:25
phaub edited the content of this document. (Show Details)Jan 7 2022, 12:35
phaub edited the content of this document. (Show Details)Jan 7 2022, 14:12
phaub removed subscribers: vqtrinh, phaub.
chiarutt edited the content of this document. (Show Details)Jan 10 2022, 22:02
phaub edited the content of this document. (Show Details)Jan 11 2022, 10:54
phaub edited the content of this document. (Show Details)Jan 17 2022, 15:29