Image package: Difference between revisions

From Octave
Jump to navigation Jump to search
m (→‎Missing functions: remove adapthisteq, imbinarize,)
m (→‎Image Filtering: imbilatfilt)
 
(3 intermediate revisions by the same user not shown)
Line 190: Line 190:
! bug !! bug title !! status
! bug !! bug title !! status
|-
|-
| {{bug|38087}}|| image package: graycomatrix incompatibilities with matlab  || None
| {{bug|43218}}|| [octave forge] (image) imshear causes more signal spread than expected and inconsistent vertical offset || None
|-
|-
| {{bug|43218}}|| image package: imshear causes more signal spread than expected and inconsistent vertical offset || None
| {{bug|44396}}|| [octave forge] (image) bwmorph shrink does not preserve Euler number || Confirmed
|-
|-
| {{bug|44396}}|| image package: bwmorph shrink does not preserve Euler number || Confirmed
| {{bug|44831}}|| [octave forge] (image) imrotate - different dimensions of output matrix || Confirmed
|-
|-
| {{bug|44831}}|| image package: imrotate - different dimensions of output matrix || Confirmed
| {{bug|45088}} || [octave forge] (image) rangefilt requires domain and image to have equal number of dimensions || In Progress
|-
|-
| {{bug|45088}}|| image package: rangefilt requires domain and image to have equal number of dimensions || In Progress
| {{bug|49452}} || [Octave forge] (image) missing MATLAB function corner and undistortImage || Confirmed
|-
|-
| {{bug|49452}}|| [Octave forge] (image) missing MATLAB function corner and undistortImage|| Confirmed
| {{bug|50151}} || [octave forge] (image) normxcorr2 is not compatible with Matlab || None
|-
|-
| {{bug|50151}}|| image package: normxcorr2 is not compatible with Matlab|| None
| {{bug|50188}} || [octave forge] (image) poly2mask does incompatible rounding || None
|-
|-
| {{bug|50188}}|| image package: poly2mask does incompatible rounding|| None
| {{bug|50257}} || [octave forge] (image) imtranslate is not Matlab compatible || Confirmed
|-
|-
| {{bug|50257}}|| image package: imtranslate is not Matlab compatible|| Confirmed
| {{bug|50341}} || [octave forge] (image) Missing Function imrect in image package || None
|-
|-
| {{bug|50341}}|| Missing Function imrect in image package|| None
| {{bug|50429}} || [octave forge] (image) xyz2lab changed slightly in Matlab (and other color conversion functions) || None  
|-
|-
| {{bug|50429}}|| image package: xyz2lab changed slightly in Matlab (and other color conversion functions)|| None  
| {{bug|50554}} || [octave forge] (image) cp2tform missing 'piecewise linear' and 'lwm' support || None  
|-
|-
| {{bug|50554}}|| [octave forge] (image) cp2tform missing 'piecewise linear' and 'lwm' support|| None  
| {{bug|50656}} || [octave forge] (image) bwerode does not return right size when there's more dimensions on conn || None
|-
|-
| {{bug|50656}}|| image package: bwerode does not return right size when there's more dimensions on conn || None
| {{bug|50708}} || [octave forge] (image) add demosaic.m || Patch Submitted
|-
|-
| {{bug|50708}}|| image package: add demosaic.m || Patch Submitted
| {{bug|50732}} || [octave forge] (image) 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|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 238: Line 236:
| {{bug|55059}} || [octave forge] (image) Failing unit test for grayslice || In Progress
| {{bug|55059}} || [octave forge] (image) Failing unit test for grayslice || In Progress
|-
|-
| {{bug|55438}} || [octave forge] (image) Binary input image for edge || None
| {{bug|55438}} || [octave forge] (image) Binary input image for edge || None
|-  
|-  
| {{bug|55521}} || [octave forge] (image) Unit tests for bwpack and bwunpack fail on big endian architectures|| None
| {{bug|55521}} || [octave forge] (image) Unit tests for bwpack and bwunpack fail on big endian architectures|| None
|-
|-
| {{bug|56958}} || [Octave-Forge] (image) Implementation of insertText  || Confirmed
| {{bug|58684}} || [octave forge] (image) imtranslate produces nonsense for fractional shifts || Confirmed
|-
|-
| {{bug|57822}} || [octave forge] (image) test failures on macOS - imadjust, immse, mean2 || In progress
| {{bug|62452}} || [octave forge] (image) bwmorph spur produces wrong result || In Progress
|-
|-
| {{bug|58684}} || [octave forge] (image) imtranslate produces nonsense for fractional shifts || Confirmed
| {{bug|62978}} || [octave forge] (image) applylut & makelut are not MATLAB compatible || None
|-
|-
| {{bug|59773}} || [octave forge] (image) iradon is not Matlab compatible when using filter || None
| {{bug|66654}} || [octave forge] (image) strel('disk', 1) || None
|-
|-
| {{bug|62099}} || [octave forge] (image) imresize - lanczos* is not implemented || None
| {{bug|67374}} || (image) retire __eps__? || None
|-
| {{bug|62452}} || [octave forge] (image) bwmorph spur produces wrong result || None
|-
|-
|}
|}
Line 309: Line 305:
! Function !! Octave Package Version !! Related Bugs and Patches !! Alternatives || Notes
! 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]||  
| adaptthresh || 2.18.0 || ||  [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] ||
| demosaic || - || {{bug|50708}} {{patch|9593}}|| [http://kyamagu.github.io/mexopencv/matlab/demosaicing.html cv.demosaicing] from [https://github.com/kyamagu/mexopencv mexopencv] ||
Line 331: Line 327:
| im2uint8  || 1.0.0 || || ||
| im2uint8  || 1.0.0 || || ||
|-
|-
| imbinarize || - || || imbinarize (I) is equivalent to im2bw(I, graythresh(I)),  
| imbinarize || 2.18.0 || || 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]  
another option is [http://kyamagu.github.io/mexopencv/matlab/threshold.html cv.threshold]  from [https://github.com/kyamagu/mexopencv mexopencv]  
||
||
Line 502: Line 498:
| gabor || - || || ||
| gabor || - || || ||
|-  
|-  
| imbilatfilt || 2.18.0 || ||
|-
| imboxfilt || 2.16.0 || || ||
| imboxfilt || 2.16.0 || || ||
|-
|-

Latest revision as of 08:30, 5 September 2025

The image package is part of the Octave Forge project. See its homepage for the latest release.

Development

Follows an incomplete list of stuff missing in the image package to be matlab compatible. Bugs are not listed here, search and report them on the bug tracker instead.

Missing functions

Info icon.svg
this entire section is about the current development version. If a Matlab function is missing from the list and does not appear on the current release of the package, confirm that is also missing in the development sources before adding it.
  • activecontour
  • applycform
  • bwconvhull
  • bwdistgeodesic
  • bwlookup
  • bwtraceboundary
  • bwulterode
  • chromadapt
  • colorcloud
  • convmtx2
  • corner
  • cornermetric
  • cpcorr
  • cpselect
  • cpstruct2pairs
  • dct2
  • dctmtx
  • deconvblind
  • deconvlucy
  • deconvreg
  • decorrstretch
  • demosaic
  • dicomanon
  • dicomdisp
  • dicomuid
  • dpxinfo
  • dpxread
  • fan2para
  • fanbeam
  • fliptform
  • freqz2
  • fsamp2
  • ftrans2
  • fwind1
  • fwind2
  • gabor
  • getimage
  • getimagemodel
  • getline
  • getpts
  • getrect
  • gradientweight
  • grayconnected
  • graycoprops
  • graydiffweight
  • hdrread
  • hdrwrite
  • iccfind
  • iccread
  • iccroot
  • iccwrite
  • idct2
  • ifanbeam
  • illumgray
  • illumpca
  • illumwhite
  • im2java2d
  • ImageAdapter
  • imageinfo
  • imapprox
  • imboxfilt3
  • imcolormaptool
  • imcontour
  • imcontrast
  • imdisplayrange
  • imdistline
  • imellipse
  • imfreehand
  • imgaborfilt
  • imgaussfilt3
  • imgca
  • imgcf
  • imguidedfilter
  • imhandles
  • imhistmatch
  • imline
  • immagbox
  • immovie
  • imoverview
  • imoverviewpanel
  • impixelinfo
  • impixelinfoval
  • impixelregion
  • impixelregionpanel
  • implay
  • impoint
  • impoly
  • improfile
  • imrect
  • imreducehaze
  • imregconfig
  • imregcorr
  • imregdemons
  • imregister
  • imregtform
  • imroi
  • imscrollpanel
  • imsegfmm
  • imseggeodesic
  • imtool
  • imwarp
  • integralBoxFilter
  • integralBoxFilter3
  • interfileinfo
  • interfileread
  • iptaddcallback
  • iptcheckhandle
  • iptgetapi
  • iptGetPointerBehavior
  • iptgetpref
  • ipticondir
  • iptPointerManager
  • iptprefs
  • iptremovecallback
  • iptSetPointerBehavior
  • iptsetpref
  • iptwindowalign
  • isicc
  • isrset
  • lin2rgb
  • makecform
  • makeConstrainToRectFcn
  • makehdr
  • makeresampler
  • multithresh
  • nitfinfo
  • nitfread
  • openrset
  • para2fan
  • projective2d
  • regionfill
  • rgb2lin
  • roifill
  • roifilt2
  • roipoly
  • rsetwrite
  • ssim
  • tformarray
  • tonemap
  • truesize
  • visboundaries
  • warp
  • whitepoint
  • xyz2double
  • xyz2uint16

Different functions

  • with version 2014a, Matlab introduced a new function imtranslate. This function was part of Octave's package since 2002 but Matlab version is completely different. It needs to be rewritten for Matlab compatibility.

Missing options

  • @strel
    • missing SE decomposition for the diamond shape
    • approximation argument for the ball and disk shapes are not implemented
    • the translate method is not yet implemented
  • blockproc
    • The name-value input arguments have not yet been implemented.
  • colfilt
    • the option to split the image in smaller blocks before performing the im2col and filtering is ignored. Since that option only allows to use less memory and has no effect on the output is only important for sliding filtering with big blocks size.
  • impixel
    • interactive selection of points (less than 2 input arguments) is not yet implemented. Ability to create such UIs needs to be implemented in Octave core first.
  • imcrop
    • messing around with alternative coordinate systems (XData and YData) are not yet implemented.
  • imwrap
    • no supports for SmoothEdges option
  • hough
    • no RhoResolution option

Contributing

  • It'd help to group the missing functions above, as per [1] (similar to what was done in the signal package wiki page); please keep the original alphabetical list intact.

Open Bugs

bug bug title status
#43218 [octave forge] (image) imshear causes more signal spread than expected and inconsistent vertical offset None
#44396 [octave forge] (image) bwmorph shrink does not preserve Euler number Confirmed
#44831 [octave forge] (image) imrotate - different dimensions of output matrix Confirmed
#45088 [octave forge] (image) rangefilt requires domain and image to have equal number of dimensions In Progress
#49452 [Octave forge] (image) missing MATLAB function corner and undistortImage Confirmed
#50151 [octave forge] (image) normxcorr2 is not compatible with Matlab None
#50188 [octave forge] (image) poly2mask does incompatible rounding None
#50257 [octave forge] (image) imtranslate is not Matlab compatible Confirmed
#50341 [octave forge] (image) Missing Function imrect in image package None
#50429 [octave forge] (image) xyz2lab changed slightly in Matlab (and other color conversion functions) None
#50554 [octave forge] (image) cp2tform missing 'piecewise linear' and 'lwm' support None
#50656 [octave forge] (image) bwerode does not return right size when there's more dimensions on conn None
#50708 [octave forge] (image) add demosaic.m Patch Submitted
#50732 [octave forge] (image) infinite error loop when assigning a strel (class) object to a vector Confirmed
#51420 [octave forge] (image) imrotate is less tolerant to missing argument than Matlab None
#51719 [octave forge] (image) watershed unit test failure None
#51884 [octave forge] (image) bwmorph(blackNwhiteMatrix, "thicken", 1) returns negated result (+ strange behavior at border) None
#51979 [octave forge] (image) Failing unit test for impyramid None
#51980 [octave forge] (image) Failing unit test for edge None
#52006 [octave forge] (image) 'makecform' feature request Confirmed
#52715 [octave forge] (image) Add full data range option to ycbcrfunc conversions None
#52959 [octave forge] (image) histeq is not compatible with Matlab None
#55059 [octave forge] (image) Failing unit test for grayslice In Progress
#55438 [octave forge] (image) Binary input image for edge None
#55521 [octave forge] (image) Unit tests for bwpack and bwunpack fail on big endian architectures None
#58684 [octave forge] (image) imtranslate produces nonsense for fractional shifts Confirmed
#62452 [octave forge] (image) bwmorph spur produces wrong result In Progress
#62978 [octave forge] (image) applylut & makelut are not MATLAB compatible None
#66654 [octave forge] (image) strel('disk', 1) None
#67374 (image) retire __eps__? None

Patches

  • #8059: [new function for image package] ranktf.m
  • #8060: [image package new function] whitepoint.m
  • #8722: implement impixelinfo and impixelinfoval
  • #8813: image package: Extended image I/O for Analyze 7.5 format to handle big-endian images
  • #8571: image package: three deconvolution routines (Wiener, RL, RLTV)
  • #9509: Image package: simple implementation of roipoly function
  • #9593: [Octave Forge] (Image) New function demosaic.m from bug #50708
  • #9600: [Octave Forge] (Image) New functions: lin2rgb.m and lrgb2lin.m
  • #9602: [octave forge] (image) multithresh
  • #9603: [Octave Forge] (Image) New functions: xyz2double.m, xyz2single.m, xyz2uint16.m
  • #9729: [octave forge] (image) -- rgb2xyz conversion with adapted whitepoint
  • #9853: [octave forge] (image) implement niftiread, niftiwrite, niftiinfo
  • #9957: Nonlinear filter for image package (colfilt2)

Image Processing Functions

Info icon.svg
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 patches, and some alternatives.

Note:

Basic Read and Write Image Files

Function Octave Package Version Related Bugs and Patches Alternatives Notes
imfinfo function is in Octave core
imread function is in Octave core cv.imread from mexopencv

in case of color image, the color order of Octave is RGB/RGBA while OpenCV color order is BGR/BGRA

imwrite function is in Octave core cv.imwrite from 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

Function Octave Package Version Related Bugs and Patches Alternatives Notes
adaptthresh 2.18.0 cv.adaptiveThreshold from mexopencv
demosaic - #50708 #9593 cv.demosaicing from mexopencv
gray2ind function is in Octave core
grayslice < 1.0.0
graythresh 1.0.0 Octave version has more methods
im2double 1.0.0
im2int16 2.0.0
im2java2d -
im2single 2.0.0
im2uint16 1.0.0
im2uint8 1.0.0
imbinarize 2.18.0 imbinarize (I) is equivalent to im2bw(I, graythresh(I)),

another option is cv.threshold from 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 - #9602
otsuthresh 2.10.0
rgb2gray function is in Octave core #53654 Octave version 4.4.0 and above
rgb2ind function is in Octave core

Color

Function Octave Package Version Related Bugs and Patches Alternatives Notes
colorangle 2.10.0
lab2double 2.6.0
lab2rgb 2.6.0
lab2uint16 2.6.0
lab2uint8 2.6.0
lab2xyz 2.6.0
lin2rgb - #9600
ntsc2rgb 2.8.0
rgb2lab 2.6.0
rgb2lin - #9600
rgb2ntsc 2.8.0
rgb2xyz 2.6.0
rgb2ycbcr < 1.0.0
whitepoint - #8060
xyz2double - #9603
xyz2lab 2.6.0
xyz2rgb 2.6.0
xyz2uint16 - #9603
ycbcr2rgb 2.2.0

Missing: applycform, chromadapt, colorcloud, iccfind, iccread, iccroot, iccwrite, illumgray, illumpca, illumwhite, imapprox, isicc, makecform

Synthetic Images

Function Octave Package Version Related Bugs and Patches Alternatives Notes
checkerboard 2.2.0
imnoise 2.2.2
phantom 2.6.2

Basic Display

Function Octave Package Version Related Bugs and Patches Alternatives Notes
imshow function is in Octave core
montage 2.2.0
imfuse 2.14.0
imshowpair 2.14.0

Missing: immovie, implay, iptgetpref, iptprefs, iptsetpref, warp

Geometric Transformations

Function Octave Package Version Related Bugs and Patches Alternatives Notes
affine2d 2.14.0
affine3d 2.14.0
cp2tform 2.2.0
imcrop 2.0.0
impyramid 2.6.0
imref2d 2.12.0
imref3d 2.12.0
imrotate <1.0.0
imtranslate <1.0.0 incompatible to Matlab's imtranslate
maketform 2.2.0
tformfwd 2.2.0
tforminv 2.2.0

Missing: imwarp

Image Filtering

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 -
imbilatfilt 2.18.0
imboxfilt 2.16.0
imboxfilt3 -
imfilter 1.0.5
imgaborfilt -
imgaussfilt 2.16.0
imgaussfilt3 -
imguidedfilter -
imsmooth 1.0.5 Octave only
integralBoxFilter -
integralBoxFilter3 -
integralImage 2.12.0
integralImage3 2.12.0
medfilt2 < 1.0.0
medfilt3 -
nlfilter < 1.0.0
normxcorr2 2.0.0 #50151
ordfilt2 1.0.9
padarray < 1.0.0
rangefilt 1.0.9 #45088
stdfilt 1.0.9
wiener2 2.8.0

Image Arithmetic

Function Octave Package Version Related Bugs and Patches Alternatives Notes
imabsdiff 2.0.0
imadd 2.0.0
imapplymatrix 2.14.0
imcomplement 1.0.6
imdivide 2.0.0
imlincomb 2.0.0
immultiply 2.0.0
imsubtract 2.0.0

Morphological Operations

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 #51884
bwpack 2.10.0
bwunpack 2.10.0
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 #50732
watershed 2.6.0

Image Transforms

Function Octave Package Version Related Bugs and Patches Alternatives Notes
dct2 -
dctmtx -
fanbeam -
fan2para -
fftshift part of core Octave
fft2 part of core Octave
hough 2.8.0
houghlines 2.10.0
houghpeaks 2.10.0
idct2 -
ifftshift part of core Octave
ifft2 part of core Octave
iradon <1.0.0
para2fan -
radon <1.0.0

Graphical Interface Interaction

Function Octave Package Version Related Bugs and Patches Alternatives Notes
imellipse -
imfreehand -
imline -
immagbox -
imoverview -
imoverviewpanel -
impixelinfo - #8722
impixelinfoval - #8722
impixelregion -
impixelregionpanel -
implay -
impoint -
impoly -
imrect -
imscrollpanel -
iptgetpref -
iptprefs -
iptsetpref -
  • Obs: implay, iptgetpref, iptprefs, iptsetpref functions are on Basic Display section too...
Retrieved from "https://wiki.octave.org/wiki/index.php?title=Image_package&oldid=15478"