Operator Reference
get_dl_classifier_param (Operator)
get_dl_classifier_param — Return the parameters of a deep-learning-based classifier.
Warning
get_dl_classifier_param is obsolete and is only provided for
reasons of backward compatibility.
The operator will be removed with HALCON 25.05.
New applications should use common
CNN-based operator get_dl_model_param instead.
Signature
get_dl_classifier_param( : : DLClassifierHandle, GenParamName : GenParamValue)
Description
get_dl_classifier_param returns the parameter values
GenParamValue of GenParamName of the neural
network DLClassifierHandle.
The hyperparameters and network parameters can be set with the operator
set_dl_classifier_param, in whose reference entry they are described
in detail. With get_dl_classifier_param you can query all these
values.
Additionally, there are parameters defined by the network which are read-only. These parameters are:
- 'image_range_min':
Minimum gray value.
- 'image_range_max':
-
Maximum gray value.
The precise values for these parameters and the default parameters for the
image dimension depend on the concrete network, see
read_dl_classifier.
Every image that is fed into the network must be present according to the
parameters defining the image properties.
To preprocess images accordingly, the procedure
preprocess_dl_classifier_images is available.
For an explanation of the concept of deep-learning-based classification see the introduction of chapter Deep Learning / Classification. The workflow involving this legacy operator is described in the chapter Legacy / DL Classification.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
DLClassifierHandle (input_control) dl_classifier → (handle)
Handle of the deep-learning-based classifier.
GenParamName (input_control) attribute.name(-array) → (string)
Name of the generic parameter.
Default: 'gpu'
List of values: 'batch_size', 'batch_size_multiplier', 'classes', 'gpu', 'image_dimensions', 'image_height', 'image_num_channels', 'image_range_max', 'image_range_min', 'image_width', 'learning_rate', 'momentum', 'runtime', 'runtime_init', 'weight_prior'
GenParamValue (output_control) attribute.name(-array) → (integer / string / real)
Value of the generic parameter.
Result
If the parameters are valid, the operator get_dl_classifier_param
returns the value 2 (
H_MSG_TRUE)
. If necessary, an exception is raised.
Possible Predecessors
read_dl_classifier,
set_dl_classifier_param
Possible Successors
train_dl_classifier_batch,
apply_dl_classifier
Alternatives
See also
Module
Deep Learning Enhanced