Laplace Operator

Table of Contents

• Goal
• Theory
  • Laplacian Operator
• Code
• Explanation
  • Declare variables
  • Load source image
  • Reduce noise
  • Grayscale
  • Laplacian operator
  • Convert output to a <em>CV_8U</em> image
  • Display the result
• Results

Prev Tutorial: Sobel Derivatives
Next Tutorial: Canny Edge Detector

Original author	Ana Huamán
Compatibility	OpenCV >= 3.0

Goal

In this tutorial you will learn how to:

• Use the OpenCV function Laplacian() to implement a discrete analog of the Laplacian operator.

Theory

1. In the previous tutorial we learned how to use the Sobel Operator. It was based on the fact that in the edge area, the pixel intensity shows a "jump" or a high variation of intensity. Getting the first derivative of the intensity, we observed that an edge is characterized by a maximum, as it can be seen in the figure:

1. And...what happens if we take the second derivative?

You can observe that the second derivative is zero! So, we can also use this criterion to attempt to detect edges in an image. However, note that zeros will not only appear in edges (they can actually appear in other meaningless locations); this can be solved by applying filtering where needed.

Laplacian Operator

1. From the explanation above, we deduce that the second derivative can be used to detect edges. Since images are "*2D*", we would need to take the derivative in both dimensions. Here, the Laplacian operator comes handy.

2. The Laplacian operator is defined by:

   \[Laplace(f) = \dfrac{\partial^{2} f}{\partial x^{2}} + \dfrac{\partial^{2} f}{\partial y^{2}}\]

3. The Laplacian operator is implemented in OpenCV by the function Laplacian() . In fact, since the Laplacian uses the gradient of images, it calls internally the Sobel operator to perform its computation.

Code

1. What does this program do?
   • Loads an image
   • Remove noise by applying a Gaussian blur and then convert the original image to grayscale
   • Applies a Laplacian operator to the grayscale image and stores the output image
   • Display the result in a window

C++

1. The tutorial code's is shown lines below. You can also download it from here

    
   #include "opencv2/imgproc.hpp"
   #include "opencv2/imgcodecs.hpp"
   #include "opencv2/highgui.hpp"
    
   using namespace cv;
    
   int main( int argc, char** argv )
   {
       // Declare the variables we are going to use
       Mat src, src_gray, dst;
       int kernel_size = 3;
       int scale = 1;
       int delta = 0;
       int ddepth = CV_16S;
       const char* window_name = "Laplace Demo";
    
       const char* imageName = argc >=2 ? argv[1] : "lena.jpg";
    
       src = imread( samples::findFile( imageName ), IMREAD_COLOR ); // Load an image
    
       // Check if image is loaded fine
       if(src.empty()){
           printf(" Error opening image\n");
           printf(" Program Arguments: [image_name -- default lena.jpg] \n");
           return -1;
       }
    
       // Reduce noise by blurring with a Gaussian filter ( kernel size = 3 )
       GaussianBlur( src, src, Size(3, 3), 0, 0, BORDER_DEFAULT );
    
       cvtColor( src, src_gray, COLOR_BGR2GRAY ); // Convert the image to grayscale
    
       Mat abs_dst;
       Laplacian( src_gray, dst, ddepth, kernel_size, scale, delta, BORDER_DEFAULT );
    
       // converting back to CV_8U
       convertScaleAbs( dst, abs_dst );
    
       imshow( window_name, abs_dst );
       waitKey(0);
    
       return 0;
   }

Java

