Comments on: Finding the right level of documentation http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/ Steve Eddins manages the Image & Geospatial development team at <a href="http://www.mathworks.com/">The MathWorks</a> and coauthored <a href="http://www.mathworks.com/support/books/book5291.html?category=-1&language=-1">Digital Image Processing Using MATLAB</a>. He writes here about image processing concepts, algorithm implementations, and MATLAB.<br><br><img> Sun, 22 Nov 2009 22:59:49 +0000 http://wordpress.org/?v=2.3.1 By: Steve http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21815 Steve Mon, 01 Jun 2009 14:40:52 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21815 Dave—What error message are you getting? You might try looking at the book <em>Digital Image Processing Using MATLAB</em>. Also, if you have the Image Processing Toolbox you can look at the code for <tt>deconvwnr</tt>. Dave—What error message are you getting? You might try looking at the book Digital Image Processing Using MATLAB. Also, if you have the Image Processing Toolbox you can look at the code for deconvwnr.

]]> By: dave http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21762 dave Thu, 14 May 2009 10:35:32 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21762 Hi Steve, This is an excellent series you're conducting. Referring to your introductory paper and the basic equation for the degraded image in terms of the PSF and noise, I wanted to implement (without using the built-in matlab functions for it) the weiner filtering of any imported blurred image to the workspace. I'm following the steps outlined and the mathematical equations given on pgs 350 and 355 of Prof Raphael Gonzalez's 'Digital Image Processing'text; found the fft2 of the image and typed in the function H(u,v)on pg350 into the matlab workspace, tried to multiply them directly (in freq.domain multiplication), kept getting an error message. I suspect there is something wrong in terms of mismatched data-type. Could you explain to me what i should do to simply get from a simple mathematical expression for the Fourier transform of H(u,v)to a data type that can be multipled with the image fft, to give the degraded image G(u,v)? My aim ultimately is to obtain a coded representation for the expression on pg355, so that i can input any blurred, noisy image to get an acceptable original. Hi Steve,
This is an excellent series you’re conducting. Referring to your introductory paper and the basic equation for the degraded image in terms of the PSF and noise, I wanted to implement (without using the built-in matlab functions for it) the weiner filtering of any imported blurred image to the workspace. I’m following the steps outlined and the mathematical equations given on pgs 350 and 355 of Prof Raphael Gonzalez’s ‘Digital Image Processing’text; found the fft2 of the image and typed in the function H(u,v)on pg350 into the matlab workspace, tried to multiply them directly (in freq.domain multiplication), kept getting an error message. I suspect there is something wrong in terms of mismatched data-type. Could you explain to me what i should do to simply get from a simple mathematical expression for the Fourier transform of H(u,v)to a data type that can be multipled with the image fft, to give the degraded image G(u,v)? My aim ultimately is to obtain a coded representation for the expression on pg355, so that i can input any blurred, noisy image to get an acceptable original.

]]> By: Steve http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21735 Steve Wed, 06 May 2009 12:39:20 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21735 David—Thanks for your feedback, that's useful to know. Hey, I taught Computer Vision a couple of times way back in my previous life. The first time I was assigned to teach it, I felt like I spent the whole term learning it about 60 minutes in advance of the class. ;-) David—Thanks for your feedback, that’s useful to know. Hey, I taught Computer Vision a couple of times way back in my previous life. The first time I was assigned to teach it, I felt like I spent the whole term learning it about 60 minutes in advance of the class. ;-)

]]> By: David Young http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21734 David Young Wed, 06 May 2009 12:30:00 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21734 I struggled trying to understand imregionalmax etc. and I too found the documentation unhelpful - and I teach Computer Vision. I got there in the end, but only after searching the web, looking at the code (which really shouldn't be needed) and a lot of head scratching. So better documentation would be most welcome. The top priority in my view is clear statements of the algorithms, rather than a tutorial introduction, though that would be useful too. However, I don't think this represents a general problem. I haven't had this experience with other IPT functions - there's either clear documentation, or like dilation for example they implement well-known operations. So I see imregionalmax (and its family) as a particular lapse, which I hope you can fix, rather than as a symptom of a systematic issue. I agree about PUBLISH! I struggled trying to understand imregionalmax etc. and I too found the documentation unhelpful - and I teach Computer Vision. I got there in the end, but only after searching the web, looking at the code (which really shouldn’t be needed) and a lot of head scratching. So better documentation would be most welcome. The top priority in my view is clear statements of the algorithms, rather than a tutorial introduction, though that would be useful too.

However, I don’t think this represents a general problem. I haven’t had this experience with other IPT functions - there’s either clear documentation, or like dilation for example they implement well-known operations. So I see imregionalmax (and its family) as a particular lapse, which I hope you can fix, rather than as a symptom of a systematic issue.

I agree about PUBLISH!

]]> By: Luis http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21725 Luis Fri, 01 May 2009 02:29:30 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21725 Steve, I came to "imextendedmax" by way of one of your earlier examples. Since you are part of Mathworks, I like to think that you are providing additional reference information. More, I think that in looking at the functions available and the options available for each of the functions, there is plenty to absorb. One can always benefit of more... Perhaps a MatLab wiki would be helpful because other people who know can always chip-in. Just for instance, I went crazy looking for a way to get the location of imellipses that I had drawn. I had too many to create a handler for each ... my luck, there was a note somewhere in the site with the info I needed. Last, I enjoy your blogs (and the links to other sites you provide). Cheers. Steve,

