Skip to content
Library implementing Angular Randon Spectrum (ARS) and using it for estimation of rotation.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmake_modules
include/ars
src
CMakeLists.txt
README.md

README.md

ARS - Angular Radon Spectrum

Copyright (C) 2017 Dario Lodi Rizzini.

OVERVIEW

Library ars implements the Angular Radon Spectrum method for estimation of rotation. It has been kept to a minimal design.

If you use this library, please cite the following paper:

D. Lodi Rizzini. Angular Radon Spectrum for Rotation Estimation. Pattern Recognition, Volume 84, Dec. 2018, Pages 182-196, DOI 10.1016/j.patcog.2018.07.017.

  @article{lodirizzini2018pr,
    author={Lodi Rizzini, D.},
    title={{Angular Radon Spectrum for Rotation Estimation}}
    journal={Pattern Recognition},
    volume={84},
    pages={182--196},
    month={dec},
    year={2018},
    publisher={Elsevier},
    issn = {},
    doi = {10.1016/j.patcog.2018.07.017},
    note = {DOI 10.1016/j.patcog.2018.07.017, EID 2-s2.0-85050072081},
  }

or the most relevant associated publications by visiting: http://rimlab.ce.unipr.it/

DEPENDENCIES

The software depends on the following external libraries

  • Boost (submodule lexical_cast)
  • Eigen 3.0

Other dependencies are placed in directory thirdparty. Some examples require the external application "gnuplot" to display results.

HOW TO COMPILE

Let ${ars_ROOT} be the install directory of your local copy of library ars. The following standard commands are required to compile it:

  • cd ${ars_ROOT}
  • mkdir build
  • cd build
  • cmake ..
  • make

You can also install the library into a system directory. To change the install directory you must set cmake environment variable ${CMAKE_INSTALL_PREFIX} (e.g. using command "ccmake .." before calling "cmake .."). Its default value on UNIX-like/Linux systems is "/usr/local". After compiling library ars, run the command:

  • sudo make install

The command "sudo" is required only if ${CMAKE_INSTALL_PREFIX} is a system diretory managed by administrator user root. Such command copies:

  • header files of ${ars_ROOT}/include/ars to ${CMAKE_INSTALL_PREFIX}/include/ars/
  • library files ${ars_ROOT}/lib/libars.a to ${CMAKE_INSTALL_PREFIX}/lib/
  • cmake script ${ars_ROOT}/cmake_modules/arsConfig.cmake to ${CMAKE_INSTALL_PREFIX}/share/ars/

HOW TO USE LIBRARY ars IN YOUR PROJECT

If library ars has been installed in system directory "/usr/local", then it is straighforward to use it in your projects. You need to add the following lines to your project as in this example:

CMAKE_MINIMUM_REQUIRED(VERSION 2.8)
PROJECT(foobar)

find_package(ars REQUIRED)
message(STATUS "ars_FOUND ${ars_FOUND}")
message(STATUS "ars_INCLUDE_DIRS ${ars_INCLUDE_DIRS}")
message(STATUS "ars_LIBRARY_DIRS ${ars_LIBRARY_DIRS}")
message(STATUS "ars_LIBRARIES ${ars_LIBRARIES}")

if(${ars_FOUND})
include_directories(${ars_INCLUDE_DIRS})
link_directories(${ars_LIBRARY_DIRS})
endif()

add_executable(foobar foobar.cpp)
target_link_libraries(foobar ${ars_LIBRARIES})

The above example uses the variables defined in arsConfig.cmake:

  • ars_FOUND - system has ars module
  • ars_INCLUDE_DIRS - the ars include directories
  • ars_LIBRARY_DIRS - the ars library directories
  • ars_LIBRARIES - link these to use ars
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.