1. The tutorial code's is shown lines below. You can also download it from here

    
   import org.opencv.core.*;
   import org.opencv.highgui.HighGui;
   import org.opencv.imgcodecs.Imgcodecs;
   import org.opencv.imgproc.Imgproc;
    
   class LaplaceDemoRun {
    
       public void run(String[] args) {
           // Declare the variables we are going to use
           Mat src, src_gray = new Mat(), dst = new Mat();
           int kernel_size = 3;
           int scale = 1;
           int delta = 0;
           int ddepth = CvType.CV_16S;
           String window_name = "Laplace Demo";
    
           String imageName = ((args.length > 0) ? args[0] : "../data/lena.jpg");
    
           src = Imgcodecs.imread(imageName, Imgcodecs.IMREAD_COLOR); // Load an image
    
           // Check if image is loaded fine
           if( src.empty() ) {
               System.out.println("Error opening image");
               System.out.println("Program Arguments: [image_name -- default ../data/lena.jpg] \n");
               System.exit(-1);
           }
    
           // Reduce noise by blurring with a Gaussian filter ( kernel size = 3 )
           Imgproc.GaussianBlur( src, src, new Size(3, 3), 0, 0, Core.BORDER_DEFAULT );
    
           // Convert the image to grayscale
           Imgproc.cvtColor( src, src_gray, Imgproc.COLOR_RGB2GRAY );
    
           Mat abs_dst = new Mat();
           Imgproc.Laplacian( src_gray, dst, ddepth, kernel_size, scale, delta, Core.BORDER_DEFAULT );
    
           // converting back to CV_8U
           Core.convertScaleAbs( dst, abs_dst );
    
           HighGui.imshow( window_name, abs_dst );
           HighGui.waitKey(0);
    
           System.exit(0);
       }
   }
    
   public class LaplaceDemo {
       public static void main(String[] args) {
           // Load the native library.
           System.loadLibrary(Core.NATIVE_LIBRARY_NAME);
           new LaplaceDemoRun().run(args);
       }
   }

Python

1. The tutorial code's is shown lines below. You can also download it from here

   """
   @file laplace_demo.py
   @brief Sample code showing how to detect edges using the Laplace operator
   """
   import sys
   import cv2 as cv
    
   def main(argv):
       # [variables]
       # Declare the variables we are going to use
       ddepth = cv.CV_16S
       kernel_size = 3
       window_name = "Laplace Demo"
       # [variables]
    
       # [load]
       imageName = argv[0] if len(argv) > 0 else 'lena.jpg'
    
       src = cv.imread(cv.samples.findFile(imageName), cv.IMREAD_COLOR) # Load an image
    
       # Check if image is loaded fine
       if src is None:
           print ('Error opening image')
           print ('Program Arguments: [image_name -- default lena.jpg]')
           return -1
       # [load]
    
       # [reduce_noise]
       # Remove noise by blurring with a Gaussian filter
       src = cv.GaussianBlur(src, (3, 3), 0)
       # [reduce_noise]
    
       # [convert_to_gray]
       # Convert the image to grayscale
       src_gray = cv.cvtColor(src, cv.COLOR_BGR2GRAY)
       # [convert_to_gray]
    
       # Create Window
       cv.namedWindow(window_name, cv.WINDOW_AUTOSIZE)
    
       # [laplacian]
       # Apply Laplace function
       dst = cv.Laplacian(src_gray, ddepth, ksize=kernel_size)
       # [laplacian]
    
       # [convert]
       # converting back to uint8
       abs_dst = cv.convertScaleAbs(dst)
       # [convert]
    
       # [display]
       cv.imshow(window_name, abs_dst)
       cv.waitKey(0)
       # [display]
    
       return 0
    
   if __name__ == "__main__":
       main(sys.argv[1:])

Explanation

Declare variables

C++

    // Declare the variables we are going to use
    Mat src, src_gray, dst;
    int kernel_size = 3;
    int scale = 1;
    int delta = 0;
    int ddepth = CV_16S;
    const char* window_name = "Laplace Demo";

Java

        // Declare the variables we are going to use
        Mat src, src_gray = new Mat(), dst = new Mat();
        int kernel_size = 3;
        int scale = 1;
        int delta = 0;
        int ddepth = CvType.CV_16S;
        String window_name = "Laplace Demo";

