ROIManager class Manages ROI masks and seed points for DIC analysis. More...

#include <roi_manager.h>

Static Public Member Functions
static cv::Mat	loadOrCreateROI (const BaseParameters &params, const cv::Mat &reference_image)
	Load or create ROI mask If ROI file doesn't exist, creates a full-image ROI Equivalent to checking and calling draw_ref_roi in Matlab.

static cv::Mat	loadROIFromMat (const std::string &roi_file)
	Load ROI mask from MAT file.

static SeedPoint	loadSeedFromMat (const std::string &seed_file)
	Load seed point from MAT file.

static SeedPoint	loadOrCreateSeed (const BaseParameters &params, const cv::Mat &roi_mask)
	Load or create seed point If seed file doesn't exist, creates a default seed point at ROI center.

static std::vector< int >	mapPixel2Subset (const std::vector< int > &pixel_coords, int subset_spacing)
	Map pixel coordinates to subset coordinates Equivalent to map_pixel2subset.m.

static std::vector< int >	mapSubset2Pixel (const std::vector< int > &subset_coords, int subset_spacing)
	Map subset coordinates to pixel coordinates Equivalent to map_subset2pixel.m.

static std::vector< int >	mapPointCoordinate (const std::vector< int > &point_sw, const cv::Mat &U_mapped, const cv::Mat &V_mapped)
	Map point coordinates using displacement fields Equivalent to map_pointcoordinate.m.

static bool	loadMatchingResults (const std::string &matching_file, cv::Mat &refmask_REF, cv::Mat &refmask_trial, cv::Mat &U_mapped, cv::Mat &V_mapped, int subset_spacing)
	Load matching results from MAT file Extracts ROI masks and displacement fields from matching file.

static cv::Mat	createFullROI (const cv::Size &image_size)
	Create default ROI mask (full image)

static std::vector< int >	findROICenter (const cv::Mat &roi_mask)
	Find center of ROI mask.

static cv::Mat	ncorrROIToMat (const ncorr::ROI2D &roi)
	Convert ncorr ROI2D to OpenCV Mat.

static ncorr::ROI2D	matToNcorrROI (const cv::Mat &mask)
	Convert OpenCV Mat to ncorr ROI2D.

Detailed Description

ROIManager class Manages ROI masks and seed points for DIC analysis.

Definition at line 22 of file roi_manager.h.

Member Function Documentation

◆ createFullROI()

cv::Mat cppxdic::ROIManager::createFullROI ( const cv::Size & image_size )

static

Create default ROI mask (full image)

Parameters

image_size Size of the image

Returns: Full ROI mask (all 255)

Definition at line 270 of file roi_manager.cpp.

◆ findROICenter()

std::vector< int > cppxdic::ROIManager::findROICenter ( const cv::Mat & roi_mask )

static

Find center of ROI mask.

Parameters

roi_mask ROI mask

Returns: Center coordinates [x, y]

Definition at line 276 of file roi_manager.cpp.

◆ loadMatchingResults()

bool cppxdic::ROIManager::loadMatchingResults	(	const std::string &	matching_file,
		cv::Mat &	refmask_REF,
		cv::Mat &	refmask_trial,
		cv::Mat &	U_mapped,
		cv::Mat &	V_mapped,
		int	subset_spacing
	)

static

Load matching results from MAT file Extracts ROI masks and displacement fields from matching file.

Parameters

matching_file	Path to matching MAT file
refmask_REF	Output: reference ROI mask
refmask_trial	Output: trial ROI mask
U_mapped	Output: U displacement field
V_mapped	Output: V displacement field

Returns: Success status

Definition at line 199 of file roi_manager.cpp.

◆ loadOrCreateROI()

cv::Mat cppxdic::ROIManager::loadOrCreateROI	(	const BaseParameters &	params,
		const cv::Mat &	reference_image
	)

static

Load or create ROI mask If ROI file doesn't exist, creates a full-image ROI Equivalent to checking and calling draw_ref_roi in Matlab.

Parameters

params	Base parameters containing file paths
reference_image	Reference image for ROI creation

