Skip to content

Tools for image capture and processing with single and multiple uvc cameras

License

Notifications You must be signed in to change notification settings

JLMARIN/imaging

Repository files navigation

University of Alberta UAV Imaging Repository Build Status

This repository contains source code and relevant content for the UAV Imaging platform as part of UAV research developed at the University of Alberta.

LICENSE INFORMATION

Copyright (C) 2017 University of Alberta

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. The full text is available here: [http://www.gnu.org/licenses/gpl-2.0.html] and is also copied in file LICENSE inside this folder distribution.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Runtime Dependencies

All the code was developed and tested in Linux. Most tools are cross-platform and the rest should be easily portable to other platforms.

The following packages are required to run the programs in Linux:

  • v4l-utils
  • gstreamer-1.0
  • jq
  • inotify (for spec3, and multicam)
  • geographiclib (only for scripts in 'utilities' folder)
  • exiftool (only for scripts in 'utilities' folder)
  • opencv >= v2.4 (for programs in 'focus' folder)
  • ImageJ (for programs in 'alignment' folder)

On a Debian / Ubuntu system, the following command line instructions can be used to install all required packages:

# v4l-utils
sudo apt-get install v4l-utils 

# gstreamer-1.0
sudo apt-get install gstreamer1.0-tools gstreamer1.0-x gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly

# jq
sudo apt-get install jq

# inotify
sudo apt-get install inotify-tools

# geographiclib
sudo apt-get install geographiclib-tools

# exiftool
sudo apt-get install libimage-exiftool-perl

# opencv
check README inside ./focus

# ImageJ
check README inside ./alignment

Repository Structure

The structure of the repository is as follows:

  • alignment: contains the code for image alignment.
  • arduino: contains the code for the MCU in the USB Camera HUB board.
  • camera: contains the code to interface with individual cameras.
  • focus: contains the code for camera focus operations.
  • matlab: contains matlab code for processing images.
  • multicam: contains the code to interface with multiple cameras.
  • spec3: contains the code to interface with the 3-cameras multispectral system.
  • spec3_rijesh: contains a variation of spec3 used by Rijesh.
  • tests: contains testing code under development.
  • utilities: contains a series of utility scripts.

Running Code

This repository contains code written in multiple languages (Shell Scripts, C++, Java, Matlab). Most programs include instructions inside on how to execute and what arguments are needed. In some cases, information is also provided in the README files of each folder.

Administrators

Jorge Marin ([email protected])

Collaborators

Rijesh Augustine ([email protected])

Dr. Duncan Elliot ([email protected])