Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
doc:labeling_tools [2014/06/05 11:38]
127.0.0.1 external edit
doc:labeling_tools [2014/08/08 09:47] (current)
admin [Installation]
Line 1: Line 1:
  
 ====== Labeling tool for human activity data ====== ====== Labeling tool for human activity data ======
 +~~NOTOC~~
 +
 +This tool allows to annotate observations of human activity data by setting markers in a timeline that indicate the end of a segment. Marker can describe e.g. the types of actions, objects the observed subject has interacted with, etc. The program then generates annotations for the frames since the previous marker. The set of marker types as well as mappings to be used when exporting the annotations can be configured using YAML files.
  
 {{ :​labeling-tool.png?​700 |}} {{ :​labeling-tool.png?​700 |}}
Line 6: Line 9:
 ===== Installation ===== ===== Installation =====
  
-The program has been created using [processing] and [controlP5] in Java and is available for Linux, Windows and MacOS. After download, just unpack the archive and start the DatalabelingCogwatch file.+The program has been created using [[http://​processing.org/​|processing]] and [[http://​www.sojamo.de/​libraries/​controlP5/​|controlP5]] in Java and is available for Linux, Windows and MacOS. After download, just unpack the archive and start the DatalabelingCogwatch file.
  
   * {{:​application.linux.zip|Linux}}   * {{:​application.linux.zip|Linux}}
Line 12: Line 15:
   * {{:​application.windows.zip|Windows}}   * {{:​application.windows.zip|Windows}}
  
-In Ubuntu, you need to have the following packages installed: ​+The source code of this tool can be found at GitHub in the repository [[https://​github.com/​knowrob/​data_labeling_tool|knowrob/​data_labeling_tool]]. ​In Ubuntu, you need to have the following packages installed: ​
   sudo apt-get install libgstreamer0.10-0 libgstreamer0.10-dev libgstreamer-plugins-base0.10-0 libgstreamer-plugins-base0.10-dev   sudo apt-get install libgstreamer0.10-0 libgstreamer0.10-dev libgstreamer-plugins-base0.10-0 libgstreamer-plugins-base0.10-dev
  
- +To provide some test data to start with, the following archive contains a sample folder structure including a video, some first dummy annotations,​ and some configuration files.
-To provide some test data to start with, the following archive contains a sample folder structure including a show video, some first dummy annotations,​ and some configuration files.+
  
   * {{:​example-sequence.zip|Example data}}   * {{:​example-sequence.zip|Example data}}
Line 23: Line 25:
  
  
-===== Functionality ​=====+===== Usage =====
  
   * Start the program and select the video file to be labeled   * Start the program and select the video file to be labeled
Line 67: Line 69:
 ===== Configuration files ===== ===== Configuration files =====
  
-The set of label categories and the label values can be configured using a set of [http://​www.yaml.org YAML files] in the config folder. Usually, such a set of configuration files needs to be created only once for a whole sequence of experiments and can be copied to each experiment data folder. +The set of label categories and the label values can be configured using a set of [[http://​www.yaml.org|YAML files]] in the config folder. Usually, such a set of configuration files needs to be created only once for a whole sequence of experiments and can be copied to each experiment data folder.
 Since these configuration files are stored inside the respective data folders, ​ the label domains for the annotations are also inherently documented. Since these configuration files are stored inside the respective data folders, ​ the label domains for the annotations are also inherently documented.
  
Line 155: Line 156:
 ==== OWL export ==== ==== OWL export ====
  
-The OWL exporter outputs a description of the task in terms of action instances in OWL, linked to the respective objects and additional information. This file can be loaded into KnowRob and used for reasoning, e.g. using the mod_ham package from the [[https://​github.com/​knowrob/​knowrob_human.git|knowrob_human repository]] ​or visualizations using mod_vis. For more information on the OWL representation of actions, have a look [[Modeling_tasks_and_actions|here]].+The OWL exporter outputs a description of the task in terms of action instances in OWL, linked to the respective objects and additional information. This file can be loaded into KnowRob and be used for reasoning, e.g. using the //mod_ham// package from the [[https://​github.com/​knowrob/​knowrob_human.git|knowrob_human repository]]. For more information on the OWL representation of actions, have a look [[Modeling_tasks_and_actions|here]].