Struct opencv::optflow::RLOFOpticalFlowParameter

pub struct RLOFOpticalFlowParameter { /* private fields */ }

This is used store and set up the parameters of the robust local optical flow (RLOF) algoritm.

The RLOF is a fast local optical flow approach described in Senst2012 Senst2013 Senst2014 and Senst2016 similar to the pyramidal iterative Lucas-Kanade method as proposed by Bouguet00. More details and experiments can be found in the following thesis Senst2019. The implementation is derived from optflow::calcOpticalFlowPyrLK(). This RLOF implementation can be seen as an improved pyramidal iterative Lucas-Kanade and includes a set of improving modules. The main improvements in respect to the pyramidal iterative Lucas-Kanade are:

• A more robust redecending M-estimator framework (see Senst2012) to improve the accuracy at motion boundaries and appearing and disappearing pixels.
• an adaptive support region strategies to improve the accuracy at motion boundaries to reduce the corona effect, i.e oversmoothing of the PLK at motion/object boundaries. The cross-based segementation strategy (SR_CROSS) proposed in Senst2014 uses a simple segmenation approach to obtain the optimal shape of the support region.
• To deal with illumination changes (outdoor sequences and shadow) the intensity constancy assumption based optical flow equation has been adopt with the Gennert and Negahdaripour illumination model (see Senst2016). This model can be switched on/off with the useIlluminationModel variable.
• By using a global motion prior initialization (see Senst2016) of the iterative refinement the accuracy could be significantly improved for large displacements. This initialization can be switched on and of with useGlobalMotionPrior variable.

The RLOF can be computed with the SparseOpticalFlow class or function interface to track a set of features or with the DenseOpticalFlow class or function interface to compute dense optical flow.

See also

optflow::DenseRLOFOpticalFlow, optflow::calcOpticalFlowDenseRLOF(), optflow::SparseRLOFOpticalFlow, optflow::calcOpticalFlowSparseRLOF()

Implementations

impl RLOFOpticalFlowParameter

pub fn default() -> Result<RLOFOpticalFlowParameter>

pub fn create() -> Result<Ptr<RLOFOpticalFlowParameter>>

Creates instance of optflow::RLOFOpticalFlowParameter

Trait Implementations

impl Boxed for RLOFOpticalFlowParameter

unsafe fn from_raw(ptr: *mut c_void) -> Self

Wrap the specified raw pointer

fn into_raw(self) -> *mut c_void

Return an the underlying raw pointer while consuming this wrapper.

fn as_raw(&self) -> *const c_void

Return the underlying raw pointer.

fn as_raw_mut(&mut self) -> *mut c_void

Return the underlying mutable raw pointer

impl Debug for RLOFOpticalFlowParameter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for RLOFOpticalFlowParameter

fn drop(&mut self)

Executes the destructor for this type.

impl RLOFOpticalFlowParameterTrait for RLOFOpticalFlowParameter

fn as_raw_mut_RLOFOpticalFlowParameter(&mut self) -> *mut c_void

fn set_solver_type(&mut self, val: SolverType)

fn set_support_region_type(&mut self, val: SupportRegionType)

fn set_norm_sigma0(&mut self, val: f32)

fn set_norm_sigma1(&mut self, val: f32)

fn set_small_win_size(&mut self, val: i32)

fn set_large_win_size(&mut self, val: i32)

fn set_cross_segmentation_threshold(&mut self, val: i32)

fn set_max_level(&mut self, val: i32)

fn set_use_initial_flow(&mut self, val: bool)

fn set_use_illumination_model(&mut self, val: bool)

fn set_use_global_motion_prior(&mut self, val: bool)

fn set_max_iteration(&mut self, val: i32)

fn set_min_eigen_value(&mut self, val: f32)

fn set_global_motion_ransac_threshold(&mut self, val: f32)

fn set_use_m_estimator(&mut self, val: bool) -> Result<()>

Enable M-estimator or disable and use least-square estimator. Enables M-estimator by setting sigma parameters to (3.2, 7.0). Disabling M-estimator can reduce * runtime, while enabling can improve the accuracy.

fn set_solver_type_1(&mut self, val: SolverType) -> Result<()>

fn set_support_region_type_1(&mut self, val: SupportRegionType) -> Result<()>

fn set_norm_sigma0_1(&mut self, val: f32) -> Result<()>

fn set_norm_sigma1_1(&mut self, val: f32) -> Result<()>

fn set_small_win_size_1(&mut self, val: i32) -> Result<()>

fn set_large_win_size_1(&mut self, val: i32) -> Result<()>

fn set_cross_segmentation_threshold_1(&mut self, val: i32) -> Result<()>

fn set_max_level_1(&mut self, val: i32) -> Result<()>

fn set_use_initial_flow_1(&mut self, val: bool) -> Result<()>

fn set_use_illumination_model_1(&mut self, val: bool) -> Result<()>

fn set_use_global_motion_prior_1(&mut self, val: bool) -> Result<()>

fn set_max_iteration_1(&mut self, val: i32) -> Result<()>

fn set_min_eigen_value_1(&mut self, val: f32) -> Result<()>

fn set_global_motion_ransac_threshold_1(&mut self, val: f32) -> Result<()>

impl RLOFOpticalFlowParameterTraitConst for RLOFOpticalFlowParameter

fn as_raw_RLOFOpticalFlowParameter(&self) -> *const c_void

fn solver_type(&self) -> SolverType

fn support_region_type(&self) -> SupportRegionType

fn norm_sigma0(&self) -> f32

fn norm_sigma1(&self) -> f32

fn small_win_size(&self) -> i32

fn large_win_size(&self) -> i32

fn cross_segmentation_threshold(&self) -> i32

fn max_level(&self) -> i32

fn use_initial_flow(&self) -> bool

fn use_illumination_model(&self) -> bool

fn use_global_motion_prior(&self) -> bool

fn max_iteration(&self) -> i32

fn min_eigen_value(&self) -> f32

fn global_motion_ransac_threshold(&self) -> f32

fn get_solver_type(&self) -> Result<SolverType>

fn get_support_region_type(&self) -> Result<SupportRegionType>

fn get_norm_sigma0(&self) -> Result<f32>

fn get_norm_sigma1(&self) -> Result<f32>

fn get_small_win_size(&self) -> Result<i32>

fn get_large_win_size(&self) -> Result<i32>

fn get_cross_segmentation_threshold(&self) -> Result<i32>

fn get_max_level(&self) -> Result<i32>

fn get_use_initial_flow(&self) -> Result<bool>

fn get_use_illumination_model(&self) -> Result<bool>

fn get_use_global_motion_prior(&self) -> Result<bool>

fn get_max_iteration(&self) -> Result<i32>

fn get_min_eigen_value(&self) -> Result<f32>

fn get_global_motion_ransac_threshold(&self) -> Result<f32>

impl Send for RLOFOpticalFlowParameter