The SimpleSeer is a framework to create inspections and take measurements,
it uses the SimpleCV framework and MongoDB to turn any PC into a vision appliance.
Examples of command line usage:
==========================
SimpleSeer requires you to create a new project to use:
$ simpleseer create MYPROJECT
$ cd MYPROJECT
Once enabled, you can start SimpleSeer in continuous mode:
$ cd SimpleSeer
$ simpleseer core &
$ simpleseer web
To start an iPython shell:
$ simpleseer shell (terminal shell)
$ simpleseer notebook (web-based notebook)
To run a script:
$ simpleseer script my-commands.py
To export the last 10 images:
$ simpleseer images -n 10
To rebuild the web interface:
$ simpleseer build
To deploy to a production server (with supervisord):
$ simpleseer deploy
Examples of shell/script usage:
==========================
To retrieve and display all captured frames at a 1 second delay:
>>> for f in Frame.objects:
>>> f.image.show()
>>> time.sleep(1)
To list loaded inspections and measurements:
>>> print Inspection.objects
>>> print Measurement.objects
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/setup.sh
or manually install with these commands from WITHIN the SimpleSeer directory:
sudo apt-get install python-dev python-setuptools python-pip libzmq-dev nodejs npm build-essential python-gevent libevent-dev supervisor ipython-notebook swig libvpx-dev subversion python-pastescript ipython python-opencv python-scipy python-numpy python-pygame $ sudo apt-get install libamd2.2.0 libblas3gf libc6 libgcc1 libgfortran3 liblapack3gf libumfpack5.4.0 libstdc++6 build-essential gfortran libatlas-sse2-dev python-all-dev libsdl1.2-dev libsmpeg-dev
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
Windows
--------------------------------------
Sadly installing SimpleSeer on windows is a bit more of a manually process.
You will need to have SimpleCV installed for it to run, please follow the
instructions here:
https://github.com/ingenuitas/SimpleCV#windows-7vista
Once that is installed you will need to install the following:
http://pypi.python.org/packages/2.7/g/gevent/gevent-0.13.8.win32-py2.7.msi
http://git-scm.com/download/win
http://nodejs.org/dist/v0.8.18/x64/node-v0.8.18-x64.msi
http://miru.hk/archive/ZeroMQ-2.2.0~miru1.0-win64.exe
https://github.com/downloads/zeromq/pyzmq/pyzmq-2.2.0.win32-py2.7.msi
http://pandas.pydata.org/getpandas.html (get the version you need x32 or x64)
Mongo on windows:
======================================
You will need to download mongo for windows:
http://downloads.mongodb.org/win32/mongodb-win32-x86_64-2.2.3.zip
And then follow the insructions at:
http://docs.mongodb.org/manual/tutorial/install-mongodb-on-windows/
You should be good to run basic SimpleSeer tasks. Some libraries may
have been added since this README has been updated and may require manually
installing libraries.