I came to “imextendedmax” by way of one of your earlier examples. Since you are part of Mathworks, I like to think that you are providing additional reference information.
More, I think that in looking at the functions available and the options available for each of the functions, there is plenty to absorb. One can always benefit of more…
Perhaps a MatLab wiki would be helpful because other people who know can always chip-in.

Just for instance, I went crazy looking for a way to get the location of imellipses that I had drawn. I had too many to create a handler for each … my luck, there was a note somewhere in the site with the info I needed.

Last, I enjoy your blogs (and the links to other sites you provide).

Cheers.

]]> By: Oliver Woodford http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21656 Oliver Woodford Sat, 04 Apr 2009 15:35:12 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21656 Many thanks for the explanation, Steve. I guess the moral of this story is that while rand will produce a useful test case for many operations, there are some for which it isn't suitable, i.e. doesn't cover all scenarios. Many thanks for the explanation, Steve.

I guess the moral of this story is that while rand will produce a useful test case for many operations, there are some for which it isn’t suitable, i.e. doesn’t cover all scenarios.

]]> By: Steve http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21655 Steve Sat, 04 Apr 2009 15:17:17 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21655 Oliver—<tt>imregionalmax</tt> is implementing a more complex operation than your <tt>imdilate</tt> solution. Compare the output of the two solutions with this one-dimensional input: <pre> 1 2 3 4 4 4 4 4 4 5 6 7 8 8 7 6 5 </pre> Those middle 4's are not considered to be a regional maximum. From that location, if you travel to the right, you can continue uphill. The <tt>imdilate</tt> solution mark those locations as maxima. Oliver—imregionalmax is implementing a more complex operation than your imdilate solution. Compare the output of the two solutions with this one-dimensional input:

1 2 3 4 4 4 4 4 4 5 6 7 8 8 7 6 5

Those middle 4’s are not considered to be a regional maximum. From that location, if you travel to the right, you can continue uphill. The imdilate solution mark those locations as maxima.

]]> By: Oliver Woodford http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21654 Oliver Woodford Sat, 04 Apr 2009 15:11:19 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21654 I have once again learned something new at a very opportune time from a TMW blog post. I recently implemented 2-d maxima finding using a method I found mentioned in MATLAB FEX submission 14498: >> A = rand(1000); >> tic; B = imdilate(A, ones(3)) == A; toc Elapsed time is 0.346276 seconds. However, before switching to imregionalmax (after reading this post) I thought I'd compare it with my current method, and this is what I got: >> tic; C = imregionalmax(A); toc Elapsed time is 0.410890 seconds. >> disp(isequal(B, C)) 1 I have once again learned something new at a very opportune time from a TMW blog post. I recently implemented 2-d maxima finding using a method I found mentioned in MATLAB FEX submission 14498:
>> A = rand(1000);
>> tic; B = imdilate(A, ones(3)) == A; toc
Elapsed time is 0.346276 seconds.

However, before switching to imregionalmax (after reading this post) I thought I’d compare it with my current method, and this is what I got:
>> tic; C = imregionalmax(A); toc
Elapsed time is 0.410890 seconds.
>> disp(isequal(B, C))
1

]]> By: Steve http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21653 Steve Sat, 04 Apr 2009 13:14:55 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21653 Bård—Thanks for sharing your thoughts. I love PUBLISH, too! And good luck with your product. Bård—Thanks for sharing your thoughts. I love PUBLISH, too! And good luck with your product.

]]> By: Bård Skaflestad http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21652 Bård Skaflestad Sat, 04 Apr 2009 09:40:41 +0000 http://blogs.mathworks.com/steve/2009/04/03/finding-the-right-level-of-documentation/#comment-21652 Steve, Thank you for this very interesting blog entry. The company I work for just released a Toolbox-style package of M-files for simulating (simple) porous media flow. Granted, this is our first release so the package clearly isn't as polished as it could be were it produced by, say, The MathWorks. Still, the package does contain a number of fairly advanced features--some of which have never been released in code before. At least to our knowledge. For documentation we chose to use 'help'-style descriptions of parameters and return values for the individual functions--often accompanied by simple usage examples. However, we deemed this kind of documentation to be too succinct for new users so we included several fully worked examples demonstrating the features in context. By the way: The PUBLISH function is wonderful! Overall, I think we have found a fair balance between technical description and tutorials--at least for a first release. We're considering writing more detailed, i.e., DOC-style, documentation for the individual package functions, but this will have to wait until the next release. Best regards, Bård Skaflestad SINTEF ICT, Applied Mathematics Steve,

Thank you for this very interesting blog entry. The company I work for just released a Toolbox-style package of M-files for simulating (simple) porous media flow. Granted, this is our first release so the package clearly isn’t as polished as it could be were it produced by, say, The MathWorks.

Still, the package does contain a number of fairly advanced features–some of which have never been released in code before. At least to our knowledge. For documentation we chose to use ‘help’-style descriptions of parameters and return values for the individual functions–often accompanied by simple usage examples. However, we deemed this kind of documentation to be too succinct for new users so we included several fully worked examples demonstrating the features in context. By the way: The PUBLISH function is wonderful!

Overall, I think we have found a fair balance between technical description and tutorials–at least for a first release. We’re considering writing more detailed, i.e., DOC-style, documentation for the individual package functions, but this will have to wait until the next release.

Best regards,

Bård Skaflestad
SINTEF ICT, Applied Mathematics

]]>