Footfall

Introduction

Footfall is a camera based people counting system that uses a Raspberry Pi and Pi Cam and openFrameworks. There is more information about the system on our blog.

Important: The source code provides a barebones system that will require customisation for each installation.

This means tweaking variables which are explained in the Configuration.md.

Built using openFrameworks 0.9.8.

How to Customise

Inside the bin/data folder of the Footfall App there is a config.json file. This contains all of the relevant variables you will need to change.

Please see the Configuration section.

How to install

First of all we need to install openframework by following below step. I suppose you are on home folder of pi user.

wget http://openframeworks.cc/versions/v0.9.0/of_v0.9.0_linuxarmv7l_release.tar.gz
tar -xvf of_v0.9.0_linuxarmv7l_release.tar.gz
mv of_v0.9.0_linuxarmv7l_release of
cd of/scripts/linux/debian
sudo ./install_dependencies.sh
sudo ./install_codecs.sh

Verify installation by compiling example

cd /home/pi/of/examples/graphics/polygonExample
make
make run

if polygon runs fine, then we have installed openframework successfuly.

now we will get the clone of footfall program

cd ~
git clone https://github.com/DjonesJ/Footfall.git Footfall

Copy getrepos.sh from Footfall and paste into of/addons

cp Footfall/getrepos.sh of/addons/
cd of/addons/
./getrepos.sh
cp -r Footfall/Footfall/ of/apps/myApps/
cd of/apps/myApps/Footfall
make clean
make

Documentation

Find attached the relevant readmes to help build Footfall system.

• Raspberry Pi
• Compiling
• Configuration
• Running
• Server
• Troubleshooting

Thanks

Thanks to Kyle McDonald for ofxCv and George Profenza for ofxCvPiCam.

Warning

The original software was intended for sole use within Watershed, therefore some of the source code has been altered for public use and differs slightly to our systems. For example our system generated event tags showing screening in conjunction with the total number of people in Watershed, to do this we had to pre-populate some timestamps and may cause an issue if the system is ran past a certain time.

Fixes

Will update soon.

Updates

Update 1

I have added some new documentation about how to create the server side system database etc... There is also a new guide about how to setup the raspberry pi as a server.

I will be updating this repo with more detailed instructions and improved tracking over the coming weeks.

Update 2

15/09/16

I will updating the project to of_0.9.3 over the next coming weeks this should resolve some of the issues people have been having with ofxCv | ofXML.

Update 3

13/02/17

I will updating the project to of_0.9.8 soon. There will also only be one version of Footfall that should work across all Pi Platforms.

In the mean time. If you are coming up against compiler errors for ofxCvPiCam and ofxCv, try moving the ofxCvPiCam libs then, download the latest ofxCv repo. If you are using an earlier version oF ie less than 0.9.8. checkout the VS2012-stable branch. If you are using 0.9.8 use the origin/stable branch this will negate the glm:: errors.