ComputerVisionJena
/
ImageLabeler


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218
							<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
	<TITLE></TITLE>
	<META NAME="GENERATOR" CONTENT="LibreOffice 3.3  (Unix)">
	<META NAME="CREATED" CONTENT="20111021;12232200">
	<META NAME="CHANGED" CONTENT="20111021;14374400">
	<STYLE TYPE="text/css">
	<!--
		@page { margin: 0.79in }
		P { margin-bottom: 0.08in }
		A:link { so-language: zxx }
	-->
	</STYLE>
</HEAD>
<BODY LANG="en-US" DIR="LTR">
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Image
Labeler</B></FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>user
guide</B></FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>author:
Gapchich Vladislav</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>2011</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4><B>1.
Introduction</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Image
labeler is a tool that allows you to </SPAN></FONT>mark objects on
the image and label them accordingly.</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in">For example, lets take this
picture:</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT COLOR="#000000"><IMG SRC="ImageLabeler_manual_html_m14684b4b.jpg" NAME="graphics2" ALIGN=CENTER WIDTH=453 HEIGHT=301 BORDER=1><BR CLEAR=LEFT></FONT><FONT SIZE=3><B>Pic.
1.1</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>There
are five objects on it: two markers, two pens, a toy and a hat. Let's
suppose that pen, toy and a hat are certain classes of objects and
their numbers are: hat – 1, pen – 2, toy – 3. So now we can
select all objects in the image and label them accordingly. </FONT>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>We'll
have something like this:</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT COLOR="#000000"><IMG SRC="ImageLabeler_manual_html_3a8dae8d.png" NAME="graphics3" ALIGN=CENTER WIDTH=452 HEIGHT=300 BORDER=1><BR CLEAR=LEFT></FONT><FONT SIZE=3><B>Pic.
1.2</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>After
the labeling procedure is finished all the information about selected
regions can be saved into xml file or an application can generate a
segmented image only with selected regions. </FONT>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in; font-weight: normal"><FONT COLOR="#c0c0c0"><IMG SRC="ImageLabeler_manual_html_m11ed6116.png" NAME="graphics4" ALIGN=CENTER WIDTH=455 HEIGHT=302 BORDER=1><BR CLEAR=LEFT></FONT><FONT SIZE=3>Pic.
1.3</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>Now
you've seen the main features of this application. Let's take a look
at the program in more detail.</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4><B>2. Getting
started</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>After
the first launch of ImageLabeler application you'll see this window:</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><IMG SRC="ImageLabeler_manual_html_m7e4b67ac.png" NAME="graphics1" ALIGN=CENTER WIDTH=611 HEIGHT=388 BORDER=0><BR CLEAR=LEFT><FONT SIZE=3><B>Pic.
2.1</B></FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>Everything
is empty because no image has been loaded yet. There are a lot of
ways to open images. </FONT>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4><B>3. Loading
images and data</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>Click
on menu File and you'll see these options: “load image”, “load
images”, “load labeled image”, “load legend” and “Pascal”
menu.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><IMG SRC="ImageLabeler_manual_html_m39811203.png" NAME="graphics5" ALIGN=CENTER WIDTH=637 HEIGHT=397 BORDER=0><BR CLEAR=LEFT><FONT SIZE=3><B>Pic.
3.1</B></FONT></P>
<UL>
	<LI><P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>If
	you want to load one single image just click “load image” and
	choose one from your file system.</FONT></P>
	<LI><P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>If
	you want to load a folder with images click on “load
	images(recursively)” and choose a folder containing images from
	your file system. (recursively) means that program will also look
	for images in every subdirectory it will find. </FONT>
	</P>
	<LI><P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>If
	you've already labeled some image and want to load it then click on
	“load labeled image” and look for the file with “*.dat”
	extension. Usually information about labeled image should be stored
	in the same directory as the original image is and it's name should
	look like “imagename_labeled.dat” where “imagename” part is
	the name of an original file.</FONT></P>
	<LI><P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>If
	you have previously saved legend(labels and their colors) you can
	load it by clicking load legend. The file with legend also has xml
	format and “*.dat” extension</FONT></P>
