Solar
Public Member Functions | List of all members
SolAR::MODULES::OPENCV::SolARImageFilterWallisOpencv Class Reference

Apply a Wallis Filter to an image. UUID: 77113af0-4af2-4c45-92d4-fd1ea77b56cc More...

#include <SolARImageFilterWallisOpencv.h>

Inheritance diagram for SolAR::MODULES::OPENCV::SolARImageFilterWallisOpencv:
Inheritance graph
[legend]
Collaboration diagram for SolAR::MODULES::OPENCV::SolARImageFilterWallisOpencv:
Collaboration graph
[legend]

Public Member Functions

void unloadComponent () override final
 
org::bcom::xpcf::XPCFErrorCode onConfigured () override final
 
FrameworkReturnCode filter (const SRef< SolAR::datastructure::Image > input, SRef< SolAR::datastructure::Image > &output) override
 This method filters an image source to an image destination. More...
 

Detailed Description

Apply a Wallis Filter to an image. UUID: 77113af0-4af2-4c45-92d4-fd1ea77b56cc

Wallis filter is a local adaptive median filter, i.e., it adjusts pixel brightness values in local areas. In contrast, a global filters use the same contrast values throughout an entire image, and therefore can not enhance details in both high- and low-level-of-brightness areas simultaneously. The Wallis Formula implemented here is the following one:

\[ I_{j}^{(w)} (x,y) = \frac{desiredMean \: I_{j}^{(G)} (x,y)}{s+A} + B \: desiredStdDev + (1-B)m \]

where \(I_{j}^{(w)}\) is pre-processed output image, \(s\) is the local mean, and \(m\) is the local standard deviation. This local mean and local deviation are computed based on a window of size \(windowWidth\).

More information are available in: M. Gaiani, F. Remondino, F. I. Apollonio, and A. Ballabeni, “An advanced pre-processing pipeline to improve automated photogrammetric reconstructions of architectural scenes,” Remote sensing, vol. 8, no. 3, p. 178, 2016.

Properties
desiredMean
type: unsigned int; range : [0..MAX UINT]; default: 127
desiredStdDev
type: unsigned int; range : [0..MAX INT]; default: 60
A
type: float; range : [0..MAX FLOAT]; default: 2.1
B
type: float; range : [0..MAX FLOAT]; default: 0.7
windowWidth
type: unsigned int; range : [0..MAX UINT]; default: 14
denoisingMethod The denoising method applied before the wallis filter. Accepted values: None, GaussianBlur, or NonLocalMeans
type: string; default: "None"

Member Function Documentation

◆ filter()

FrameworkReturnCode SolAR::MODULES::OPENCV::SolARImageFilterWallisOpencv::filter ( const SRef< SolAR::datastructure::Image >  input,
SRef< SolAR::datastructure::Image > &  output 
)
override

This method filters an image source to an image destination.

Parameters
[in]inputinput image to filter
[out]outputoutput image filtred
Returns
FrameworkReturnCode::SUCCESS id filtering succeed, else FrameworkReturnCode::_ERROR.

The documentation for this class was generated from the following file: