create_dl_layer_depth_maxCreateDlLayerDepthMaxCreateDlLayerDepthMaxcreate_dl_layer_depth_maxT_create_dl_layer_depth_max

HALCON ScriptCpp++.NETPythonC

Short description

create_dl_layer_depth_maxCreateDlLayerDepthMaxCreateDlLayerDepthMaxcreate_dl_layer_depth_maxT_create_dl_layer_depth_max — Create a depth max layer.

Signature

create_dl_layer_depth_max( dl_layer DLLayerInput, string LayerName, string DepthMaxMode, attribute.name GenParamName, attribute.value GenParamValue, out dl_layer DLLayerDepthMaxArg, out dl_layer DLLayerDepthMaxValue )void CreateDlLayerDepthMax( const HTuple& DLLayerInput, const HTuple& LayerName, const HTuple& DepthMaxMode, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* DLLayerDepthMaxArg, HTuple* DLLayerDepthMaxValue )static void HOperatorSet.CreateDlLayerDepthMax( HTuple DLLayerInput, HTuple layerName, HTuple depthMaxMode, HTuple genParamName, HTuple genParamValue, out HTuple DLLayerDepthMaxArg, out HTuple DLLayerDepthMaxValue )def create_dl_layer_depth_max( dllayer_input: HHandle, layer_name: str, depth_max_mode: str, gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[int, float, str]] ) -> Tuple[Sequence[HHandle], Sequence[HHandle]]

def create_dl_layer_depth_max_s( dllayer_input: HHandle, layer_name: str, depth_max_mode: str, gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[int, float, str]] ) -> Tuple[HHandle, HHandle]Herror T_create_dl_layer_depth_max( const Htuple DLLayerInput, const Htuple LayerName, const Htuple DepthMaxMode, const Htuple GenParamName, const Htuple GenParamValue, Htuple* DLLayerDepthMaxArg, Htuple* DLLayerDepthMaxValue )

HDlLayerArray HDlLayer::CreateDlLayerDepthMax( const HString& LayerName, const HString& DepthMaxMode, const HTuple& GenParamName, const HTuple& GenParamValue, HDlLayerArray* DLLayerDepthMaxValue ) const

HDlLayer HDlLayer::CreateDlLayerDepthMax( const HString& LayerName, const HString& DepthMaxMode, const HString& GenParamName, const HString& GenParamValue, HDlLayer* DLLayerDepthMaxValue ) const

HDlLayer HDlLayer::CreateDlLayerDepthMax( const char* LayerName, const char* DepthMaxMode, const char* GenParamName, const char* GenParamValue, HDlLayer* DLLayerDepthMaxValue ) const

HDlLayer HDlLayer::CreateDlLayerDepthMax( const wchar_t* LayerName, const wchar_t* DepthMaxMode, const wchar_t* GenParamName, const wchar_t* GenParamValue, HDlLayer* DLLayerDepthMaxValue ) const (Windows only)

HDlLayer[] HDlLayer.CreateDlLayerDepthMax( string layerName, string depthMaxMode, HTuple genParamName, HTuple genParamValue, out HDlLayer[] DLLayerDepthMaxValue )

HDlLayer HDlLayer.CreateDlLayerDepthMax( string layerName, string depthMaxMode, string genParamName, string genParamValue, out HDlLayer DLLayerDepthMaxValue )

Description

The operator create_dl_layer_depth_maxCreateDlLayerDepthMax creates a depth max layer.

The parameter DLLayerInputDLLayerInputdllayer_input determines the feeding input layer and expects the layer handle as value.

There are two possible output layers depending on DepthMaxModedepthMaxModedepth_max_mode:

• DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg: Handle to a depth max layer with mode 'argmax'"argmax".

• DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value: Handle to a depth max layer with mode 'value'"value".

Note, these parameters only need to be set in case such an output layer is requested (see DepthMaxModedepthMaxModedepth_max_mode).

The parameter LayerNamelayerNamelayer_name defines the name of the output layer(s) depending on DepthMaxModedepthMaxModedepth_max_mode:

• 'argmax'"argmax": name of DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg.

