Skip to content

Nico-Curti/horus

 
 

Repository files navigation

Horus

R&D License Documentation Status

⚠️ 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:

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

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.

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

Mac OS X

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

More interest links are shown below:

- 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.

About

3D Scanning multiplatform desktop application

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 83.7%
  • C 11.9%
  • Shell 3.1%
  • NSIS 0.8%
  • AppleScript 0.3%
  • Ruby 0.1%
  • Other 0.1%