Home

Standard Refinement Modules
Kernel modules - srm-kernel 0.4.2

The standard refinement modules (SRM) are responsible of data processing engaged in the standard data storage structure. In this way, they are also responsible of maintaining the storage structure through the management of the processed data.

The standard refinement modules are designated as standard in the way the data processing interface they offer is identical from a module to another, providing a simple and standardised front-end to data processing and storage management.

This repository contains the kernel standard refinement module. The kernel modules are responsible of the most fundamental processing steps of the data coming out of the digitising devices. In other word, they offer a data processing interface that allows to obtain most important and fundamental refined data that can be used by external modules to produce more refined and complex results.

Presentation

The srm-modules, being part of the kernel or not, offer a standardised interface for data refinement processing. This standardisation is deeply linked to the standardisation of the data storage structure. The following page gives the description of the modules standard interface :

• [Module standard interface](Standard interface_v0.4)

Two major type of refinement module are offered : pose modules and cluster modules. Pose modules are used to refine pose producing refined data at the level of the pose, the results still being considered as poses. Cluster modules consider more than one pose as source data to produce more complicated results that becomes a refinement of a collection of poses. The following pages give the documentation of each implemented kernel pose srm-module explaining all their specificities :

• Elphel injection module - srm-elphel
• Raw to equirectangular tile module - srm-raw-eqrtile
• Raw to rectilinear tile module - srm-raw-rectile
• Rectilinear to equirectangular tile module - srm-rectile-eqrtile
• Equirectangular tile to rectilinear - srm-eqrtile-rectile
• Equirectangular tile to panorama - srm-eqrtile-panorama
• Panorama to panorama - srm-panorama-panorama

The following pages give the documentation of each implemented kernel cluster srm-module :

• Panorama to HDR panorama - srm-panorama-hdrpanorama
• Rectilinear to point cloud - srm-rectile-cloud

Being central in the module standard interface and linked to the standardised data storage structure, the MMSR addresses standardisation is described on the following page :

• [MMSR address standard](MMSR address_v0.4)

Development

The srm-kernel current release is 0.4.2 (v0.4.2). The master branch contains the state of the current beta version. Read the development logs for more information and documentation about the current state of the master branch.

Dependencies

The srm-kernel has been validated under Ubuntu 14.04 LTS and comes with the following package dependencies :

• bash
• coreutils
• parallel
• enblend
• enfuse
• dcraw
• imagemagick
• rsync
• exiv2
• libtiff-tools

The srm-kernel comes also with the following external dependencies :

• Fiji/ImageJ <Official site> - [Specific instructions](ImageJ-Elphel instruction_v0.4)
• imagej-elphel <Github repository> - [Specific instructions](ImageJ-Elphel instruction_v0.4)
• norama-suite 0.3.1 <Github repository>
• Movie2DNG <Github repository>
• openMVG
• openMVS

that have to be installed following their own documentation.

Compilation

To clone the repository, use the command :

$ git clone https://github.com/FoxelSA/srm-kernel.git
$ cd srm-kernel
$ git checkout v0.4.2

To build the binaries directory using make, use the command :

$ make clean && make

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

# make install
# make uninstall