Image package

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

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
• adapthisteq
• affine2d
• affine3d
• applycform
• bwconvhull
• bwdistgeodesic
• bwlookup
• bwtraceboundary
• bwulterode
• chromadapt
• colorcloud
• convmtx2
• corner
• cornermetric
• cpcorr
• cpselect
• cpstruct2pairs
• dct2
• dctmtx
• imbinarize
• deconvblind
• deconvlucy
• deconvreg
• deconvwnr
• 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
• imapplymatrix
• imapprox
• imbinarize
• imboxfilt
• imboxfilt3
• imcolormaptool
• imcontour
• imcontrast
• imdisplayrange
• imdistline
• imellipse
• imfreehand
• imfuse
• imgaborfilt
• imgaussfilt
• imgaussfilt3
• imgca
• imgcf
• imguidedfilter
• imhandles
• imhistmatch
• imline
• immagbox
• immovie
• imoverview
• imoverviewpanel
• impixelinfo
• impixelinfoval
• impixelregion
• impixelregionpanel
• implay
• impoint
• impoly
• improfile
• imrect
• imref2d
• imref3d
• imregconfig
• imregcorr
• imregdemons
• imregister
• imregtform
• imroi
• imscrollpanel
• imsegfmm
• imseggeodesic
• imshowpair
• imtool
• imwarp
• integralBoxFilter
• integralBoxFilter3
• integralImage
• integralImage3
• 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
#38087	image package: graycomatrix incompatibilities with matlab	None
#41674	image package: temporary arrays in imresize are doubles	None
#43218	image package: imshear causes more signal spread than expected and inconsistent vertical offset	None
#44396	image package: bwmorph shrink does not preserve Euler number	Confirmed
#44799	image package: imrotate chrashes when using 'spline' as interpolation method	Confirmed
#44831	image package: imrotate - different dimensions of output matrix	Confirmed
#45088	image package: rangefilt requires domain and image to have equal number of dimensions	In Progress
#46745	image package: imresize default method (bicubic) Matlab incompatible for the border pixels	None
#48529	image package: compilation warnings under Mac OSX	None
#50151	image package: normxcorr2 is not compatible with Matlab	None
#50188	image package: poly2mask does incompatible rounding	None
#50257	image package: imtranslate is not Matlab compatible	Confirmed
#50341	Missing Function imrect in image package	None
#50429	image package: xyz2lab changed slightly in Matlab (and other color conversion functions)	None
#50656	image package: bwerode does not return right size when there's more dimensions on conn	None
#50708	image package: add demosaic.m	Patch Submitted
#50732	Image package: 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
#51769	[octave forge] (image) imresize bilinear interpolation inaccurate	Patch Submitted
#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
#52119	[octave forge] (image) Add 'reflect' padding option to imfilter	None
#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
#55202	[octave forge] (image) imresize fails for method nearest and image of 1 row	Confirmed

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
• #8866: image package: add metainfo.xml file for Gnome Software
• #8571: image package: three deconvolution routines (Wiener, RL, RLTV)
• #8824: added affine2d class
• #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
• #9717: [octave forge] (image) new function imapplymatrix
• #9729: [octave forge] (image) -- rgb2xyz conversion with adapted whitepoint
• #9730: [octave forge] (image) new function imfuse

Image Processing Functions

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

Type Conversion

Function	Octave Package Version	Related Bugs and Patches	Alternatives	Notes
adaptthresh	-		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	-		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	-	#9360	graythresh	otsuthresh(hist) is equivalent to graythresh (hist)
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 (unreleased)
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	-

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

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	-
imboxfilt	-
imboxfilt3	-
imfilter	1.0.5
imgaborfilt	-
imgaussfilt	-
imgaussfilt3	-
imguidedfilter	-
imsmooth	1.0.5			Octave only
integralBoxFilter	-
integralBoxFilter3	-
integralImage	-	#9606	cv.integral from mexopencv
integralImage3	-
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	-	#9717
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
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
fft2
hough
houghlines
houghpeaks
idct2
ifftshift
ifft2
iradon
para2fan
radon

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...