python-aruco

SWIG generated Python wrappers for ArUco library. Works with OpenCV Python module cv2 resp. numpy array data types.

Tested on Linux Mint 19 x86_64, OpenCV 3.4.5, ArUco 3.0.13 Python 2.7.15 and NumPy 1.13.3

Installation via pip

Install / compile OpenCV >= 3.3.1 with Python2 support
run sudo -H pip install aruco

Installation Python2

Install / compile OpenCV >= 2.4.9 with Python2 support
Install swig3: sudo apt-get install swig3.0 for Debian/Ubuntu like systems
Install NumPy sudo pip install numpy (maybe you already need it for OpenCV Python support) or install via system packet manager
run ./swigbuild.sh: it compiles the shared library (_aruco.so) and generates Python wrappers (aruco.py)
run sudo python setup.py install to install the library globally

Installation Python3 (experimental)

Install / compile OpenCV >= 2.4.9 with Python3 support. Install-OpenCV script helps to install the latest version.
Install swig3: sudo apt-get install swig3.0 for Debian/Ubuntu like systems. On 14.04 and other older systems you will need to go to "Software Sources" and check backports in the Updates tab, and reload before installing.
Install NumPy sudo pip3 install numpy (maybe you already need it for OpenCV Python support) or install via system package manager.
run ./swigbuild.sh python3: it compiles the shared library (_aruco.so) and generates Python3 wrappers (aruco.py)
run sudo python3 setup.py install to install the library globally

Test

open a prompt in example/ and run: python ./example.py or python3 ./example.py for Python3 (depends on your default Python interpreter)

If the Python doesn't find some shared objects, add the library location to LD_LIBRARY_PATH: export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH

Problems