Changes

Jump to navigation Jump to search

Image package

7,928 bytes added, 10 June
m
Remove redundant Category:Packages.
The {{Forge|image|image package}} is part of the octave-forge Octave Forge project. See its {{Forge|image|homepage}} for the latest release. <div class="tocinline">__TOC__</div>
== 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.
 
=== 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 ===
* activecontour
* adapthisteq
* [https://savannah.gnu.org/patch/?8824 affine2d]
* affine3d
* applycform
* axes2pix
* bwconvhull
* bwdistgeodesic
* bwlookup
* bwpack
* bwtraceboundary
* bwulterode
* bwunpackchromadapt* colorcloud
* convmtx2
* corner
* dct2
* dctmtx
* imbinarize
* deconvblind
* deconvlucy
* deconvreg
* [https://savannah.gnu.org/patch/?9365 deconvwnr]
* decorrstretch
* [https://savannah.gnu.org/patch/?9593 demosaic]
* dicomanon
* dicomdisp
* dicomuid
* dpxinfo
* dpxread
* dpxinfo
* fan2para
* fanbeam
* getrect
* gradientweight
* grayconnected
* graycoprops
* grayconnected
* graydiffweight
* hdrread
* hdrwrite
* houghlines -- (see hough_line)
* houghpeaks
* iccfind
* iccread
* idct2
* ifanbeam
* illumgray
* illumpca
* illumwhite
* im2java2d
* ImageAdapter
* imageinfo
* [https://savannah.gnu.org/patch/?9717 imapplymatrix]
* imapprox
* imbinarize
* imdistline
* imellipse
* imextendedmax
* imextendedmin
* imfindcircles
* imfreehand
* imfuse
* imhandles
* imhistmatch
* imhmax
* imhmin
* imimposemin
* imline
* immagbox
* imoverview
* imoverviewpanel
* [https://savannah.gnu.org/patch/?8722 impixelinfo]* [https://savannah.gnu.org/patch/?8722 impixelinfoval]* impixelregion
* impixelregionpanel
* impixelregion
* implay
* impoint
* integralBoxFilter
* integralBoxFilter3
* [https://savannah.gnu.org/patch/?9606 integralImage]
* integralImage3
* interfileinfo
* isicc
* isrset
* [https://savannah.gnu.org/patch/?9600 lin2rgb]
* makecform
* makeConstrainToRectFcn
* makehdr
* makeresampler
* [https://savannah.gnu.org/patch/?9602 multithresh]
* nitfinfo
* nitfread
* projective2d
* regionfill
* rgb2lin
* roifill
* roifilt2
* [https://savannah.gnu.org/patch/?9509 roipoly]
* rsetwrite
* ssim
* truesize
* visboundaries
* viscircles
* warp
* [https://savannah.gnu.org/patch/?8060 whitepoint]* wiener2* [https://savannah.gnu.org/patch/?9603 xyz2double]* [https://savannah.gnu.org/patch/?9603 xyz2uint16]
</div>
|-
! 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|38345}}|| image package: __spatial_filtering__() always returns class double || Confirmed
|-
| {{bug|41674}}|| image package: temporary arrays in imresize are doubles || None
| {{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 ReviewedIn Progress
|-
| {{bug|46745}}|| image package: imresize default method (bicubic) Matlab incompatible for the border pixels|| 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|50732}} || Image package: infinite error loop when assigning a strel (class) object to a vector|| Confirmed
|-
| {{bug|5078351420}} || [octave forge] (image package: imlincomb ) imrotate is less tolerant to missing argument than Matlab || None|-| {{bug|51719}} || [octave forge] (image) watershed unit test failure || None|-| {{bug|51769}} || [octave forge] (image) imresize bilinear interpolation inaccurate || Patch Submitted|-| {{bug|51884}} || [octave forge] (image) bwmorph(blackNwhiteMatrix, "thicken", 1) returns negated result (+ strange behavior at border) || None|-| {{bug|51979}} || [octave forge] (image) Failing unit test for impyramid || None|-| {{bug|51980}} || [octave forge] (image) Failing unit test for edge|| 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 || noneNone|-| {{bug|55059}} || [octave forge] (image) Failing unit test for grayslice || In Progress|-| {{bug|55202}} || [octave forge] (image) imresize fails for method nearest and image of 1 row || Confirmed
|-
| {{bug|50874}} || bwdist call causes application crash || Confirmed
|}
* {{patch|8571}}: image package: three deconvolution routines (Wiener, RL, RLTV)
* {{patch|8824}}: added affine2d class
* {{patch|92359509}}: image Image package: improve filtering simple implementation of roipoly function* {{patch|9593}}: [Octave Forge] (Image) New function demosaic.m from bug #50708* {{patch|9600}}: [Octave Forge] (Image) New functions : lin2rgb.m and lrgb2lin.m* {{patch|9602}}: [octave forge] (stdfilt, entropyfiltimage) and add tests multithresh* {{patch|9603}}: [Octave Forge] (also medfilt2Image) New functions: xyz2double.m, ordfilt2xyz2single.m, rangefiltxyz2uint16.m* {{patch|9606}}: [Octave forge] (image) New function integralImage* {{patch|9717}}: [octave forge] (image)new function imapplymatrix* {{patch|92449722}}: [octave forge] (image package) new objects imref2d and imref3d* {{patch|9729}}: regionprops.m [octave forge] (image) -- rgb2xyz conversion with adapted whitepoint* {{patch|9730}}: [octave forge] (image) new properties ConvexHull, ConvexImage, ConvexArea, Solidityfunction imfuse == Image Processing Functions ==
== Image Processing Functions (this {{Note| This section is still under construction) ==so the list is incomplete.}}
This is a list of Image Processing functions by topic, including : missing functions, related bugs and patchedpatches, and some alternatives.
Note: This section is under construction so this list is still incomplete
=== Basic Read and Write Image Files ===
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives !! Notes
|-
| imfinfo || 2.6.1 function is in Octave core || || ||
|-
| imread|| 2.6.1 function is in Octave core || || [http://kyamagu.github.io/mexopencv/matlab/imread.html cv.imread] from [https://github.com/kyamagu/mexopencv mexopencv] ||
in case of color image, the color order of Octave is RGB/RGBA while OpenCV color order is BGR/BGRA
|-
| imwrite|| 2.6.1 function is in Octave core || || [http://kyamagu.github.io/mexopencv/matlab/imread.html cv.imwrite] from [https://github.com/kyamagu/mexopencv mexopencv] ||
in case of color image, the color order of Octave is RGB/RGBA while OpenCV color order is BGR/BGRA
|-
|}
 
'''Missing:''' ''dicomanon, dicomdisp, dicomuid, dpxinfo, dpxread, interfileinfo, interfileread, nitfinfo, nitfread
''
 
=== High Dynamic Range Images - ''Not implemented'' ===
 
=== Large Image Files - ''Not implemented'' ===
=== Type Conversion ===
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| adaptthresh || - || || [http://kyamagu.github.io/mexopencv/matlab/adaptiveThreshold.html cv.adaptiveThreshold] 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 || 2.6.1 function is in Octave core || || ||
|-
| grayslice || 2< 1.60.1 0 || || ||
|-
| graythresh || 21.60.1 0 || || || Octave version has more methods
|-
| im2double || 21.60.1 0 || || ||
|-
| im2int16 || 2.60.1 0 || || ||
|-
| im2java2d || - || || ||
|-
| im2single || 2.0.0 || || || |-| im2uint16 || 1.0.0 || || || |-| im2uint8 || 1.0.0 || || || |-| imbinarize || - || || imbinarize (I) is equivalent to im2bw(I, graythresh(I)), another option is [http://kyamagu.github.io/mexopencv/matlab/threshold.html cv.threshold] from [https://github.com/kyamagu/mexopencv mexopencv] |||-| imcast || 2.4.0 || || || Octave Only|-| imquantize || 2.6.0 || || |||-| ind2gray || function is in Octave core || || |||-| ind2rgb || function is in Octave core || || |||-| label2rgb || 1.0.0 || || |||-| mat2gray || < 1 .0.0 || || |||-| multithresh || - || {{patch|9602}} || |||-| otsuthresh || - || {{patch|9360}} || graythresh || otsuthresh(hist) is equivalent to graythresh (hist)|-| rgb2gray || function is in Octave core || {{bug|53654}} || || Octave version 4.4.0 and above|-| 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 || || ||
|-
| im2uint16 rgb2ycbcr || 2 < 1.60.1 0|| || ||
|-
| im2uint8 whitepoint || 2.6.1 - || {{patch|8060}} || ||
|-
| imbinarize xyz2double || - || {{patch|9603}} || imbinarize (I) is equivalent to im2bw(I, graythresh(I)) ||
|-
| imcast xyz2lab || 2.6.1 0 || || || Octave Only
|-
| imquantize xyz2rgb || 2.6.1 0 || || ||
|-
| ind2gray xyz2uint16 || 2.6.1 - || {{patch|9603}} || ||
|-
| ind2rgb ycbcr2rgb || 2.62.1 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 | label2rgb |Notes| - | checkerboard || 2.62.1 0 || || ||
|-
| mat2gray imnoise || 2.62.1 2 || || ||
|-
| multithresh phantom || - 2.6.2 || || ||
|-
| otsuthresh |} === Basic Display === {| class="wikitable" style="text- || || graythresh || otsuthresh(hist) is equivalent to graythresh (hist)align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives | rgb2gray |Notes| 2.6.1 - | imshow || function is in Octave core || || ||
|-
| rgb2ind montage || 2.6.1 - || || ||
|-
|}
'''Missing:''' ''imfuse, immovie, implay, imshowpair, iptgetpref, iptprefs, iptsetpref, warp''
 
=== Image Filtering ===
 
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| bwareafilt|| 2.4.0 || || ||
|-
| bwpropfilt || 2.4.0 || || ||
|-
| convmtx2 || - || || ||
|-
| entropyfilt || 1.0.9 || || ||
|-
| fibermetric ||- || || ||
|-
| freqz2 || -|| || ||
|-
| fsamp2 || - || || ||
|-
| fspecial || 1.0.0 || || ||
|-
| ftrans2 || - || || ||
|-
| fwind1 || - || || ||
|-
| fwind2 || - || || ||
|-
| gabor || - || || ||
|-
| imboxfilt || - || || ||
|-
| imboxfilt3 || - || || ||
|-
| imfilter || 1.0.5 || || ||
|-
| imgaborfilt || - || || ||
|-
| imgaussfilt || - || || ||
|-
| imgaussfilt3 || - || || ||
|-
| imguidedfilter || - || || ||
|-
| imsmooth|| 1.0.5 || || || Octave only
|-
| integralBoxFilter || - || || ||
|-
| integralBoxFilter3 ||- || || ||
|-
| integralImage ||- || {{patch|9606}} || [http://kyamagu.github.io/mexopencv/matlab/integral.html cv.integral] from [https://github.com/kyamagu/mexopencv mexopencv] ||
|-
| integralImage3 || - || || ||
|-
| medfilt2 || < 1.0.0 || || ||
|-
| medfilt3 || - || || ||
|-
| nlfilter || < 1.0.0 || || ||
|-
| normxcorr2 || 2.0.0 || {{bug|50151}} || ||
|-
| ordfilt2 || 1.0.9 || || ||
|-
| padarray || < 1.0.0 || || ||
|-
| rangefilt || 1.0.9 || {{bug|45088}} || ||
|-
| stdfilt || 1.0.9 || || ||
|-
| wiener2 || 2.8.0|| || ||
|-
|}
 
=== Image Arithmetic ===
 
{| class="wikitable" style="text-align: center"
|-
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
|-
| 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 || || ||
|-
| imhmin || 2.8.0 || || ||
|-
| imimposemin || 2.8.0 || || ||
|-
| imopen || < 1.0.0 || || ||
|-
| imreconstruct || 2.4.0 || || ||
|-
| imregionalmax || 2.4.0 || || ||
|-
| imregionalmin || 2.4.0 || || ||
|-
| imtophat || < 1.0.0 || || ||
|-
| iptcheckconn || 2.0.0 || || ||
|-
| offsetstrel || -- || || ||
|-
| strel || 2.2.0 || {{bug|50732}} || ||
|-
| watershed || 2.6.0 || || ||
|-
|}
 
=== 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:Missing functions]]

Navigation menu