Introduction

The most valuable piece of code of this toolkit at this time is the command line utility walk_folder. To use it, simply run the follwing command on the command line (adjust your path to a measurement folder):

./walk_folder.py /some/path/DATA/HHG_00012Ar/

This will load the files in that folder and will let you walk you through the measurement points using the arrow keys.

Here is an example video that illustrates the usage of these tools:

Requirements

The following requirements have to be met in order to run this software properly:

• OpenCV – An open source computer vision library used to read image files and more.
• NumPy – A fast Python module for number crunching.

Optional dependencies include

• matplotlib

To create this documentation, you also need:

• Sphinx

Standard Python modules required for this to work include:

• multiprocessing
• xml.etree.ElementTree
• datetime.datetime
• time
• re
• os
• sys

Installation of the Requirements

On a Mac:

1. Install Homebrew

2. Install Numpy: pip install numpy

3. Install OpenCV like this: brew install opencv

4. Add these lines to your ~/.bashrc to let Python find it:

   # needed for OpenCV:
   PYTHONPATH="/usr/local/lib/python2.7/site-packages/":"${PYTHONPATH}"
   export PYTHONPATH

On Ubuntu Linux:

1. Install OpenCV (read this: http://opencv.willowgarage.com/wiki/InstallGuide):

   sudo apt-get install cmake libgtk2.0-dev
   cd ~/Downloads
   wget http://sourceforge.net/projects/opencvlibrary/files/opencv-unix/2.4.0/OpenCV-2.4.0.tar.bz2
   tar -xf OpenCV-2.4.0.tar.bz2
   cd OpenCV-2.4.0
   cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -D BUILD_PYTHON_SUPPORT=ON .
   make
   sudo make install

2. Install Numpy using sudo apt-get install python-numpy python-scipy