Skip to content
The SimpleSeer Automatic Inspection Appliance
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
SimpleSeer
etc
scripts
tests
.gitignore
README
filter.cfg
pip.requirements
setup.py

README

The SimpleSeer is a way to create inspections and take measurements,
it uses the SimpleCV framework and MongoDB to turn any PC into a vision appliance.

Examples of usage:
==========================

To start SimpleSeer in continuous mode:

    $ cd SimpleSeer
    $ python -mPyro4.naming &
    $ simpleseer broker & 
    $ simpleseer core &
    $ simpleseer web 

To start an iPython shell:

    $ simpleseer shell (terminal shell)
    $ simpleseer notebook (web-based notebook) 

To capture an image, display, and store in the database:

    >>> frames = SS.capture()
    >>> frames[0].image.show()
    >>> frames[0].save()

To retrieve and display all captured frames at a 1 second delay:

    >>> for f in Frame.objects:
    >>>   f.image.show()
    >>>   time.sleep(1)

Installation instructions:
==========================

You must have SimpleCV installed first! http://simplecv.org

You will also need to edit (or copy and edit) default.cfg for settings
that reflect your Camera, database, and etc.

Note: You can optionally install pyfirmata to interface with an arduino

TODO: update these to include a virtualenv


Ubuntu Linux 12.04
-----------------------------------
To run the installer:

	wget https://github.com/ingenuitas/SimpleSeer/zipball/master -O SimpleSeer.zip; unzip SimpleSeer.zip; mv ingenuitas-* SimpleSeer;
	cd SimpleSeer
	sh scripts/install.sh

or manually install with these commands from WITHIN the SimpleSeer directory:

	sudo apt-get install python-dev python-setuptools python-pip libzmq-dev mongodb nodejs npm build-essential python-gevent libevent-dev supervisor ipython-notebook libvpx-dev libvpx1 swig subversion
	sudo npm install -g brunch
	sudo pip install -r pip.requirements
	sudo easy_install coffeescript
	sudo python setup.py develop
	sudo mkdir /etc/simpleseer
	sudo cp `pwd`/etc/mongodb.conf /etc/
	sudo ln -s `pwd`/SimpleSeer/static/ /etc/simpleseer/static
	sudo ln -s `pwd`/etc/supervisor.conf /etc/supervisor/conf.d/supervisor.conf
	sudo ln -s `pwd`/etc/simpleseer.cfg /etc/simpleseer.cfg
	sudo ln -s `pwd`/etc/simpleseer-logging.cfg /etc/simpleseer-logging.cfg
	sudo killall supervisord
	sudo supervisord
	sudo supervisorctl start seer-dev:


*NOTE: Don't install python-pymongo from the repos as it is much too far out of date and requires 2+

Mac OS X (Using homebrew)
--------------------------------------

> brew install mongodb
> brew install zmq
> sudo easy_install pip
> sudo ARCHFLAGS="-arch i386 -arch x86_64" pip install -r pip.requirements 

(i had to check out gevent-socketio from bitbucket and comment out #setup_requires line to get it working on mac)
> hg clone https://bitbucket.org/Jeffrey/gevent-socketio
> cd gevent-socketio
> perl -pi -e "s/setup_requires/#setup_requires/" setup.py
> sudo python setup.py install

> (optional) hg clone https://bitbucket.org/tino/pyfirmata && cd pyfirmata && python setup.py install

> curl http://npmjs.org/install.sh | sh
> npm install -g brunch
> npm install -g brunch-less
> python setup.py develop
> sudo python
>>> from IPython.external.mathjax import install_mathjax
>>> install_mathjax()
=======

Install Mongo 2.1
=================
Since features are used from mongo 2.1 and not included in the repos, the following
explains how to manually install it.

	mkdir -p /tmp/mongo
	cd /tmp/mongo
	wget http://fastdl.mongodb.org/linux/mongodb-linux-x86_64-2.1.1.tgz
	tar zxvf mongodb-linux-x86_64-2.1.1.tgz
	cd mongodb-linux-x86_64-2.1.1
	cd bin
	sudo cp * /usr/local/bin/
	sudo mkdir -p /var/lib/mongodb
	sudo mkdir -p /var/log/mongodb



Optional Libraries
============
ZBAR
This is a simplecv optional library that performs barcode reading.

See:
	http://pypi.python.org/pypi/zbar	
Or:
	sudo easy_install zbar 
============
TESSERACT
This is a simplecv optional library that performs optical character recogntion (OCR). 
Make sure to install the tesseract libraries and required python bindings

See:
http://code.google.com/p/python-tesseract/wiki/HowToCompilePythonTesseract

	
	
You can’t perform that action at this time.