Horus

⚠️ Note: This forked version supports Python 3.* and orginal OpenCV library with a ready-to-use Python program!

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

This is a research project to explore the 3D laser scan with free tools. Feel free to use it for experiments, modify and adapt it to new devices and contribute new features or ideas.

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

Installation

Supported

Current version: 0.2rc1

Logo	Name	Instructions
	Ubuntu	[en] [es]
	Windows	[en] [es]
	Mac OS X	[en] [es]

Experimental

Horus 0.2 is not supported for the following distributions.

However, anyone can test it and contribute to its support.

Logo	Name	Instructions
	Debian	[en]
	Fedora	[en]

Documentation

Here you will find the official documentation of the application:

• User's manual [es]

And also all the scientific background of the project in nice Jupyter notebooks:

• Notebooks
• Repository

Development

Horus is an Open Source Project. Anyone has the freedom to use, modify, share and distribute this software. If you want to:

• run the source code
• make your own modifications
• contribute to the project
• build packages

follow the next instructions

GNU/Linux

Horus has been developed using Ubuntu Gnome, that is based on Debian, like Raspbian, Mint, etc. All instructions provided in this section probably work for most of these systems.

• Ubuntu development

NOTE: deb and exe packages can be generated in debian like systems

Mac OS X

• Darwin development

NOTE: dmg packages only can be generated in Mac OS X

More interest links are shown below:

• Presentation [es]
• 3D Design [es]
• Electronics [es]
• Firmware [es]
• Software [es]
• Product documentation [es]
• Google group

- Forked version notes -

In this forked version we have converted the Python 2.* scripts into Python 3.* counterpart using 2to3.

Further edits and fixes are performed for the compatibility of the package with the latest versions of the required libraries.

In detail, the current requirements are:

• wxpython==4.0.7.post2
• requests
• serial
• staty
• opencv-python
• pyopengl

All the requirements can be easily installed using the requirements.txt file, as

python -m pip install -r requirements.txt

⚠️ Windows Users: Installing standard PyOpenGL package you can fall in errors like

> PyOpenGL :: OpenGL.error.NullFunctionError: Attempt to call an undefined function glutInit, check for bool(glutInit) before calling

You can solve this kind of issue manually installing the library available at this link as suggested here

You can use the package without the installation of the setup, but launching directly the horus script at the root of the project.