Group 56: Angry Birds Trajectory Tracking

This program feeds a video trailer of the 2009 Rovio Entertainment game 'Angry Birds' as input and displays this video in near-real-time as an output, annotated with colour-coded bounding boxes around the birds and pigs, as well as an estimate of birds' trajectories while in flight.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for testing purposes.

Prerequisites

The following software is required to run this project:

• MATLAB environment

You may be required to install Add-On packages in MATLAB. To find out which Add-On packages have been installed or to install new packages, please follow the instructions in the next section - Installing.

MATLAB Add-On packages required (versions listed are tested):

• Computer Vision System Toolbox (version 8.2)
• Image Processing Toolbox (version 10.3)

Installing

Installation Guides for the MATLAB software can be found here.

To check existing/install new MATLAB Add-On packages:

1. Launch MATLAB by double clicking on the application.
2. Navigate to HOME tab > Add-Ons > Manage Add-Ons
3. If the packages you require are not listed, click on "Get Add-Ons" near the top right of the window.
4. In the new window pop-up, search for the relevant packages and click to install.

Running the program

Now that MATLAB is installed and configured on your device, the following are instructions to run and test our program.

1. Navigate to the directory which this project is saved in. 
2. Find the main program, a file named main.m and double click on it. 
3. Once the program is launched in MATLAB, make sure that the Current Folder shows the main.m file and other files. Alternatively, navigate to the HOME tab and click Open and select the main.m file.
4. Select all folders in the Current Folder directory, right click > Add to Path > Selected Folders and Subfolders. Alternatively, manually add paths for all folders by typing in the Command Window: addpath('FolderName')
5. Navigate to the EDITOR tab and hit Run.

Built With

• MATLAB - The programming environment used

GitHub Repository

We use GitHub Repository as our main collaboration platform: ENGN4528 repository.

Authors

• Uri Pierre Burmester (u5561093)
• Logan Davis (u5798893)
• Xue Ling Teh (u6462117)

Acknowledgments

• MATLAB documentation
• MATLAB forum
• ENGN4528 Computer Vision course notes