{"id":3400,"date":"2019-08-30T16:08:16","date_gmt":"2019-08-30T20:08:16","guid":{"rendered":"https:\/\/blogs.mathworks.com\/steve\/?p=3400"},"modified":"2019-11-01T22:47:03","modified_gmt":"2019-11-02T02:47:03","slug":"using-reshape-to-rearrange-image-color-components","status":"publish","type":"post","link":"https:\/\/blogs.mathworks.com\/steve\/2019\/08\/30\/using-reshape-to-rearrange-image-color-components\/","title":{"rendered":"Using reshape to rearrange image color components"},"content":{"rendered":"

I recently saw some code that transformed the RGB pixel values of an image into a Px3 matrix, such that each row contained the red, green, and blue color components of a single pixel. Today I want to show that code fragment, explain it, and then demonstrate what I think is the fastest possible to perform that transformation in MATLAB.<\/p>

I tend to use the peppers sample image a lot, so I'll switch things up and use NGC6543 instead:<\/p>

RGB = imread('ngc6543a.jpg'<\/span>);\r\nimshow(RGB)\r\n<\/pre>\"\" 
Historical note: This was the first \"truecolor\" sample image to ship with MATLAB.<\/p>
RGB<\/tt> is a three-dimensional array:<\/p>
size(RGB)\r\n<\/pre>
\r\nans =\r\n\r\n   650   600     3\r\n\r\n<\/pre>
The third dimension, which has length three, contains the red, green, and blue component images. Compare, for example, the red and green component images:<\/p>
imshow(RGB(:,:,1))\r\n<\/pre>\"\" 
imshow(RGB(:,:,2))\r\n<\/pre>\"\" 
Here is the code that I saw for transforming this array into a Px3 matrix, where each row contains the three color component values of one pixel:<\/p>
red = RGB(:,:,1);\r\ngreen = RGB(:,:,2);\r\nblue = RGB(:,:,3);\r\n\r\nA = [red(:) green(:) blue(:)];\r\n<\/pre>
The first five pixels are along the uppermost left edge of the image, and they are all black:<\/p>
A(1:5,:)\r\n<\/pre>
\r\nans =\r\n\r\n  5×3 uint8 matrix\r\n\r\n   0   0   0\r\n   0   0   0\r\n   0   0   0\r\n   0   0   0\r\n   0   0   0\r\n\r\n<\/pre>
The first three lines of code did not give me pause:<\/p>
red = RGB(:,:,1);\r\ngreen = RGB(:,:,2);\r\nblue = RGB(:,:,3);<\/pre>
I have written code just like that approximately 2.7183 bazillion times. It was the next line that made me stop and scratch my head for a moment:<\/p>
A = [red(:) green(:) blue(:)];<\/pre>
Hmm. The array is being split apart into three components, which are then immediately put back together into a matrix. That suggests ... reshape<\/tt>, maybe?<\/p>
Yes, as it turns out, this can all be done with a call to reshape<\/tt>. And, there is a big advantage to doing so, as I'll explain in a moment. First, the new code:<\/p>
B = reshape(RGB,[],3);\r\n<\/pre>
That line of code says, \"MATLAB, reshape the array RGB<\/tt> so that it is Px3, and will you please just go ahead and figure out what P should be to make it work?\"<\/p>
You see in a call to reshape<\/tt>, the number of elements must not change. Here are the number of elements of the array RGB<\/tt>:<\/p>
numel(RGB)\r\n<\/pre>
\r\nans =\r\n\r\n     1170000\r\n\r\n<\/pre>
To reshape that successfully into a matrix with 3 columns, we can compute how many rows there must be:<\/p>
P = numel(RGB) \/ 3\r\n<\/pre>
\r\nP =\r\n\r\n      390000\r\n\r\n<\/pre>
The empty matrix as the second argument to reshape<\/tt> signals to MATLAB to compute that size automatically. That works out just fine:<\/p>
size(B)\r\n<\/pre>
\r\nans =\r\n\r\n      390000           3\r\n\r\n<\/pre>
So, each column of B<\/tt> has 390,000 elements. The first column of B<\/tt> contains the first 390,000 elements (in memory order) of RGB<\/tt>. The second column of B<\/tt> contains the second 390,000 elements of RGB<\/tt>, and similarly for the third column. Because of the way MATLAB arrangements elements in memory, these columns are exactly the elements from the red component, the green component, and the blue component of RGB<\/tt>.<\/p>
The big advantage of doing it this way is that MATLAB makes no memory copy of data when calling reshape<\/tt>. Because of this optimization, calls to reshape<\/tt> are almost instantaneous.<\/p>
Let reshape<\/tt> be your friend.<\/p>