View License

Download apps, toolboxes, and other File Exchange content using Add-On Explorer in MATLAB.

» Watch video

Highlights from
Freeman Chain Code

4.5 | 11 ratings Rate this file 74 Downloads (last 30 days) File Size: 2.35 KB File ID: #29518 Version: 1.0
image thumbnail

Freeman Chain Code



Gives Freeman chain code 8-connected representation of a boundary

| Watch this File

File Information

    [cc] = chaincode(b,u)

    b - boundary as np-by-2 array
    unwrap - (optional, default=false) unwrap code

    cc is a structure with the following fields:
    cc.code - 8-connected Freeman chain code 1-by-np
    cc.x0,cc.y0 - coordinates of start point
    cc.ucode - unwrapped 8-connected Freeman chain code

MATLAB release MATLAB 7.8 (R2009a)
Tags for This File   Please login to tag files.
Please login to add a comment or rating.
Comments and Ratings (32)
25 Aug 2016 Girish Mallya

25 Aug 2015 Jesse Lame

03 May 2015 Shivadatt Chame

Respected sir,
when i run this code:
s=strel('disk',4,0);%Structuring element
D=~im2bw(C);%binary Image
F=imerode(D,s);%Erode the image by structuring element
figure,imshow(C);title('Original Image');
figure,imshow(D);title('Binary Image');

title('Boundary extracted Image');

i am getting same chain code for different A-Z characters please help me....urgent requirement...

30 Apr 2015 Shivadatt Chame

Respected sir,
this chain code i run and getting same code for different characters also...please suggest me...

Comment only
28 Apr 2015 Shivadatt Chame

Dear sir
i am using chain code for different characters A-Z but i want every characters chain code would be same size.
i am not getting the chain code of same size please suggest me.

Comment only
15 Apr 2015 Christin Panjaitan

Dear Alessandro,

I have read your code about chaincode.
I have question about the equation below :
idx=3*(dy+1)+(dx+1)=3dy+dx+4 (adding 1 to have idx starting % from 1)

You made the equation for 8-connected.
Why did you multiply dy with 3 ?
How about 4-Connected ?
How do I form the equation ?

Comment only
31 Mar 2015 Shivadatt Chame

Respected sir,
i want to apply chain code on Character image R but using this function how to apply on image.....suggest me...

Comment only
11 Mar 2015 Munika Patel

work awsomee...

07 Mar 2015 Divya Kakadiya

how to get value of b passed as parameter? Thanking in advanced

Comment only
09 Feb 2015 Xia Lin

11 Dec 2014 farinaz

25 May 2014 cspit

cspit (view profile)

Maximum recursion limit of 500 reached. Use set(0,'RecursionLimit',N)
to change the limit. Be aware that exceeding your available stack space can
crash MATLAB and/or your computer.

Error in ==> imformats>find_in_registry

what should i do now??

Comment only
28 Apr 2014 Monalisa Das

Hi, I keep getting the error "the xpression to the left of the equals sign is not a valid target" when I try to use the [cc]= chaincode(b,u)...what am I doing wrong?

Comment only
23 Apr 2014 Alessandro Mannini

Hi Monalisa, see the description and previous comments. Main steps are:
1) get the contour of the image
2) put coords of contour points in b
3) call chaincode(b,true/false)

Note: the contour must be 8-connected tha is, given a point on the boundary it must have only two neighbors, the previous and the next. There can be NO forks.

Comment only
23 Apr 2014 sujith

sujith (view profile)

if u don't want to unwrap,just change function name to [cc] = chaincode(b)
and remove the unwrapping section from program.trace the boundary of your image using 'bwtraceboundary' function and input it to chain code function.

Comment only
21 Apr 2014 Monalisa Das

Hi, could you tell me how to use this function to get chaincode for an image? Thanks!

Comment only
21 Feb 2014 Max

Max (view profile)

Since a few people have asked how to get a chain code from an image I have written a simple script to do this.

You can download the script here:

The script is really simple and makes some assumptions about a single contour in the image but should be easy to modify if needed.


>> chain = mk_chain('path/to/image.png');
>> [cc] = chaincode(chain);

07 Oct 2013 missC

missC (view profile)

can anyone give me an example on how to call or use this function. I am totally new on matlab and need to see how this chaincode works? many thanks and really appreciate it

Comment only
12 Jun 2013 Anton

Anton (view profile)

Worked fine for me, thank you very much for the comments, they were VERY helpful!

30 Aug 2012 Daurat Sinaga

i was running this function and i get output like this :
CC =
code:[209x1 double], would you explain it for me ?

Comment only
18 May 2012 rana

rana (view profile)

would you tell me please the exact steps to run this code ??
than you :)

Comment only
09 May 2012 Alessandro Mannini

Hi Ann, look to my previous comments (ex. 19/3/2011) the b parameter is an array containing coords of boundary points that should be 8-connected. 8-connected means that if Bn is the n-th element of b and Bn+1 the next their x y coords should satisfy this relations: | Xn - Xn+1 |<=1 AND | Yn - Yn+1 |<=1. Start checking that with a simple example. Regards Alessandro

Comment only
08 May 2012 Ann

Ann (view profile)

i am trying to use this code on the image but i am getting the error "Curve isn't 8-connected in elements: "

what to do?

Comment only
17 Apr 2012 Alessandro Mannini

Hi Frb, please note than b contains coords of boundary points order so that they are 8-connected. The find function you use return coords of boundary points but in a different order. From Matlab Help seems it scans matrix column by column. Best regards Alessandro

Comment only
08 Apr 2012 Frb

Frb (view profile)

I checked this code, seems very useful but I have problem, I give this piece of code to make it 8-connected:
BW2 = bwperim(BW1,8);
[x y]=find(image==1);
b=[x y];
and then I put the result in b,
when I run the code error applies and says Curve isn''t 8-connected in elements. I appreciate any help.

Kind Regards,

Comment only
23 Mar 2012 Anush

Anush (view profile)

if i have an image what's the procedure to find the chain code for that particular image !

Comment only
14 Mar 2012 hamza

hamza (view profile)

Thanks for your great work, and I have a question :-
I have image called XYZ.png and I passed that images to this function but I found an error.

Please help me in how to execute this function.

28 Feb 2012 maddy

maddy (view profile)

i had a skeleton with me which i want to give as a input to this chaincode..and when i tried to do that...i am getting that subscript indices are must be either positive or real...please somebody help me in resolving this...

30 May 2011 Amr

Amr (view profile)

i have a silhouette for human image( and I put the image boundary in an array and then i passed it to the Freeman Chain Code function. this image shows the body boundary is connected to each other but in real it gives me this error
"Curve isn't 8-connected in elements:
idx -> 350
idx -> 700
idx -> 1050
idx -> 1400

so can any one help me please? :)

Comment only
19 Mar 2011 Alessandro Mannini

Look at description inside source code:

% b - boundary as np-by-2 array;
% np is the number of pixels and each element is a pair (y,x) of
% pixel coordinates

For example, if you have 4 points p=(y,x) like this p1=(5,1);p2=(5,2);p3=(4,2);p4=(3,1) b is:

b = [ 5 1;5 2;4 2;3 1]

note that points must be 8-connected.

Comment only
19 Mar 2011 Manhal

Manhal (view profile)

what should be the input for "b"?
is it an image or what ??
need help as soon as possible pls ..

Comment only
19 Mar 2011 Santhosh R

A very nice self explanatory code!!
Was very useful for my project.
Great job!!!!!!!!!

Contact us