Home_v0.2

Overview - norama-suite 0.2

This software suite offers tools for numerical panoramas manipulation. Mostly designed for equirectangular mappings, its role is to provide an interface to libgnomonic and its algorithms. It then offers an interface to projection and transformation features implemented in the gnomonic library. Il also comes with a panorama viewer to complete the suite.

Presentation

Each tool of the norama-suite are presented here considering the problem it solves as its documentation framework. The following pages are related to gnomonic projections and their implemented inverses :

• norama-direct
• norama-invert

The following page documents the interface to mappings rotation transform :

• norama-rotate

Finally, the suite comes with a panorama viewer documented on the following page :

• norama-view

More information about frame and rotation matrix used in projection and transformation algorithms can be found in the libgnomonic documentation.

Development

The norama-suite current release is 0.2 (v0.2). The master branch contains the current beta version. Read the development logs for more information and documentation about the current state of the master branch.

Dependencies

The norama-suite comes with the following package (Ubuntu 14.04 LTS) dependencies :

• build-essential
• libx11-dev
• libgtk2.0-dev

and the following external dependencies :

• OpenCV 2.4.9 <OpenCV repository>

and the following provided sub-modules :

• libgnomonic 0.2.1 <libgnomonic repository>

• libinter 0.2 <libinter repository>

Documentation is built using doxygen.

Compilation

To clone the repository, use the command :

$ git clone https://github.com/FoxelSA/norama-suite.git --recursive
$ cd norama-suite
$ git checkout v0.2

To build the binaries using make, use the command :

$ make clean && make [OPENMP=false]

To install or uninstall the binaries on the local computer, use the command :

# make install
# make uninstall

To generate the documentation, use the command :

$ make documentation

When documentation is generated, the previous one is preliminary removed.