Python

    # Declare the variables we are going to use
    ddepth = cv.CV_16S
    kernel_size = 3
    window_name = "Laplace Demo"

Load source image

C++

    const char* imageName = argc >=2 ? argv[1] : "lena.jpg";
 
    src = imread( samples::findFile( imageName ), IMREAD_COLOR ); // Load an image
 
    // Check if image is loaded fine
    if(src.empty()){
        printf(" Error opening image\n");
        printf(" Program Arguments: [image_name -- default lena.jpg] \n");
        return -1;
    }

Java

        String imageName = ((args.length > 0) ? args[0] : "../data/lena.jpg");
 
        src = Imgcodecs.imread(imageName, Imgcodecs.IMREAD_COLOR); // Load an image
 
        // Check if image is loaded fine
        if( src.empty() ) {
            System.out.println("Error opening image");
            System.out.println("Program Arguments: [image_name -- default ../data/lena.jpg] \n");
            System.exit(-1);
        }

Python

    imageName = argv[0] if len(argv) > 0 else 'lena.jpg'
 
    src = cv.imread(cv.samples.findFile(imageName), cv.IMREAD_COLOR) # Load an image
 
    # Check if image is loaded fine
    if src is None:
        print ('Error opening image')
        print ('Program Arguments: [image_name -- default lena.jpg]')
        return -1

Reduce noise

C++

    // Reduce noise by blurring with a Gaussian filter ( kernel size = 3 )
    GaussianBlur( src, src, Size(3, 3), 0, 0, BORDER_DEFAULT );

Java

        // Reduce noise by blurring with a Gaussian filter ( kernel size = 3 )
        Imgproc.GaussianBlur( src, src, new Size(3, 3), 0, 0, Core.BORDER_DEFAULT );

Python

    # Remove noise by blurring with a Gaussian filter
    src = cv.GaussianBlur(src, (3, 3), 0)

Grayscale

C++

    cvtColor( src, src_gray, COLOR_BGR2GRAY ); // Convert the image to grayscale

Java

        // Convert the image to grayscale
        Imgproc.cvtColor( src, src_gray, Imgproc.COLOR_RGB2GRAY );

Python

    # Convert the image to grayscale
    src_gray = cv.cvtColor(src, cv.COLOR_BGR2GRAY)

Laplacian operator

C++

    Laplacian( src_gray, dst, ddepth, kernel_size, scale, delta, BORDER_DEFAULT );

Java

        Imgproc.Laplacian( src_gray, dst, ddepth, kernel_size, scale, delta, Core.BORDER_DEFAULT );

Python

    # Apply Laplace function
    dst = cv.Laplacian(src_gray, ddepth, ksize=kernel_size)

• The arguments are:
  • src_gray: The input image.
  • dst: Destination (output) image
  • ddepth: Depth of the destination image. Since our input is CV_8U we define ddepth = CV_16S to avoid overflow
  • kernel_size: The kernel size of the Sobel operator to be applied internally. We use 3 in this example.
  • scale, delta and BORDER_DEFAULT: We leave them as default values.

Convert output to a CV_8U image

C++

    // converting back to CV_8U
    convertScaleAbs( dst, abs_dst );

Java

        // converting back to CV_8U
        Core.convertScaleAbs( dst, abs_dst );

Python

    # converting back to uint8
    abs_dst = cv.convertScaleAbs(dst)

Display the result

C++

    imshow( window_name, abs_dst );
    waitKey(0);

Java

        HighGui.imshow( window_name, abs_dst );
        HighGui.waitKey(0);

Python

    cv.imshow(window_name, abs_dst)
    cv.waitKey(0)

Results

1. After compiling the code above, we can run it giving as argument the path to an image. For example, using as an input:

1. We obtain the following result. Notice how the trees and the silhouette of the cow are approximately well defined (except in areas in which the intensity are very similar, i.e. around the cow's head). Also, note that the roof of the house behind the trees (right side) is notoriously marked. This is due to the fact that the contrast is higher in that region.