• 'value'"value": name of DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value.

• 'argmax_and_value'"argmax_and_value": name of DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg, while the layer DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value receives the same name with the suffix string '_value'"_value" appended to it.

Note that if creating a model using create_dl_modelCreateDlModel each layer of the created network must have a unique name.

The mode DepthMaxModedepthMaxModedepth_max_mode indicates which depth max value is actually returned as output. The following values are supported:

• 'argmax'"argmax": The depth index of the maximal value is returned in DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg.

• 'value'"value": The maximal value itself is returned in DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value.

• 'argmax_and_value'"argmax_and_value": Both are returned, the depth index of the maximal value in the output layer DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg, and the maximal value itself in the output layer DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value.

The following generic parameters GenParamNamegenParamNamegen_param_name and the corresponding values GenParamValuegenParamValuegen_param_value are supported:

• 'is_inference_output'"is_inference_output": Determines whether apply_dl_modelApplyDlModel will include the output of this layer in the dictionary DLResultBatchDLResultBatchdlresult_batch even without specifying this layer in Outputsoutputsoutputs ('true'"true") or not ('false'"false").

  Default: 'false'"false"

Certain parameters of layers created using this operator create_dl_layer_depth_maxCreateDlLayerDepthMax can be set and retrieved using further operators. The following tables give an overview, which parameters can be set using set_dl_model_layer_paramSetDlModelLayerParam and which ones can be retrieved using get_dl_model_layer_paramGetDlModelLayerParam or get_dl_layer_paramGetDlLayerParam. Note, the operators set_dl_model_layer_paramSetDlModelLayerParam and get_dl_model_layer_paramGetDlModelLayerParam require a model created by create_dl_modelCreateDlModel.

Layer Parameters	set	get
'input_layer'"input_layer" (DLLayerInputDLLayerInputdllayer_input)		x
'mode'"mode" (DepthMaxModedepthMaxModedepth_max_mode)	x	x
'name'"name" (LayerNamelayerNamelayer_name)	x	x
'output_layer'"output_layer" (DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg and/or DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value)		x
'shape'"shape"		x
'type'"type"		x

Generic Layer Parameters	set	get
'is_inference_output'"is_inference_output"		x
'num_trainable_params'"num_trainable_params"		x

Execution information

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

DLLayerInputDLLayerInputdllayer_input (input_control) dl_layer → (handle)HTuple (HHandle)HDlLayer, HTuple (IntPtr)HHandleHtuple (handle)

Feeding layer.

LayerNamelayerNamelayer_name (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Name of the output layer.

DepthMaxModedepthMaxModedepth_max_mode (input_control) string → (string)HTuple (HString)HTuple (string)strHtuple (char*)

Mode to indicate type of return value.

Default: 'argmax'"argmax"
List of values: 'argmax', 'argmax_and_value', 'value'"argmax", "argmax_and_value", "value"

GenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → (string)HTuple (HString)HTuple (string)MaybeSequence[str]Htuple (char*)

Generic input parameter names.

Default: [][]
List of values: 'is_inference_output'"is_inference_output"

GenParamValuegenParamValuegen_param_value (input_control) attribute.value(-array) → (string / integer / real)HTuple (HString / Hlong / double)HTuple (string / int / long / double)MaybeSequence[Union[int, float, str]]Htuple (char* / Hlong / double)

Generic input parameter values.

Default: [][]
Suggested values: 'true', 'false'"true", "false"

DLLayerDepthMaxArgDLLayerDepthMaxArgdllayer_depth_max_arg (output_control) dl_layer(-array) → (handle)HTuple (HHandle)HDlLayer, HTuple (IntPtr)Sequence[HHandle]Htuple (handle)

Optional, depth max layer with mode 'argmax'"argmax".

DLLayerDepthMaxValueDLLayerDepthMaxValuedllayer_depth_max_value (output_control) dl_layer(-array) → (handle)HTuple (HHandle)HDlLayer, HTuple (IntPtr)Sequence[HHandle]Htuple (handle)

Optional, depth max layer with mode 'value'"value".

Module

Deep Learning Professional