Horus is a general solution for 3D scanning. It provides graphic user interfaces for connection, configuration, control, calibration and scanning. It is ready to use with Open Source Ciclop 3D Scanner.

This project has been developed in Python language and it is distributed under GPL v2 license.

More interest links are shown below:

• Presentation [es]
• 3D Design [es]
• Electronics [es]
• Firmware [es]
• Software [es]
• Documentation [es]

Add our PPA keys

sudo add-apt-repository ppa:bqopensource/opencv
sudo add-apt-repository ppa:bqopensource/horus

Upgrade your system

sudo apt-get update
sudo apt-get dist-upgrade

Install Horus

sudo apt-get install horus

If user has no access to serial port, execute:

sudo usermod -a -G dialout $USER

Reboot the computer to apply the changes

sudo reboot

For Debian 8 it is needed to install:

sudo apt-get install software-properties-common python-software-properties
sudo add-apt-repository ppa:bqopensource/opencv
sudo add-apt-repository ppa:bqopensource/horus-dev

Also before adding the PPA keys:

sudo sed -i 's/jessie/trusty/g' /etc/apt/sources.list.d/bqopensource-*.list

To install USB Camera drivers follow these instructions Logitech Camera C270 Drivers

Execute .exe file. This package contains all dependencies

Reboot the computer to apply the changes

Horus has been developed in Ubuntu Gnome. If you are a developer and you want to modify the code, contribute, build packages, etc. you may follow this steps:

sudo add-apt-repository ppa:webupd8team/sublime-text-3
sudo apt-get update
sudo apt-get install sublime-text-installer

sudo apt-get install arduino arduino-core

Stino project on GitHub

sudo apt-get install git gitk

Following dependencies are included in deb package, but if you want to install it manually, they are:

sudo apt-get install python-serial python-wxgtk2.8 python-opengl python-pyglet python-numpy python-scipy python-matplotlib

sudo add-apt-repository ppa:bqopensource/opencv
sudo apt-get update
sudo apt-get install python-opencv

sudo apt-get install avrdude

sudo apt-get install libftdi1

sudo apt-get install v4l-utils

In order to generate Debian and Windows packages, some extra dependencies are needed

sudo apt-get install build-essential pkg-config python-dev python-stdeb p7zip-full curl nsis

All source code is available on GitHub. You can download main Horus project by doing:

git clone https://github.com/bq/horus.git

or

git clone git@github.com:bq/horus.git

Several improvements and optimizations have been made in GNU/Linux version of OpenCV libraries. If you want to contribute to this custom version, you can download it from:

git clone https://github.com/bq/opencv.git

or

git clone git@github.com:bq/opencv.git

In the project directory, execute the command:

python src/horus.py

Horus development comes with a script "package.sh", this script has been designed to run under *nix OSes (Linux, MacOS). For Windows the package.sh script can be run from bash using git. The "package.sh" script generates a final release package. You should not need it during development, unless you are changing the release process. If you want to distribute your own version of Horus, then the package.sh script will allow you to do that.

bash package.sh debian     # Generate deb package
bash package.sh debian -s  # Generate sources
bash package.sh debian -i  # Install deb package
bash package.sh debian -u  # Upload to launchpad

bash package.sh win32  # Generate exe package

TODO

TODO