alicevision / CCTag

Detection of CCTag markers made up of concentric circles.
https://cctag.readthedocs.io
Mozilla Public License 2.0
358 stars 89 forks source link
computer-vision concentric-circles detection fiducial-markers image-processing markers

CCTag library

CII Best Practices Codacy Badge

Detection of CCTag markers made up of concentric circles. Implementations in both CPU and GPU.

The library is the implementation of the paper:

If you want to cite this work in your publication, please use the following

@inproceedings{calvet2016Detection,
  TITLE = {{Detection and Accurate Localization of Circular Fiducials under Highly Challenging Conditions}},
  AUTHOR = {Calvet, Lilian and Gurdjos, Pierre and Griwodz, Carsten and Gasparini, Simone},
  BOOKTITLE = {{Proceedings of the 2016 IEEE Conference on Computer Vision and Pattern Recognition (CVPR)}},
  ADDRESS = {Las Vegas, United States},
  PAGES = {562 - 570},
  YEAR = {2016},
  MONTH = Jun,
  DOI = {10.1109/CVPR.2016.67}
}

Marker library

Markers to print are located here.

WARNING Please respect the provided margins. The reported detection rate and localization accuracy are valid with completely planar support: be careful not to use bent support (e.g. corrugated sheet of paper).

The four rings CCTags will be available soon.

CCTags requires either CUDA 8.0 and newer or CUDA 7.0 (CUDA 7.5 builds are known to have runtime errors on some devices including the GTX980Ti). The device must have at least compute capability 3.5.

Check your graphic card CUDA compatibility here.

Building

See INSTALL text file.

Continuous integration:

windows linux
master Build status Continuous Integration
develop Build status Continuous Integration

Running

Once compiled, you might want to run the CCTag detection on a sample image:

$ build/src/detection -n 3 -i sample/01.png

For the library interface, see ICCTag.hpp.

Documentation

The documentation can be found on the Read the Docs page

License

CCTag is licensed under MPL v2 license.

Authors

Lilian Calvet (CPU, lilian.calvet@gmail.com)
Carsten Griwodz (GPU, griff@simula.no)
Stian Vrba (CPU, vrba@mixedrealities.no)
Cyril Pichard (pih@mikrosimage.eu)
Simone Gasparini (simone.gasparini@gmail.com)

Acknowledgments

This has been developed in the context of the European project POPART founded by European Union’s Horizon 2020 research and innovation programme under grant agreement No 644874.

Additional contributions for performance optimizations have been funded by the Norwegian RCN FORNY2020 project FLEXCAM.