From 10d6fd414e9c4cd06aee93b1ae228ec1c121c0df Mon Sep 17 00:00:00 2001
From: Austin Van Blanton <imaus10@gmail.com>
Date: Fri, 23 Aug 2013 13:44:06 -0400
Subject: [PATCH] Add comments to INRIAPerson sigset generator script

---
 scripts/writeINRIAPersonSigset.sh | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/scripts/writeINRIAPersonSigset.sh b/scripts/writeINRIAPersonSigset.sh
index cf72936..a32a861 100755
--- a/scripts/writeINRIAPersonSigset.sh
+++ b/scripts/writeINRIAPersonSigset.sh
@@ -1,5 +1,9 @@
 #!/bin/bash
 
+# prints out a <presentation> element
+# additional arguments after the first two are rectangle coordinates
+# from that, it will create a nested <data:bbox> element (from the ViPER standard)
+# http://viper-toolkit.sourceforge.net/docs/file/
 writePresentation()
 {
     pres="\t\t<presentation Label=\"pos\" file-name=\"$1/pos/$2\""
@@ -14,27 +18,37 @@ writePresentation()
     fi
     printf "$pres\n"
 }
-# for xargs calling bash below
+# export writePresentation so xargs can call it using bash -c below
 export -f writePresentation
 SEDREGEX='s/.*(\([0-9]*\), \([0-9]*\)) - (\([0-9]*\), \([0-9]*\))/writeIt \1 \2 \3 \4/'
 
 echo '<?xml version="1.0" encoding="UTF-8"?>'
 echo '<biometric-signature-set>'
+
+# print out the positive image sigs
 for fullpath in INRIAPerson/$1/pos/*; do
+    # get just the filename, minus the path
     filename=$(basename "$fullpath")
     echo -e "\t<biometric-signature name=\"${filename%.*}\">"
+
+    # if this folder has annotations, add bounding boxes
     if [ -d INRIAPerson/$1/annotations ]; then
         annotation="INRIAPerson/$1/annotations/${filename%.*}.txt"
         grep 'Bounding box' $annotation | sed "$SEDREGEX" | xargs -n 5 bash -c "writePresentation $1 $filename \$@"
+    # otherwise, just the normal presentation
     else
         writePresentation $1 $filename
     fi
+
     echo -e '\t</biometric-signature>'
 done
+
+# print out the negative image sigs
 for fullpath in INRIAPerson/$1/neg/*; do
     filename=$(basename "$fullpath")
     echo -e "\t<biometric-signature name=\"${filename%.*}\">"
     echo -e "\t\t<presentation Label=\"neg\" file-name=\"$1/neg/$filename\" />"
     echo -e '\t</biometric-signature>'
 done
+
 echo '</biometric-signature-set>'
--
libgit2 0.21.4