Extensions and tweaks to APRIL Robotics Laboratory apriltag C software
Branch: master
Clone or download

README.md

apriltag

Small modifications/additions to http://april.eecs.umich.edu/media/apriltag/apriltag-2015-03-18.tgz

Added a new quad detector and a few various speedups.

Please note: I am not the maintainer of the pypi package listed at https://pypi.org/project/apriltag/ – GitHub issues filed here reporting problems with that package will be summarily closed. Sorry, I don't have time to support someone else's unofficial package.

Dependencies

  • OpenCV (optional)

Building

cd /path/to/apriltag
mkdir build
cd build
cmake .. -DCMAKE_BUILD_TYPE=Release
make -j4

If you want to install the library and important binaries to your system directories, you can then type

sudo make install

Running

You can run aprilag_opencv_demo to do stuff, run with -h to get help.

So for example, you can run

./apriltag_opencv_demo -B    ../images/mapping_feb_2014/*.JPG
./apriltag_opencv_demo -B -c ../images/mapping_feb_2014/*.JPG

to benchmark the new code against the old code.

Python

Note that you must build the software per the instructions above before the Python wrapper can be used. If you did not install the libraries to the system-wide library directory and you are not running Python code from the python directory in this repository, your Python code must specify the path for the apriltag shared library when constructing an apriltag.Detector object.

I recently added the ability to estimate 3D tag poses to the Python wrapper. To demonstrate this, after building the software, go to the python directory and run

python apriltag.py -c -k '(765.00, 764.18, 393.72, 304.66)' -s .127 ../images/mapping_feb_2014/*JPG

To estimate tag pose, you need to know the intrinsic camera parameters, which can be estimated using the calibrate_camera.py script.

You also need to know the tag size in order to scale the estimated translation vectors correctly.

Although this functionality is implmemented in the C library, it is not yet coded into the C/C++ demos; I may add it someday if requested.