Segmentation's inspection results

Functions
eErrorType	SR_GetSegTestOutputMatrixSizeInfo (SegTestResult segTestResult, int *scoreMatrixChannel, int *scoreMatrixSize)
	Get the size of Score matrix. More...
eErrorType	SR_GetSegTestOutputMatrix (SegTestResult segTestResult, int scoreMatrixSize, unsigned char *scoreMatrixData)
	Get Score matrix. More...
eErrorType	SR_GetSegTestROI (SegTestResult segTestResult, int *xROI, int *yROI, int *wROI, int *hROI)
	Get ROI. More...
eErrorType	SR_GetSegTestNumberOfSegmentedObjects (SegTestResult segTestResult, int *numberOfSegmentedObjects)
	Get the number of SR_SegmentedObject. More...
eErrorType	SR_GetSegTestSegmentedObjects (SegTestResult segTestResult, SR_SegmentedObject *segmentedObjects)
	Get SR_SegmentedObject s. More...
eErrorType	SR_GetSegTestNumberOfDeletedObjects (SegTestResult segTestResult, int *numberOfDeletedObjects)
	Get the number of deleted SR_SegmentedObject s by filter process Segmentation's area threshold. More...
eErrorType	SR_GetSegTestDeletedObjects (SegTestResult segTestResult, SR_SegmentedObject *deletedObjects)
	Get deleted SR_SegmentedObject s by filter process Segmentation's area threshold. More...
eErrorType	SR_GetSegTestResultOriginalImageSize (SegTestResult segTestResult, int *width, int *height)
	Get the size of inspected image. More...
eErrorType	SR_GetSegTestInspectionTime (SegTestResult segTestResult, long *inspectionTimeInLong)
	Get the inspection time. More...
eErrorType	SR_GetSegTestInspectionTimeInDouble (SegTestResult segTestResult, double *inspectionTimeInDouble)
	Get the inspection time. More...
eErrorType	SR_GetSegTestLoadImageTime (SegTestResult segTestResult, long *imageLoadingTimeInLong)
	Get the image loading time. More...
eErrorType	SR_GetSegTestLoadImageTimeInDouble (SegTestResult segTestResult, double *imageLoadingTimeInDouble)
	Get the image loading time. More...

Detailed Description

Segmentation's inspection result consist of two outputs.

1. Score matrix
   • shape: # of classes x height x width
   • Score matrix[i_c * width * height + i_h * width + i_w] indicates the normalized probability(0-255) that pixel on i_w th column and i_h th row is classified to i_c class.
   • SR_GetSegTestOutputMatrixSizeInfo, SR_GetSegTestOutputMatrix
2. SR_SegmentedObject
   • each connected pixels are combined to one SR_SegmentedObject
   • we recommend to use SR_SegmentedObject to analyze inspection results rather than score matrix.
   • SR_GetSegTestNumberOfSegmentedObjects, SR_GetSegTestSegmentedObjects

// 1. Get Score Matrix 
int width, height;
int nChannel = 0;
int scoreMatrixSize = 0;
// Get matrix size
eErrorType error = SR_GetSegTestOutputMatrixSizeInfo(testResult, &nChannel, &scoreMatrixSize);
unsigned char* scoreMatrix = new unsigned char[scoreMatrixSize];
// Get matrix data
error = SR_GetSegTestOutputMatrix(testResult, scoreMatrixSize, scoreMatrix);
// check i_c th class score of pixel on i_w th column, i_h th row.
unsigned char score = scoreMatrix[i_c * width * height + i_h * width + i_w];
delete[] scoreMatrix;

// 2. Get Segmented Object
int numSegmentedObject = 0;
// Get number of objects
eErrorType error = SR_GetSegTestNumberOfSegmentedObjects(testResult, &numSegmentedObject);
SR_SegmentedObject* objects = new SR_SegmentedObject[numSegmentedObject];
// Get object data
error = SR_GetSegTestSegmentedObjects(testResult, objects);
delete[] SR_SegmentedObject;

Function Documentation

SR_GetSegTestDeletedObjects()

eErrorType SR_GetSegTestDeletedObjects	(	SegTestResult	segTestResult,
		SR_SegmentedObject *	deletedObjects
	)

Get deleted SR_SegmentedObject s by filter process Segmentation's area threshold.

Parameters

	segTestResult
[out]	deletedObjects

Warning

deletedObjects should be allocated by length of number of objects gathered by SR_GetSegTestNumberOfDeletedObjects.

Examples

ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestInspectionTime()

eErrorType SR_GetSegTestInspectionTime	(	SegTestResult	segTestResult,
		long *	inspectionTimeInLong
	)

Get the inspection time.

Parameters

	segTestResult
[out]	inspectionTimeInLong

