Home

Overview - norama-suite 0.3 (v0.3.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. The norama-suite is also interfaced with libcsps in order to take advantage of camera motion tracking to operate and align panoramas on earth. It 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 :

• Gnomonic projections - norama-direct - (v0.3)
• Inverted gnomonic projections - norama-invert - (v0.3)

Because the suite is interfaced with libcsps, it is able to take advantage of camera motion and orientation tracking. The following software computes panoramas that are aligned with earth local frame :

• Panorama earth alignment - norama-earth - (v0.3)

The following page documents the interface to mappings rotation transform :

• Equirectangular mapping rotation - norama-rotate - (v0.3)

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

• Panorama viewer - 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.3.2 (v0.3.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

the following external dependencies :

• OpenCV 2.4.9 <OpenCV repository>

and the following provided sub-modules :

• libgnomonic 0.4.1 <libgnomonic repository>

• libcsps 0.3 <libcsps repository>

• libinter 0.3 <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.3.2

To build sub-modules and binaries with make, use the command :

$ make clean-all && make [OPENMP=false]

To rebuild the binaries without rebuilding sub-modules :

$ make clean && make build [OPENMP=false]

To rebuild sub-modules only, use the command :

$ make clean-modules && make modules [OPENMP=false]

To generate the documentation, use the command :

$ make clean-documentation && make documentation

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

# make install
# make uninstall