Tracking System - Revision history

Giovannireina: /* Run Halcon on local machine */

2015-02-24T17:01:28Z

Run Halcon on local machine

2014-02-11T17:53:43Z

Arena Viewer GUI

2014-02-11T17:53:24Z

Arena Viewer GUI

2014-02-11T17:23:38Z

Arena Viewer GUI

2014-02-11T17:18:49Z

Arena Viewer GUI

2014-02-11T16:34:23Z

User's guidelines

2014-02-11T16:32:47Z

User guidelines

2014-02-11T16:32:20Z

Administrator guidelines

2014-02-11T16:30:54Z

Command links

2014-02-11T16:30:39Z

Command links

@@ Line 63: / Line 63: @@
 '''WARNING:''' this guide is meant for Halcon developers running Linux 64 bit. Installation process for other OS can be found at http://www.mvtec.com/halcon/download/release/index-10.html but it has not been tested.
-* Dowload ''halcon.tar.gz'' from ______________
+* Dowload ''halcon.tar.gz'' from the server liebig.ulb.ac.be in /home/ats/halcon.tar.gz
 * Extract the content in ''/opt'' on your local machine. From the folder where you downloaded ''halcon.tar.gz'':
     sudo cp halcon.tar.gz /opt

@@ Line 234: / Line 234: @@
 [[File:arena_viewer_snapshot.png|thumb|right|Figure 4. Arena Viewer snapshot.]]
-[[File:arena_viewer_controllers.png|thumb|right|Figure 5. Arena Viewer controllers.]]
+[[File:arena_viewer_controllers.png|thumb|left|Figure 5. Arena Viewer controllers.]]
 ==Adapter for the cameras==

← Older revision		Revision as of 17:53, 11 February 2014
Line 231:		Line 231:

	'''!!!WARNING!!!''' As a matter of performance, the refreshing operation of the frames in the Arena Viewer is very time consuming, degrading the performance of the Tracking System and the overall FPS. Therefore, the refresh toggle button (two green circular arrows) allows the user to enable or disable the refresh of the image. '''It is best practice to disable the refresh of the images after the tune of the experiment is done.'''		'''!!!WARNING!!!''' As a matter of performance, the refreshing operation of the frames in the Arena Viewer is very time consuming, degrading the performance of the Tracking System and the overall FPS. Therefore, the refresh toggle button (two green circular arrows) allows the user to enable or disable the refresh of the image. '''It is best practice to disable the refresh of the images after the tune of the experiment is done.'''
		+
		+	[[File:arena_viewer_snapshot.png\|thumb\|right\|Figure 4. Arena Viewer snapshot.]]
		+
		+	[[File:arena_viewer_controllers.png\|thumb\|right\|Figure 5. Arena Viewer controllers.]]

	==Adapter for the cameras==		==Adapter for the cameras==

← Older revision		Revision as of 17:23, 11 February 2014
Line 229:		Line 229:

	'''WARNING:''' All the options selected in the experiment file are reported unchanged in the Arena Viewer.		'''WARNING:''' All the options selected in the experiment file are reported unchanged in the Arena Viewer.
		+
		+	'''!!!WARNING!!!''' As a matter of performance, the refreshing operation of the frames in the Arena Viewer is very time consuming, degrading the performance of the Tracking System and the overall FPS. Therefore, the refresh toggle button (two green circular arrows) allows the user to enable or disable the refresh of the image. '''It is best practice to disable the refresh of the images after the tune of the experiment is done.'''

	==Adapter for the cameras==		==Adapter for the cameras==

← Older revision		Revision as of 17:18, 11 February 2014
Line 226:		Line 226:

	===Arena Viewer GUI===		===Arena Viewer GUI===
		+	The Arena Viewer is an interactive GUI that helps the user setting up the experiment. With the Arena Viewer the user can see how the experiment is evolving in real time, and if a tracker has been defined in the experiment file the detected markers are highlighted. The Arena Viewer is helpful in the tuning phase before the real experiment, when the user must carefully balance the environmental light with camera acquisition parameters such as exposure time and gain. It is also helpful during the run of the experiment, because it allows the user to stop the recording/tracking of the experiment, make some changes in the arena and start again.
−	The Arena Viewer is an interactive GUI that helps the user setting up the experiment
		+
		+	'''WARNING:''' All the options selected in the experiment file are reported unchanged in the Arena Viewer.

	==Adapter for the cameras==		==Adapter for the cameras==

@@ Line 223: / Line 223: @@
 *'''runs_timing.txt''' - This file acquires some meaning only if it is created using the interactive GUI. This file store in each row the first and last timestep of a tracking session. It is useful if an user wants to track or record several runs of an experiment and cut the videos afterwards.
 ===Arena Viewer GUI===
-The Arena Viewer is an interactive GUI that help the user setting up the experiment
+The Arena Viewer is an interactive GUI that helps the user setting up the experiment
 ==Adapter for the cameras==

@@ Line 150: / Line 150: @@
     ./setup_user_home.sh <existing_user_name>
-==User guidelines==
+==User's guidelines==
 Every user who is interested in using the Arena Tracking System should ask an administrator to create and/or set up his environment in the Arena Tracking System Server. When the set up is completed the user can access the ''arena_tracking_system'' directory in his home directory. The ''arena_tracking_system'' directory contains two links to executable files and (''arena_viewer'' and ''track_no_GUI'') and two directories (''conf'' and ''data''). The link ''arena_viewer'' runs the Tracking System with an interactive GUI, the link ''track_no_GUI'' runs the the Tracking System in a non-interactive textual mode. The ''conf'' directory contains editable xml files that must be properly configured by the user before launching any experiment. There are two kinds of xml files: resources and experiment. In order to run an experiment, the user must specify one of each kind of file:

@@ Line 22: / Line 22: @@
 The directory ''/home/ats/usr_config'' is the directory that represents the ''arena_tracking_system'' directory in each user's home. This directory contains two links to executable files located in ''/tracking/lib''. One link runs the Tracking System with interactive GUI (arena_viewer), the other runs the Tracking System in a non-interactive textual mode. The user's environment is integrated with the directory ''data'' where the results of the experiments are stored and the directory ''conf'' that contains all the user concerning resources and experiments.
-==Administrator guidelines==
+==Administrator's guidelines==
 The Halcon libraries and the development environment HDevelop can be used either remotely from the Arena Tracking System Server or locally by downloading the libraries on your machine.

@@ Line 218: / Line 218: @@
 .85714
 |}
 *'''statistics.txt''' - This file contains in each line the timestep number, for each camera, the time elapsed for the current tracking, and finally the total time for the timestep. This file is useful to calculate the maximum FPS rate for real time purpose.