Examples

ExampleSeg+ClsRuntime.cpp, ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, ExampleSegRuntimeSimple.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestInspectionTimeInDouble()

eErrorType SR_GetSegTestInspectionTimeInDouble	(	SegTestResult	segTestResult,
		double *	inspectionTimeInDouble
	)

Get the inspection time.

Parameters

	segTestResult
[out]	inspectionTimeInDouble

SR_GetSegTestLoadImageTime()

eErrorType SR_GetSegTestLoadImageTime	(	SegTestResult	segTestResult,
		long *	imageLoadingTimeInLong
	)

Get the image loading time.

Parameters

	segTestResult
[out]	imageLoadingTimeInLong

Examples

ExampleSeg+ClsRuntime.cpp, ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, ExampleSegRuntimeSimple.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestLoadImageTimeInDouble()

eErrorType SR_GetSegTestLoadImageTimeInDouble	(	SegTestResult	segTestResult,
		double *	imageLoadingTimeInDouble
	)

Get the image loading time.

Parameters

	segTestResult
[out]	imageLoadingTimeInDouble

SR_GetSegTestNumberOfDeletedObjects()

eErrorType SR_GetSegTestNumberOfDeletedObjects	(	SegTestResult	segTestResult,
		int *	numberOfDeletedObjects
	)

Get the number of deleted SR_SegmentedObject s by filter process Segmentation's area threshold.

Parameters

	segTestResult
[out]	numberOfDeletedObjects

Examples

ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestNumberOfSegmentedObjects()

eErrorType SR_GetSegTestNumberOfSegmentedObjects	(	SegTestResult	segTestResult,
		int *	numberOfSegmentedObjects
	)

Get the number of SR_SegmentedObject.

Parameters

	segTestResult
[out]	numberOfSegmentedObjects

Examples

ExampleSeg+ClsRuntime.cpp, ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, ExampleSegRuntimeSimple.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestOutputMatrix()

eErrorType SR_GetSegTestOutputMatrix	(	SegTestResult	segTestResult,
		int	scoreMatrixSize,
		unsigned char *	scoreMatrixData
	)

Get Score matrix.

Parameters

	segTestResult
	scoreMatrixSize
[out]	scoreMatrixData	memory address receiving score matrix. The length of memory must be equal to scoreMatrixSize

Examples

ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestOutputMatrixSizeInfo()

eErrorType SR_GetSegTestOutputMatrixSizeInfo	(	SegTestResult	segTestResult,
		int *	scoreMatrixChannel,
		int *	scoreMatrixSize
	)

Get the size of Score matrix.

matrixSize = matrixChannel x height x width.
matrixChannel = 1, for eSegTestOutputType::SR_ONE_CLASS_MATRIX_OUTPUT, eSegTestOutputType::SR_ONE_CLASS_CV_CONTOUR_OUTPUT.
matrixChannel = number of classes, for eSegTestOutputType::SR_MULTI_CLASS_MATRIX_OUTPUT, eSegTestOutputType::SR_MULTI_CLASS_CV_CONTOUR_OUTPUT.

Parameters

	segTestResult
[out]	scoreMatrixChannel
[out]	scoreMatrixSize

Examples

ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestResultOriginalImageSize()

eErrorType SR_GetSegTestResultOriginalImageSize	(	SegTestResult	segTestResult,
		int *	width,
		int *	height
	)

Get the size of inspected image.

Parameters

	segTestResult
[out]	width
[out]	height

Examples

ExampleSeg+ClsRuntime.cpp, ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeSimple.cpp, and ExampleSuperResolution+SegRuntime.cpp.

SR_GetSegTestROI()

eErrorType SR_GetSegTestROI	(	SegTestResult	segTestResult,
		int *	xROI,
		int *	yROI,
		int *	wROI,
		int *	hROI
	)

Get ROI.

Parameters

	segTestResult
[out]	xROI
[out]	yROI
[out]	wROI
[out]	hROI

SR_GetSegTestSegmentedObjects()

eErrorType SR_GetSegTestSegmentedObjects	(	SegTestResult	segTestResult,
		SR_SegmentedObject *	segmentedObjects
	)

Get SR_SegmentedObject s.

Parameters

	segTestResult
[out]	segmentedObjects

Warning

segmentedObjects should be allocated by length of number of objects gathered by SR_GetSegTestNumberOfSegmentedObjects.

Examples

ExampleSeg+ClsRuntime.cpp, ExampleSegPostProcess.cpp, ExampleSegRuntime.cpp, ExampleSegRuntimeBatchInspection.cpp, ExampleSegRuntimeMultiPage.cpp, ExampleSegRuntimeSimple.cpp, and ExampleSuperResolution+SegRuntime.cpp.