</UL>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>An
application with loaded image looks this:</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in; font-weight: normal"><IMG SRC="ImageLabeler_manual_html_4018ae25.png" NAME="graphics6" ALIGN=CENTER WIDTH=582 HEIGHT=368 BORDER=0><BR CLEAR=LEFT><FONT SIZE=3>Pic
3.2</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>As
you can see all the tools are enabled now and you can use them.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4><B>4.
Labeling</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR CLEAR=LEFT><FONT SIZE=3>First
you should add some labels. To do it you have to click on “Add
label” button in the top right corner of the window.</FONT></P>
<P ALIGN=CENTER><IMG SRC="ImageLabeler_manual_html_65b060c.png" NAME="graphics7" ALIGN=CENTER WIDTH=579 HEIGHT=366 BORDER=0></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=3><B>Pic. 4.1</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>As
the result a new label with the name “New label” will appear. The
number of labels can not be more than 100. To change the name of a
label just make a double click on it and edit the text of an item. To
remove the label you can use “Remove label” button or open a
popup menu by right click on an item and select “Delete” action.
To change label's color or make it the “main” label use popup
menu as well.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4><B>5.
Selecting objects</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>Now
when the labels are created and their colors are set we can begin
with the selecting objects on the image. </FONT>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><IMG SRC="ImageLabeler_manual_html_2ce1f8a5.png" NAME="graphics8" ALIGN=CENTER WIDTH=560 HEIGHT=354 BORDER=0><BR CLEAR=LEFT><FONT SIZE=3><B>Pic.
5.1</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>There
are two tools you can use to select an object on the image:</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	First
– bounding box. To add a bounding box just select it from the
toolbox in the upper left corner and start selecting the bounds of an
objects with left mouse button pressed. Move mouse from one corner of
the rectangle to another to capture the whole object in it. If you're
not satisfied with the result you can start a new rectangle by
clicking left mouse button again and the old one will be
automatically erased.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	Second
– polygon tool. To start selecting object with this tool you need
to follow the object contour with the “pointing and clicking”.
Just click with the left mouse button in the key points of the
contour and program will draw a polygon which follow the points
you've created. You can press and hold left mouse button to see the
last line of the polygon and select more accurately.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	If
you've decided no to make any selection just click “Esc” button
on your keyboard.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	Before
you decide to confirm the object you selected you should choose one
of the labels you created before. To confirm the selection click
“Confirm selection” button in the lower left corner of the window
or just press “enter” button on the keyboard.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	To
zoom in or zoom out an image use ctrl + mouse wheel.</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=3><B><FONT SIZE=4>6.
Editing selected areas</FONT></B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>To
edit already selected area find it in the “Selected areas” list
and double click on it. </FONT>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><BR>
</P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><IMG SRC="ImageLabeler_manual_html_91f3f31.png" NAME="graphics9" ALIGN=CENTER WIDTH=579 HEIGHT=366 BORDER=0><BR CLEAR=LEFT><FONT SIZE=3><B>Pic.
6.1</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>One
of the contours will become dashed and all it's points will become
visible and selectable. To edit a contour grab any point you want
with the mouse pointer and move it until you get the satisfying
result. Also you can edit Label ID of the selected area and it's
point by changing text of an item manually. To do it call a popup
menu of the “Selected areas” list and choose “Change area”
action. You can delete area using the same popup menu but selecting
“Delete area”</FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=4><B>7. Saving
information about objects</B></FONT></P>
<P ALIGN=CENTER STYLE="margin-bottom: 0in"><IMG SRC="ImageLabeler_manual_html_6bc3874.png" NAME="graphics10" ALIGN=CENTER WIDTH=544 HEIGHT=344 BORDER=0><BR CLEAR=LEFT><FONT SIZE=3><B>Pic.
7.1.</B></FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	To
save the whole information(labels, objects, image description, tags,
segmented image as 2d array of label id's) use “Save all info”
action in the “File” menu. This file will have xml format and
“*.dat” extension. By default it's name would be
“imagename_labeled.dat” where “imagename” part is the name of
an original file. If you'll store this “*.dat” file in the same
directory as the original image then you'll be able to load it using
“load image” menu action. Storing data with this the default name
in the directory of an original image is highly recommended. </FONT>
</P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	To
get segmented image like <B>Pic. 1.3 </B>simply choose “Save
segmented picture” action from the “File” menu. It is also
recommended to use default name and path for the segmented image. To
look at the results of segmentation go to the “View” menu and
select “Segmented” action</FONT></P>
<P ALIGN=LEFT STYLE="margin-bottom: 0in; font-weight: normal"><FONT SIZE=3>	To
save the legend(labels, ids and colors) choose “Save legend”
action from the “File” menu.</FONT></P>
</BODY>
</HTML>