{"id":208,"date":"2008-04-24T07:00:14","date_gmt":"2008-04-24T11:00:14","guid":{"rendered":"https:\/\/blogs.mathworks.com\/steve\/2008\/04\/24\/visualizing-the-output-of-bwlabel\/"},"modified":"2019-10-28T09:30:13","modified_gmt":"2019-10-28T13:30:13","slug":"visualizing-the-output-of-bwlabel","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/steve\/2008\/04\/24\/visualizing-the-output-of-bwlabel\/","title":{"rendered":"Visualizing the output of bwlabel"},"content":{"rendered":"
\r\n

I often find myself writing small functions that help visualize certain image processing algorithms. For example, my last\r\n three posts on bwlabel<\/tt> included identical snippets of code that performed the following steps on a label matrix:\r\n <\/p>\r\n

1. Display a binary image using two light shades of gray.<\/p>\r\n

2. Use regionprops<\/tt> to find the location of each labeled object.\r\n <\/p>\r\n

3. Superimpose object text labels over each labeled object.<\/p>\r\n

The visualization code, although not complicated, was longer than the algorithm code I was trying to explain. That can obscure\r\n the key points of the discussion. It would be nice if there were a single visualization function to call.\r\n <\/p>\r\n

In the past, we haven't put algorithm visualization functions into the Image Processing Toolbox. They don't really increase\r\n what you can do with the toolbox, and there are many different visualization techniques that might be useful for any given\r\n algorithm. Even within a single basic technique, such as my bwlabel<\/tt> visualization, there are many possible variations.\r\n <\/p>\r\n

Still, algorithm visualizations can be very useful. We've been talking recently about including \"example\" visualizations\r\n in the toolbox. My idea is that each example visualization should have simple code and a simple syntax. We shouldn't succumb\r\n to the temptation to overdesign these examples by supporting lots of options and variations, or by overoptimizing them. The\r\n primary purpose of the examples would be to provide inspiration and a starting point for our users to create their own visualizations.\r\n <\/p>\r\n

This week I captured the visualization code from my recent posts into a function called VISLABELS<\/a>, which I uploaded to the\r\n MATLAB Central File Exchange. Here's how to use it:\r\n <\/p>

help vislabels<\/span><\/pre>
 VISLABELS Visualize labels of connected components\r\n    VISLABELS is used to visualize the output of BWLABEL.\r\n \r\n    VISLABELS(L), where L is a label matrix returned by BWLABEL,\r\n    displays each object's label number on top of the object itself.\r\n \r\n    Note: VISLABELS requires the Image Processing Toolbox.\r\n \r\n    Example\r\n    -------\r\n        bw = imread('text.png');\r\n        L = bwlabel(bw);\r\n        vislabels(L)\r\n        axis([1 70 1 70])\r\n\r\n<\/pre>
And here's what the example does:<\/p>
bw = imread('text.png'<\/span>);\r\nL = bwlabel(bw);\r\nvislabels(L)\r\naxis([1 70 1 70])<\/pre> 
Do you have your own favorite ways of visualizing algorithms?  I encourage you to share them on the File Exchange.<\/p>