Deep Counting

List of Operators ↓

This chapter explains how to use Deep Counting.

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

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

1. Create a Deep Counting model by using

   • create_deep_counting_modelcreate_deep_counting_modelCreateDeepCountingModelCreateDeepCountingModelCreateDeepCountingModelcreate_deep_counting_model.

2. Query the available DL devices for inference by using

   • query_available_dl_devicesquery_available_dl_devicesQueryAvailableDlDevicesQueryAvailableDlDevicesQueryAvailableDlDevicesquery_available_dl_devices.

3. Set the model parameters, the used devices or augmentation parameters for the templates using

   • set_deep_counting_model_paramset_deep_counting_model_paramSetDeepCountingModelParamSetDeepCountingModelParamSetDeepCountingModelParamset_deep_counting_model_param.

4. 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_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model.

5. Prepare the model for the inference using

   • prepare_deep_counting_modelprepare_deep_counting_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_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_modelPrepareDeepCountingModelPrepareDeepCountingModelPrepareDeepCountingModelprepare_deep_counting_model must be called again, before the model can be applied with apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model.

6. Apply the model using the operator

   • apply_deep_counting_modelapply_deep_counting_modelApplyDeepCountingModelApplyDeepCountingModelApplyDeepCountingModelapply_deep_counting_model.

   The result will be saved in DeepCountingResultDeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_counting_result.

7. Visualize the Deep Counting results from DeepCountingResultDeepCountingResultDeepCountingResultDeepCountingResultdeepCountingResultdeep_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.