Returns: ROI mask as cv::Mat (uint8, non-zero = inside ROI)

Definition at line 20 of file roi_manager.cpp.

◆ loadOrCreateSeed()

SeedPoint cppxdic::ROIManager::loadOrCreateSeed	(	const BaseParameters &	params,
		const cv::Mat &	roi_mask
	)

static

Load or create seed point If seed file doesn't exist, creates a default seed point at ROI center.

Parameters

params	Base parameters containing file paths
roi_mask	ROI mask

Returns: Seed point structure

Definition at line 132 of file roi_manager.cpp.

◆ loadROIFromMat()

cv::Mat cppxdic::ROIManager::loadROIFromMat ( const std::string & roi_file )

static

Load ROI mask from MAT file.

Parameters

roi_file Path to ROI MAT file

Returns: ROI mask

Definition at line 31 of file roi_manager.cpp.

◆ loadSeedFromMat()

SeedPoint cppxdic::ROIManager::loadSeedFromMat ( const std::string & seed_file )

static

Load seed point from MAT file.

Parameters

seed_file Path to seed MAT file

Returns: Seed point coordinates [x, y] in pixel world

Definition at line 81 of file roi_manager.cpp.

◆ mapPixel2Subset()

std::vector< int > cppxdic::ROIManager::mapPixel2Subset	(	const std::vector< int > &	pixel_coords,
		int	subset_spacing
	)

static

Map pixel coordinates to subset coordinates Equivalent to map_pixel2subset.m.

Parameters

pixel_coords	Pixel world coordinates [x, y]
subset_spacing	Subset spacing parameter

Returns: Subset world coordinates [x, y]

Definition at line 149 of file roi_manager.cpp.

◆ mapPointCoordinate()

std::vector< int > cppxdic::ROIManager::mapPointCoordinate	(	const std::vector< int > &	point_sw,
		const cv::Mat &	U_mapped,
		const cv::Mat &	V_mapped
	)

static

Map point coordinates using displacement fields Equivalent to map_pointcoordinate.m.

Parameters

point_sw	Point in subset world coordinates
U_mapped	U displacement field (normalized by subset_spacing+1)
V_mapped	V displacement field (normalized by subset_spacing+1)

Returns: Mapped point in subset world coordinates

Definition at line 170 of file roi_manager.cpp.

◆ mapSubset2Pixel()

std::vector< int > cppxdic::ROIManager::mapSubset2Pixel	(	const std::vector< int > &	subset_coords,
		int	subset_spacing
	)

static

Map subset coordinates to pixel coordinates Equivalent to map_subset2pixel.m.

Parameters

subset_coords	Subset world coordinates [x, y]
subset_spacing	Subset spacing parameter

Returns: Pixel world coordinates [x, y]

Definition at line 161 of file roi_manager.cpp.

◆ matToNcorrROI()

ncorr::ROI2D cppxdic::ROIManager::matToNcorrROI ( const cv::Mat & mask )

static

Convert OpenCV Mat to ncorr ROI2D.

Parameters

mask	OpenCV Mat mask

Returns: ncorr ROI2D object

Definition at line 297 of file roi_manager.cpp.

◆ ncorrROIToMat()

cv::Mat cppxdic::ROIManager::ncorrROIToMat ( const ncorr::ROI2D & roi )

static

Convert ncorr ROI2D to OpenCV Mat.

Parameters

roi	ncorr ROI2D object

Returns: OpenCV Mat representation

Definition at line 281 of file roi_manager.cpp.

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

include/roi_manager.h
src/roi_manager.cpp

Static Public Member Functions

Detailed Description

Member Function Documentation

◆ createFullROI()

◆ findROICenter()

◆ loadMatchingResults()

◆ loadOrCreateROI()

◆ loadOrCreateSeed()

◆ loadROIFromMat()

◆ loadSeedFromMat()

◆ mapPixel2Subset()

◆ mapPointCoordinate()

◆ mapSubset2Pixel()

◆ matToNcorrROI()

◆ ncorrROIToMat()