Page history Edit this page How do I edit this website?

Warpy Image Combiner

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 Warpy extension to combine registered whole slide images.

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.)

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


ImageCombinerWarpy is included in the BIOP EPFL QuPath Warpy extension.

Please look at the installation instructions in the 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.)

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.


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.

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.

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

Additional Information