Operator Reference

Deep Counting

This chapter explains how to use Deep Counting.

Deep Counting is used to find objects in images and returns the number of objects.

A possible example for a Deep Counting application: Objects in an image are counted and the object quantity is returned.

Deep Counting uses user-defined templates to prepare a Deep Counting model. This model can be used to count objects that resemble the templates.

The general workflow is described in the following section.

General Workflow

This paragraph describes how to obtain the number from objects of a kind in images using a Deep Counting model. An application scenario can be seen in the HDevelop example deep_counting_workflow.hdev

Create a Deep Counting model by using
- create_deep_counting_modelcreate_deep_counting_modelCreateDeepCountingModelCreateDeepCountingModelcreate_deep_counting_model.
Query the available DL devices for inference by using
- query_available_dl_devicesquery_available_dl_devicesQueryAvailableDlDevicesQueryAvailableDlDevicesquery_available_dl_devices.
Set the model parameters, the used devices or augmentation parameters for the templates using
- set_deep_counting_model_paramset_deep_counting_model_paramSetDeepCountingModelParamSetDeepCountingModelParamset_deep_counting_model_param.
Draw templates for the preparation of the model. This can be done using the procedure
- draw_deep_counting_templates.
The drawn templates are needed for the operator prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model.
Prepare the model for the inference using
- prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model.
Note that when changing parameters that influence the template creation, or when other templates should be used, prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model must be called again, before the model can be applied with apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model.
Apply the model using the operator
- apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model.
The result will be saved in DeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_counting_result.
Visualize the Deep Counting results from DeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_counting_result using the procedure
- dev_display_deep_counting_results.

List of Operators

apply_deep_counting_modelApplyDeepCountingModelapply_deep_counting_modelApplyDeepCountingModelapply_deep_counting_model: Apply a Deep Counting model on a set of images for inference.

create_deep_counting_modelCreateDeepCountingModelcreate_deep_counting_modelCreateDeepCountingModelcreate_deep_counting_model: Create a Deep Counting model for counting objects.

get_deep_counting_model_paramGetDeepCountingModelParamget_deep_counting_model_paramGetDeepCountingModelParamget_deep_counting_model_param: Return the parameters of a Deep Counting model.

prepare_deep_counting_modelPrepareDeepCountingModelprepare_deep_counting_modelPrepareDeepCountingModelprepare_deep_counting_model: Set templates of a Deep Counting model.

read_deep_counting_modelReadDeepCountingModelread_deep_counting_modelReadDeepCountingModelread_deep_counting_model: Read a Deep Counting model from a file.

set_deep_counting_model_paramSetDeepCountingModelParamset_deep_counting_model_paramSetDeepCountingModelParamset_deep_counting_model_param: Set selected parameters of the Deep Counting model.

write_deep_counting_modelWriteDeepCountingModelwrite_deep_counting_modelWriteDeepCountingModelwrite_deep_counting_model: Write a Deep Counting model in a file.

Operators