|
|
@@ -0,0 +1,218 @@
|
|
|
+<!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>
|
gapchich