Metadata-Version: 2.1
Name: argus
Version: 0.0.11
Summary: Helper routines for using multiple, inexpensive calibrated and synchronized cameras for 3D scientific use.
Home-page: https://bitbucket.org/devangel77b/argus
Author: Brandon Jackson and Dennis Evangelista
Author-email: devangel77b@gmail.com
License: GNU GPLv3
Keywords: calibration,camera,camera calibration,photogrammetry
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: 3D Modeling
Classifier: Topic :: Multimedia :: Graphics :: Capture :: Digital Camera
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering
Requires-Dist: numpy (>=1.13.0)
Requires-Dist: pandas (>=0.20.2)
Requires-Dist: scipy (>=0.19.1)

# Helper routines for using multiple, inexpensive cameras

Brandon Jackson and Dennis Evangelista, 2014-2015

Eventually setup cloneable Bitbucket repository:
```
hg --clone ssh://hg@bitbucket.org/devangel77b/argus
```
To install the module, run (as administrator):
```
python setup.py install
```
This also works although it only gives last stable:
```
sudo pip install argus
```

## What's new in Version 0.0.11

* Hopefully this brings PyPI in line with Bitbucket etc

## What's new in Version 0.0.10

* Seems to work for Python 3 and OpenCV 3
* CMei Omnidirectional Camera stuff
* Updated README and documentation
* Bug fixes
* now available through [https://pypi.org/project/argus/]
* API documentation at [http://argus.readthedocs.io/en/latest/]

## Description

Argus had 1000 eyes.  You might only have 3 cameras but hopefully this is
useful.

This Python module includes helper routines for calibrating, synchronizing, 
and using multiple inexpensive cameras for reconstructing 3D positions for
scientific uses, such as in biology, biomechanics, ecology, etc. This module
includes chessboard calibration, automatic wand tracking, and synchronization
using sound and is intended to interface with the python sba sparse bundle
adjustment routines for 3D calibration and reconstruction. 

Companion Matlab routines are also available.

If these routines are helpful in your work, please cite Jackson, Evangelista, Ray, Hedrick (2016), 3D for the people: multi-camera motion capture in the field with consumer-grade cameras and open source software, *Biology Open* **5**:1334-1342:

```bibtex
@article{Jackson:2016:3D,
author={Jackson, B and Evangelista, D and Ray, D and Hedrick, T},
year={2016},
title={3D for the people: multi-camera motion capture in the field with consumer-grade cameras and open source software},
journal={Biology Open},
volume={5},
pages={1334--1342},
doi={10.1242/bio.018713}}
```

## Still to do

Autowand and keypoint finder for automatic detection of extrinsic calibration 
points.  Also provide worked example with sparse bundle adjustment (sba is 
part of the Python sba library / or is implemented in Matlab in EasyWand). 

## See also

The Argus GUI is here [https://kilmoretrout@bitbucket.org/kilmoretrout/argus_gui] or visit [http://argus.web.unc.edu] for Windows and MacOS builds.

## Thanks to

Ty Hedrick, Dylan Ray, Talia Weiss, others


