sb_t_res Struct Reference

Results of detection. More...

#include <sb.h>

Collaboration diagram for sb_t_res:

Data Fields
int	is_valid
	It is 1 when the fields of the structure are valid, otherwise it is 0. More...
sb_t_par	par
	Project parameters. More...
sb_t_samples	samples
	Samples found in the image. More...
sb_t_ocr_res	ocr
	Result of OCR analysis. More...
sb_t_res_model	global
	Global results. More...
sb_t_res_models	models
	Models results. More...
int	img_width_circular
	Original width of the image, before the extension in the x-axis. More...
long long	time_us
	Elaboration time of the image, in us. More...
sb_t_devices_par	devices
	The devices used to compute the current results.
sb_t_tiles_info *	tiles
	Information about the tiles used to process the image. More...
sb_t_err	err
	Error of last image processing with sb_project_detection function . More...

Detailed Description

Results of detection.

The results are different depending on the project type:

• Retina project: the results consist in the samples list, see Retina results .
• Surface project: the results consist in the voting plane, see Surface/Deep Surface results .

With Surface projects note that:

• If the sb_project_get_res function is called with the details parameter equal to zero then sb_t_res.global.surface is allocated while sb_t_res_models.model[i].surface structures of the models are not allocated;
• If the sb_project_detection function is not passed a defect roi, i.e. the ground truth, the sb_t_surface_res::truth images of the sb_t_res::global field and those of the sb_t_res::models are not allocated;
• The sb_t_res.models.model[i].surface.model image is also allocated for individual models.
  In this case each pixel has the index of the model where the weight is greater than or equal to 0 otherwise 0;
• For disabled models:
  • sb_t_res.models.model[i].surface is NULL
  • all the counters tp, tn, fp, fn, op, on, out_of_roi, disabled are set to 0
• If an empty analysis ROI is passed to the sb_project_detection function sb_t_res.global.surface and sb_t_res.models.model[i].surface are allocated, the images sb_t_surface_res::weight, sb_t_surface_res::model, sb_t_surface_res::truth (only if ground truth is present, i.e. the defect roi) and sb_t_surface_res::blobs are allocated with a null dimension, sb_t_res.global.tn is set to 1, while sb_t_res.models.model[i].tn are set to 0;
• sb_t_res.global.surface.blobs is allocated if the sb_project_detection function is called with a defect roi, i.e. the ground truth, or if the parameter sb_t_par::surface_blob_analysis is set to 1;
• sb_t_res.models.model[i].surface.blobs is allocated if the parameter details is set to 1 and if the sb_project_detection function is called with a defect roi, i.e. the ground truth, or if the parameter sb_t_par::surface_blob_analysis is set to 1.

The structure is managed as a visible handle. To destroy the structure you must call the function sb_res_destroy .

Warning

When you get the structure from projects with version less than 1.7.0.2, the structure par is not completely filled.
Only the following fields are correctly filled:

• sb_t_par.models.size
• sb_t_par.models.model[i].obj_size
• sb_t_par.models.model[i].enabled
• sb_t_par.models.model[i].obj_size
• sb_t_par.models.model[i].name
• sb_t_par.models.model[i].color, only for Surface project
• sb_t_par.models.model[i].color_opt, only for Surface project

See also

sb_project_detection

sb_project_get_res

sb_res_destroy

sb_t_par

Definition at line 11275 of file sb.h.

Field Documentation

err

sb_t_err sb_t_res::err

Error of last image processing with sb_project_detection function .

If the value is different than SB_ERR_NONE all the other parameters of the structure sb_t_res are not to be considered valid with the exception of sb_t_res::is_valid and sb_t_res::par which are valid.

Definition at line 11349 of file sb.h.

global

sb_t_res_model sb_t_res::global

Global results.

In case of more than one model this structure contains the information of all model together. In case of Surface, this means that in each pixel of the images sb_t_surface_res::weight and sb_t_surface_res::model the model with the maximum weight has been choosen.

Definition at line 11310 of file sb.h.

img_width_circular

int sb_t_res::img_width_circular

Original width of the image, before the extension in the x-axis.

If the value is greater than 0 it means that the image has a circular x-axis and it was extended in order to find the samples which stands a bit on the end and a little on the start.

Definition at line 11323 of file sb.h.

is_valid

int sb_t_res::is_valid

It is 1 when the fields of the structure are valid, otherwise it is 0.

I.e. the parameter is 1 if almost one elaboration is done.

Attention

The value is set to 1 even if only the sb_t_res::err parameter is set to a value other than SB_ERR_NONE . In this case all the other parameters of the structure are not to be considered valid.

Definition at line 11283 of file sb.h.

models

sb_t_res_models sb_t_res::models

Models results.

Used only with Surface and Deep Surface projects.

Definition at line 11316 of file sb.h.

ocr

sb_t_ocr_res sb_t_res::ocr

Result of OCR analysis.

Used only with Retina projects.

Definition at line 11302 of file sb.h.

par

sb_t_par sb_t_res::par

Project parameters.

It is valorized with the parameters saved in the project handle when the sb_project_detection function was last called.

Definition at line 11289 of file sb.h.

samples

sb_t_samples sb_t_res::samples

Samples found in the image.

It has samples.size of sb_t_sample elements.
Used only with Retina and Deep Cortex projects.

Definition at line 11296 of file sb.h.

tiles

sb_t_tiles_info* sb_t_res::tiles

Information about the tiles used to process the image.

It is used only for Deep Surface projects.

Warning

The field is allocated only for Deep Surface projects and is set to NULL for all other project types.

Definition at line 11342 of file sb.h.

time_us

long long sb_t_res::time_us

Elaboration time of the image, in us.

Includes the sb_project_detection and sb_project_get_res time.

Definition at line 11329 of file sb.h.

---

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

• sb.h