Warp¶
Find the transformation matrix that best describes the projective transform from reference image (refimg
)
to target image (img
), based on pairs of corresponding points on the images. The projection aligns img
to refimg
.
In PlantCV we only consider the general case of projective transform.
In general, any geometric transformation between 4 pairs of corresponding points is considered as projective transform. Projective transformation is often useful when images are taken from a slight different point of view or taken with different cameras.
 Projective Transform: preserves lines but not necessarily parallelism. There are several special cases of projective transform.
 Euclidean Transform (rigid transform): preserves the Euclidean distance between pairs of points.
It can be described as a rotation about the origin followed by a translation.
 Similarity Transform: preserves the shape of objects. It combines scaling, translation and rotation.
 Affine Transform: preserves lines (hence the alignment of objects), as well as parallelism between lines. It can be decomposed into a similarity transform and a shear transformation.
Read more about different transformations at Image Processing in OpenCV and the transform module of scikitimage.
plantcv.transform.warp(img, refimg, pts, refpts, method="default")
returns image after warping and a 3x3 matrix of the perspective transformation.
 Parameters:
 img  (np.ndarray) image to warp
 refimg  (np.ndarray) image used as a reference for the warp
 pts  (list) coordinate points on
img
. At least 4 pairs should be given as a list of tuples  refpts  (list) corresponding coordinate points on
refimg
. At least 4 pairs should be given as a list of tuples  method  (str) method used to compute the transformation (homography) matrix.
Available options are 'default', 'ransac', 'lmeds', 'rho' which correspond to the
opencv methods.
and vary based on how they handle outlier points
 'default': a regular method (the least squares method) using all the points
 'ransac': RANSACbased robust method (Random sample consensus)
 'lmeds': LeastMedian robust method (Least Median of Squares)
 'RHO': PROSACbased robust method (PROSAC)
 Context:
 Warps an image without preserving parallel lines.
 Example use:
Note
Any 4 or more pairs of noncollinear points define a transformation. However, if not all the point pairs fit the projective transformation (which means there are outliers), the initial estimate of transformation matrix will be poor. In this case, one of the three robust estimation methods can be adopted. The methods RANSAC and RHO an handle practically any ratio of outliers. The LeastMedian based method works correctly only when there are more than 50% of inliers. Finally, if there are no outliers and the noise is rather small, use the default method. If a robust estimation algorithm is adopted, the outliers will be indicated in the debug image with triangles.
 A binary mask derived from an RGB image can be used to segment an NIR image which is difficult to segment otherwise.
RGB image
Input image (mask)
A mask derived from the RGB image
An image from an NIR camera is used as the reference image to define the transformation
from plantcv import plantcv as pcv
img_warped, mat = pcv.transform.warp(img=mask, refimg=nir,
pts = [(500, 454), (1995, 454), (1995, 1136), (1984, 1811), (511, 1804),
(500, 1136)],
refpts = [(106, 119), (527, 120), (526, 314), (526, 504), (106, 505),
(106, 311)],
method='lmeds')
Reference points on the NIR image
Mask overlaid on the NIR image
 Register the RGB image to the corresponding thermal image based on landmark points so that the mask derived from it can be used to extract plant pixels from the corresponding thermal image.
Input Image
A thermal image (reference image) and its corresponding RGB image (target image).
See the poor overlay of the thermal image on the corresponding RGB image before image registration:
We define pairs of corresponding landmark points on both images:
Currently you'll need to do some trial and error to identify matching coordinates but check back later for information of getting landmark coordinates to register two images in a userfriendly interactive way!
from plantcv import plantcv as pcv
pcv.params.marker_size=12
img_warped, mat = pcv.transform.warp(img=im_RGB,
refimg=im_therm,
pts=pts_RGB,
refpts=pts_therm,
method = 'ransac')
Warped RGB image:
Overlay the thermal image on warped RGB image:
Reference image with markers:
Target image with markers:
A pair of corresponding inlier points are represented with the same color with the "+" marker; the outliers are represented using upper triangles.
Warp Align¶
plantcv.transform.warp_align(img, refimg, mat)
returns image after warping.
Highly related to the warp
function, the warp_align
function takes an input image, a transformation matrix,
and perform the geometric transformation defined by the given transformation matrix.

Parameters:
 img  (np.ndarray) image to warp
 refimg  (np.ndarray) image used as a reference for the warp. If provided, the warped image would be overlaid on the reference image to visualize; otherwise, the warped image would be overlaid on the original image.
 mat  (np.ndarray) a 3x3 matrix that describes the projective transformation.
Typically, it would be the 2nd output of the
transform.warp
function.

Context:
 Warps an image based on the transformation matrix.

Example use:
from plantcv import plantcv as pcv
import numpy as np
# M1 is the 2nd output from pcv.transform.warp
img_warped = pcv.transform.warp_align(img=im_RGB, refimg=im_therm, mat=M1)
# M2 defines a translation transformation, which is a special case of projective transformation
M2 = np.array([[1.0,0.0,100.0],[0.0,1.0,50.0],[0.0,0.0,1.0]])
# A reference image is not available so im_RGB can be used instead
img_warped2 = pcv.transform.warp_align(img=im_RGB, img=im_RGB, mat=M2)
Warped image:
Superimposed image of the warped image and the reference image (reference image provided):
Warped image:
Superimposed image of the warped image and the original image (reference image not provided):
Source Code: Here