Code covered by the BSD License  

Highlights from
Freeman Chain Code


5.0 | 5 ratings Rate this file 62 Downloads (last 30 days) File Size: 2.35 KB File ID: #29518
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 (21)
25 May 2014 cspit

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

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?

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.

23 Apr 2014 sujith

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.

21 Apr 2014 Monalisa Das

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

21 Feb 2014 Max

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

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

12 Jun 2013 Anton

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 ?

18 May 2012 rana

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

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

08 May 2012 Ann

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?

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

08 Apr 2012 Frb

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,

23 Mar 2012 Anush

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

14 Mar 2012 hamza

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

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

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? :)

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.

19 Mar 2011 Manhal

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

19 Mar 2011 Santhosh R

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

Contact us