Image package: Difference between revisions

Jump to navigation Jump to search
4,102 bytes added ,  10 June 2019
m
Remove redundant Category:Packages.
m (Remove redundant Category:Packages.)
(88 intermediate revisions by 8 users not shown)
Line 1: Line 1:
The {{Forge|image|image package}} is part of the octave-forge project. See its {{Forge|image|homepage}} for the latest release.
The {{Forge|image|image package}} is part of the Octave Forge project. See its {{Forge|image|homepage}} for the latest release.
 
<div class="tocinline">__TOC__</div>


== Development ==
== Development ==


Follows an incomplete list of stuff missing in the image package to be matlab compatible. Bugs are not listed here, [https://savannah.gnu.org/bugs/?func=search&group=octave search] and [https://savannah.gnu.org/bugs/?func=additem&group=octave report] them on the bug tracker instead.
Follows an incomplete list of stuff missing in the image package to be matlab compatible. Bugs are not listed here, [https://savannah.gnu.org/bugs/?func=search&group=octave search] and [https://savannah.gnu.org/bugs/?func=additem&group=octave report] them on the bug tracker instead.
=== Roadmap ===
The following are missing targets for the next minor release of the image package (version 2.8.0).  Small bug fixes, build fixes, and regressions may still be released before in a patch release (Version 2.6.X).
* add ellipse properties to {{codeline|regionprops}} (see bug {{bug|44100}})  ([http://hg.code.sf.net/p/octave/image/rev/7cf22a478792 done])
* speed up {{codeline|regionprops}} for large images with many small objects (probably work around for loop with labeled == labelid)
* support passing {{codeline|bwconncomp}} output to {{codeline|regionprops}} (and then fix {{codeline|bwpropfilt}} to use that instead of a labeled image)
* ND support on {{codeline|imfilter}}
* check if {{codeline|normxcorr2}} is Matlab compatible and investigate making use of {{codeline|fftconvn}} since it's likely to receive large input
* investigate implementing the missing deconvolution functions (see patch {{patch|8571}})
* anything else that is done or submitted before the above are done


=== Missing functions ===
=== Missing functions ===
Line 23: Line 13:
* activecontour
* activecontour
* adapthisteq
* adapthisteq
* affine2d
* [https://savannah.gnu.org/patch/?8824 affine2d]
* affine3d
* affine3d
* applycform
* applycform
* axes2pix
* bwconvhull
* bwconvhull
* bwdistgeodesic
* bwdistgeodesic
* bwlookup
* bwlookup
* bwpack
* bwtraceboundary
* bwtraceboundary
* bwulterode
* bwulterode
* bwunpack
* chromadapt
* colorcloud
* convmtx2
* convmtx2
* corner
* corner
Line 42: Line 31:
* dct2
* dct2
* dctmtx
* dctmtx
* imbinarize
* deconvblind
* deconvblind
* deconvlucy
* deconvlucy
* deconvreg
* deconvreg
* deconvwnr
* [https://savannah.gnu.org/patch/?9365 deconvwnr]
* decorrstretch
* decorrstretch
* demosaic
* [https://savannah.gnu.org/patch/?9593 demosaic]
* dicomanon
* dicomanon
* dicomdisp
* dicomdisp
* dicomuid
* dicomuid
* dpxinfo
* dpxread
* dpxread
* dpxinfo
* fan2para
* fan2para
* fanbeam
* fanbeam
Line 68: Line 58:
* getrect
* getrect
* gradientweight
* gradientweight
* grayconnected
* graycoprops
* graycoprops
* grayconnected
* graydiffweight
* graydiffweight
* hdrread
* hdrread
* hdrwrite
* hdrwrite
* houghlines -- (see hough_line)
* houghpeaks
* iccfind
* iccfind
* iccread
* iccread
Line 81: Line 69:
* idct2
* idct2
* ifanbeam
* ifanbeam
* illumgray
* illumpca
* illumwhite
* im2java2d
* im2java2d
* ImageAdapter
* ImageAdapter
* imageinfo
* imageinfo
* imapplymatrix
* [https://savannah.gnu.org/patch/?9717 imapplymatrix]
* imapprox
* imapprox
* imbinarize
* imbinarize
Line 95: Line 86:
* imdistline
* imdistline
* imellipse
* imellipse
* imextendedmax
* imextendedmin
* imfindcircles
* imfreehand
* imfreehand
* imfuse
* imfuse
Line 108: Line 96:
* imhandles
* imhandles
* imhistmatch
* imhistmatch
* imhmax
* imhmin
* imimposemin
* imline
* imline
* immagbox
* immagbox
Line 116: Line 101:
* imoverview
* imoverview
* imoverviewpanel
* imoverviewpanel
* impixelinfo
* [https://savannah.gnu.org/patch/?8722 impixelinfo]
* impixelinfoval
* [https://savannah.gnu.org/patch/?8722 impixelinfoval]
* impixelregion
* impixelregionpanel
* impixelregionpanel
* impixelregion
* implay
* implay
* impoint
* impoint
Line 141: Line 126:
* integralBoxFilter
* integralBoxFilter
* integralBoxFilter3
* integralBoxFilter3
* integralImage
* [https://savannah.gnu.org/patch/?9606 integralImage]
* integralImage3
* integralImage3
* interfileinfo
* interfileinfo
Line 159: Line 144:
* isicc
* isicc
* isrset
* isrset
* [https://savannah.gnu.org/patch/?9600 lin2rgb]
* makecform
* makecform
* makeConstrainToRectFcn
* makeConstrainToRectFcn
* makehdr
* makehdr
* makeresampler
* makeresampler
* multithresh
* [https://savannah.gnu.org/patch/?9602 multithresh]
* nitfinfo
* nitfinfo
* nitfread
* nitfread
* openrset
* openrset
* otsuthresh
* para2fan
* para2fan
* projective2d
* projective2d
* regionfill
* regionfill
* rgb2lin
* roifill
* roifill
* roifilt2
* roifilt2
* roipoly
* [https://savannah.gnu.org/patch/?9509 roipoly]
* rsetwrite
* rsetwrite
* ssim
* ssim
Line 180: Line 166:
* truesize
* truesize
* visboundaries
* visboundaries
* viscircles
* warp
* warp
* whitepoint
* [https://savannah.gnu.org/patch/?8060 whitepoint]
* wiener2
* [https://savannah.gnu.org/patch/?9603 xyz2double]
* xyz2double
* [https://savannah.gnu.org/patch/?9603 xyz2uint16]
* xyz2uint16
</div>
</div>


Line 219: Line 203:
|-
|-
! bug !! bug title !! status
! bug !! bug title !! status
|-
| {{bug|38085}} || image package: fails to build with --enable-64 (entropyfilt) || Confirmed
|-
|-
| {{bug|38087}}|| image package: graycomatrix incompatibilities with matlab  || None
| {{bug|38087}}|| image package: graycomatrix incompatibilities with matlab  || None
|-
| {{bug|38345}}|| image package: __spatial_filtering__() always returns class double || Confirmed
|-
|-
| {{bug|41674}}|| image package: temporary arrays in imresize are doubles || None
| {{bug|41674}}|| image package: temporary arrays in imresize are doubles || None
Line 236: Line 216:
| {{bug|44831}}|| image package: imrotate - different dimensions of output matrix || Confirmed
| {{bug|44831}}|| image package: imrotate - different dimensions of output matrix || Confirmed
|-
|-
| {{bug|45088}}|| image package: rangefilt requires domain and image to have equal number of dimensions || Patch Reviewed
| {{bug|45088}}|| image package: rangefilt requires domain and image to have equal number of dimensions || In Progress
|-
|-
| {{bug|46745}}|| image package: imresize default method (bicubic) Matlab incompatible for the border pixels|| None
| {{bug|46745}}|| image package: imresize default method (bicubic) Matlab incompatible for the border pixels|| None
Line 242: Line 222:
| {{bug|48529}}|| image package: compilation warnings under Mac OSX|| None
| {{bug|48529}}|| image package: compilation warnings under Mac OSX|| None
|-
|-
| {{bug|50071}}|| OF image: bwfill(...,4) in Octave behaves like bwfill(...,8) in MATLAB and vice versa|| None
|-
|-
| {{bug|50151}}|| image package: normxcorr2 is not compatible with Matlab|| None
| {{bug|50151}}|| image package: normxcorr2 is not compatible with Matlab|| None
Line 259: Line 238:
|-
|-
| {{bug|50732}} || Image package: infinite error loop when assigning a strel (class) object to a vector|| Confirmed
| {{bug|50732}} || Image package: infinite error loop when assigning a strel (class) object to a vector|| Confirmed
|-
| {{bug|50783}} || image package: imlincomb is not compatible with Matlab || none
|-
| {{bug|50874}} ||  bwdist call causes application crash || Confirmed
|-
|-
| {{bug|51420}} || [octave forge] (image) imrotate is less tolerant to missing argument than Matlab || None
| {{bug|51420}} || [octave forge] (image) imrotate is less tolerant to missing argument than Matlab || None
Line 276: Line 251:
| {{bug|51980}} || [octave forge] (image) Failing unit test for edge|| None
| {{bug|51980}} || [octave forge] (image) Failing unit test for edge|| None
|-
|-
| {{bug|51981}} || [octave forge] (image) Failing unit test for otf2psf|| None
| {{bug|52006}} || [octave forge] (image) 'makecform' feature request || Confirmed
|-
| {{bug|52119}} || [octave forge] (image) Add 'reflect' padding option to imfilter || None
|-
| {{bug|52715}} || [octave forge] (image) Add full data range option to ycbcrfunc conversions || None
|-
| {{bug|52959}} || [octave forge] (image) histeq is not compatible with Matlab || None
|-
|-
| {{bug|51982}} || [octave forge] (image) Failing unit test for nlfilter|| None
| {{bug|55059}} || [octave forge] (image) Failing unit test for grayslice || In Progress
|-
|-
| {{bug|51986}} || [octave forge] (image) Failing unit test for cp2tform || None
| {{bug|55202}} || [octave forge] (image) imresize fails for method nearest and image of 1 row  || Confirmed
|-
|-
| {{bug|52119}} || [octave forge] (image) Add 'reflect' padding option to imfilter || None
|}
|}


Line 294: Line 274:
* {{patch|8571}}: image package: three deconvolution routines (Wiener, RL, RLTV)
* {{patch|8571}}: image package: three deconvolution routines (Wiener, RL, RLTV)
* {{patch|8824}}: added affine2d class
* {{patch|8824}}: added affine2d class
* {{patch|9235}}: image package: improve filtering functions (stdfilt, entropyfilt) and add tests (also medfilt2, ordfilt2, rangefilt)
* {{patch|9509}}: Image package: simple implementation of roipoly function
* {{patch|9244}}: image package: regionprops.m - new properties ConvexHull, ConvexImage, ConvexArea, Solidity
* {{patch|9593}}: [Octave Forge] (Image) New function demosaic.m from bug #50708
* {{patch|9354}}: image package: new function wiener2.m
* {{patch|9600}}: [Octave Forge] (Image) New functions: lin2rgb.m and lrgb2lin.m
* {{patch|9360}}: image package: new function otsuthresh.m
* {{patch|9602}}: [octave forge] (image) multithresh
* {{patch|9365}}: image package: new function deconvwnr.m
* {{patch|9603}}: [Octave Forge] (Image) New functions: xyz2double.m, xyz2single.m, xyz2uint16.m
* {{patch|9407}}: image package: new function houghpeaks.m
* {{patch|9606}}: [Octave forge] (image) New function integralImage
* {{patch|9412}}: image package: new function houghlines.m
* {{patch|9717}}: [octave forge] (image) new function imapplymatrix
* {{patch|9448}}: image package: new function imfindcircles.m
* {{patch|9722}}: [octave forge] (image) new objects imref2d and imref3d
* {{patch|9449}}: image package: new function viscircles.m
* {{patch|9729}}: [octave forge] (image) -- rgb2xyz conversion with adapted whitepoint
* {{patch|9730}}: [octave forge] (image) new function imfuse


== Image Processing Functions (this section is under construction) ==
== Image Processing Functions ==


This is a list of Image Processing functions by topic, including missing functions, related bugs and patched, and some alternatives.
{{Note| This section is still under construction so the list is incomplete.}}


Note: This section is under construction so this list is still incomplete
This is a list of Image Processing functions by topic including: missing functions, related bugs and patches, and some alternatives.
 
Note: 


=== Basic Read and Write Image Files ===
=== Basic Read and Write Image Files ===
Line 316: Line 299:
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives !! Notes
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives !! Notes
|-  
|-  
| imfinfo || function is in Octave core || ||  
| imfinfo || function is in Octave core || || ||
|-  
|-  
| imread|| function is in Octave core || || [http://kyamagu.github.io/mexopencv/matlab/imread.html cv.imread] from [https://github.com/kyamagu/mexopencv mexopencv] ||  
| imread|| function is in Octave core || || [http://kyamagu.github.io/mexopencv/matlab/imread.html cv.imread] from [https://github.com/kyamagu/mexopencv mexopencv] ||  
Line 325: Line 308:
|-
|-
|}
|}
'''Missing:''' ''dicomanon, dicomdisp, dicomuid, dpxinfo, dpxread, interfileinfo, interfileread, nitfinfo, nitfread
''
=== High Dynamic Range Images - ''Not implemented'' ===
=== Large Image Files - ''Not implemented'' ===


=== Type Conversion  ===
=== Type Conversion  ===
Line 334: Line 324:
| adaptthresh || - || ||  [http://kyamagu.github.io/mexopencv/matlab/adaptiveThreshold.html cv.adaptiveThreshold] from [https://github.com/kyamagu/mexopencv mexopencv]||  
| adaptthresh || - || ||  [http://kyamagu.github.io/mexopencv/matlab/adaptiveThreshold.html cv.adaptiveThreshold] from [https://github.com/kyamagu/mexopencv mexopencv]||  
|-
|-
| demosaic || - || {{bug|50708}} || [http://kyamagu.github.io/mexopencv/matlab/demosaicing.html cv.demosaicing] from [https://github.com/kyamagu/mexopencv mexopencv] ||
| demosaic || - || {{bug|50708}} {{patch|9593}}|| [http://kyamagu.github.io/mexopencv/matlab/demosaicing.html cv.demosaicing] from [https://github.com/kyamagu/mexopencv mexopencv] ||
|-  
|-  
| gray2ind || function is in Octave core || || ||
| gray2ind || function is in Octave core || || ||
Line 370: Line 360:
| mat2gray || < 1.0.0 || || ||
| mat2gray || < 1.0.0 || || ||
|-
|-
| multithresh || - || || ||
| multithresh || - || {{patch|9602}} || ||
|-
|-
| otsuthresh || - ||  {{patch|9360}} || graythresh || otsuthresh(hist) is equivalent to graythresh (hist)
| otsuthresh || - ||  {{patch|9360}} || graythresh || otsuthresh(hist) is equivalent to graythresh (hist)
|-
|-
| rgb2gray || < 1.0.0 || || ||
| rgb2gray || function is in Octave core || {{bug|53654}} || || Octave version 4.4.0 and above
|-
|-
| rgb2ind  || function is in Octave core  || || ||
| rgb2ind  || function is in Octave core  || || ||
|-
|-
|}
|}
=== Color ===
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| colorangle || 2.10.0 (unreleased) || || ||
|-
| lab2double || 2.6.0 || || ||
|-
| lab2rgb || 2.6.0 || || ||
|-
| lab2uint16 ||  2.6.0  || || ||
|-
| lab2uint8 ||  2.6.0  || || ||
|-
| lab2xyz ||  2.6.0  || || ||
|-
| lin2rgb || - || {{patch|9600}} || ||
|-
| ntsc2rgb || 2.8.0 || || ||
|-
| rgb2lab ||  2.6.0  || || ||
|-
| rgb2lin || - || {{patch|9600}} || ||
|-
| rgb2ntsc || 2.8.0 || || ||
|-
| rgb2xyz ||  2.6.0  || || ||
|-
| rgb2ycbcr ||  < 1.0.0|| || ||
|-
| whitepoint || - || {{patch|8060}} || ||
|-
| xyz2double || - || {{patch|9603}} || ||
|-
| xyz2lab ||  2.6.0  || || ||
|-
| xyz2rgb ||  2.6.0  || || ||
|-
| xyz2uint16 || - || {{patch|9603}} || ||
|-
| ycbcr2rgb ||  2.2.0|| || ||
|-
|}
'''Missing:''' ''applycform, chromadapt, colorcloud, iccfind, iccread, iccroot, iccwrite, illumgray, illumpca, illumwhite, imapprox, isicc, makecform''
=== Synthetic Images ===
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| checkerboard ||  2.2.0 || || ||
|-
| imnoise ||  2.2.2  || || ||
|-
| phantom ||  2.6.2  || || ||
|-
|}
=== Basic Display ===
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| imshow || function is in Octave core || || ||
|-
| montage || - || || ||
|-
|}
'''Missing:''' ''imfuse, immovie, implay, imshowpair, iptgetpref, iptprefs, iptsetpref, warp''


=== Image Filtering ===  
=== Image Filtering ===  
Line 392: Line 458:
| convmtx2 || -  || || ||
| convmtx2 || -  || || ||
|-
|-
| entropyfilt ||  1.0.9  ||  {{patch|9235}} || ||
| entropyfilt ||  1.0.9  ||  || ||
|-
|-
| fibermetric ||-  || || ||
| fibermetric ||-  || || ||
Line 430: Line 496:
| integralBoxFilter3 ||- || || ||
| integralBoxFilter3 ||- || || ||
|-
|-
| integralImage ||- || || [http://kyamagu.github.io/mexopencv/matlab/integral.html cv.integral] from [https://github.com/kyamagu/mexopencv mexopencv] ||
| integralImage ||- || {{patch|9606}} || [http://kyamagu.github.io/mexopencv/matlab/integral.html cv.integral] from [https://github.com/kyamagu/mexopencv mexopencv] ||
|-
|-
| integralImage3 || -  || || ||
| integralImage3 || -  || || ||
|-
|-
| medfilt2 || < 1.0.0  || {{patch|9235}} || ||
| medfilt2 || < 1.0.0  || || ||
|-
|-
| medfilt3 || - || || ||
| medfilt3 || - || || ||
Line 442: Line 508:
| normxcorr2 || 2.0.0 ||  {{bug|50151}} || ||
| normxcorr2 || 2.0.0 ||  {{bug|50151}} || ||
|-
|-
| ordfilt2 || 1.0.9 ||  {{patch|9235}} || ||
| ordfilt2 || 1.0.9 ||  || ||
|-
|-
| padarray || < 1.0.0 || || ||
| padarray || < 1.0.0 || || ||
|-
|-
| rangefilt || 1.0.9 || {{bug|45088}} {{patch|9235}} || ||
| rangefilt || 1.0.9 || {{bug|45088}} || ||
|-
|-
| stdfilt ||  1.0.9 ||  {{patch|9235}} || ||
| stdfilt ||  1.0.9 ||  || ||
|-
|-
| wiener2 ||  dev || || ||
| wiener2 ||  2.8.0|| || ||
|-
|-
|}
|}
Line 460: Line 526:
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
|-
| imabsdiff ||    || || ||
| imabsdiff || 2.0.0  || || ||
|-
| imadd         || 2.0.0  || || ||
|-
| imapplymatrix ||    -    || {{patch|9717}} || ||
|-
| imcomplement || 1.0.6  || || ||
|-
| imdivide || 2.0.0  || || ||
|-
| imlincomb || 2.0.0  || || ||
|-
|  immultiply || 2.0.0  || || ||
|-
| imsubtract    || 2.0.0  || || ||
|-
|}
 
=== Morphological Operations ===
 
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| applylut  ||  < 1.0.0    || || ||
|-
| bwareaopen ||  2.2.0      || || ||
|-
|  bwhitmiss ||  < 1.0.0      || || ||
|-
|  bwlookup ||    --  || || ||
|-
|  bwmorph || < 1.0.0        ||  {{bug|51884}} || ||
|-
|  bwulterode ||  --    || || ||
|-
| conndef ||    < 1.0.0    || || ||
|-
|  imbothat ||  2.0.0    || || ||
|-
| imclearborder ||  2.4.0      || || ||
|-
| imclose ||  < 1.0.0      || || ||
|-
|  imdilate ||  < 1.0.0    || || ||
|-
|  imerode ||  < 1.0.0      || || ||
|-
| imextendedmax ||    2.8.0 ||  || ||
|-
|  imextendedmin ||    2.8.0 ||  || ||
|-
| imfill ||  2.6.0      || || ||
|-
| imhmax ||    2.8.0 || || ||
|-
|-
| imadd ||   || || ||
| imhmin ||     2.8.0 ||   || ||
|-
|-
| imapplymatrix ||   || || ||
imimposemin ||     2.8.0 || || ||
|-
|-
| imcomplement ||   || || ||
imopen || < 1.0.0      || || ||
|-
|-
| imdivide ||   || || ||
| imreconstruct || 2.4.0      || || ||
|-
|-
| imlincomb ||   || || ||
| imregionalmax || 2.4.0      || || ||
|-
|-
immultiply ||    || || ||
| imregionalmin ||   2.4.0    || || ||
|-
| imtophat ||  < 1.0.0    || || ||
|-
| iptcheckconn ||  2.0.0      || || ||
|-
| offsetstrel ||    --  || || ||
|-
| strel ||    2.2.0   || {{bug|50732}} || ||
|-
| watershed ||  2.6.0    || || ||
|-
|-
| imsubtract ||   || || ||
|}
 
=== Image Transforms ===
 
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| dct2 ||  || || ||
|-
| dctmtx ||  || || ||
|-
| fanbeam ||  || || ||
|-
| fan2para ||  || || ||
|-
| fftshift||  || || ||
|-
| fft2  ||  || || ||
|-
| hough ||  || || ||
|-
| houghlines ||  || || ||
|-
| houghpeaks ||  || || ||
|-
|idct2 ||  || || ||
|-
|ifftshift||  || || ||
|-
|ifft2||  || || ||
|-
|iradon||  || || ||
|-
|para2fan||  || || ||
|-
|radon||  || || ||
|-
|-
|}
|}


=== Graphical Interface Interaction ===
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| imellipse ||  -  || || ||
|-
| imfreehand ||  -  || || ||
|-
| imline ||  -  || || ||
|-
| immagbox ||  -  || || ||
|-
| imoverview ||  -  || || ||
|-
| imoverviewpanel ||  -  || || ||
|-
| impixelinfo ||  -  || {{patch|8722}} || ||
|-
| impixelinfoval ||  -  || {{patch|8722}} || ||
|-
| impixelregion ||  -  || || ||
|-
| impixelregionpanel ||  -  || || ||
|-
| implay ||  -  || || ||
|-
| impoint ||  -  || || ||
|-
| impoly ||  -  || || ||
|-
| imrect ||  -  || || ||
|-
| imscrollpanel ||  -  || || ||
|-
| iptgetpref ||  -  || || ||
|-
| iptprefs ||  -  || || ||
|-
| iptsetpref ||  -  || || ||
|-
|}
* Obs: implay, iptgetpref, iptprefs, iptsetpref functions are on Basic Display section too...


[[Category:Octave-Forge]]
[[Category:Octave Forge]]
[[Category:Missing functions]]

Navigation menu