create_dl_layer_zoom_factorT_create_dl_layer_zoom_factorCreateDlLayerZoomFactorCreateDlLayerZoomFactorcreate_dl_layer_zoom_factor (Operator)

Name

create_dl_layer_zoom_factorT_create_dl_layer_zoom_factorCreateDlLayerZoomFactorCreateDlLayerZoomFactorcreate_dl_layer_zoom_factor — Create a zoom layer using a size factor.

Signature

create_dl_layer_zoom_factor( : : DLLayerInput, LayerName, ScaleWidth, ScaleHeight, Interpolation, AlignCorners, GenParamName, GenParamValue : DLLayerZoom)

Herror T_create_dl_layer_zoom_factor(const Htuple DLLayerInput, const Htuple LayerName, const Htuple ScaleWidth, const Htuple ScaleHeight, const Htuple Interpolation, const Htuple AlignCorners, const Htuple GenParamName, const Htuple GenParamValue, Htuple* DLLayerZoom)

void CreateDlLayerZoomFactor(const HTuple& DLLayerInput, const HTuple& LayerName, const HTuple& ScaleWidth, const HTuple& ScaleHeight, const HTuple& Interpolation, const HTuple& AlignCorners, const HTuple& GenParamName, const HTuple& GenParamValue, HTuple* DLLayerZoom)

HDlLayer HDlLayer::CreateDlLayerZoomFactor(const HString& LayerName, const HTuple& ScaleWidth, const HTuple& ScaleHeight, const HString& Interpolation, const HString& AlignCorners, const HTuple& GenParamName, const HTuple& GenParamValue) const

HDlLayer HDlLayer::CreateDlLayerZoomFactor(const HString& LayerName, double ScaleWidth, double ScaleHeight, const HString& Interpolation, const HString& AlignCorners, const HString& GenParamName, const HString& GenParamValue) const

HDlLayer HDlLayer::CreateDlLayerZoomFactor(const char* LayerName, double ScaleWidth, double ScaleHeight, const char* Interpolation, const char* AlignCorners, const char* GenParamName, const char* GenParamValue) const

HDlLayer HDlLayer::CreateDlLayerZoomFactor(const wchar_t* LayerName, double ScaleWidth, double ScaleHeight, const wchar_t* Interpolation, const wchar_t* AlignCorners, const wchar_t* GenParamName, const wchar_t* GenParamValue) const   (Windows only)

static void HOperatorSet.CreateDlLayerZoomFactor(HTuple DLLayerInput, HTuple layerName, HTuple scaleWidth, HTuple scaleHeight, HTuple interpolation, HTuple alignCorners, HTuple genParamName, HTuple genParamValue, out HTuple DLLayerZoom)

HDlLayer HDlLayer.CreateDlLayerZoomFactor(string layerName, HTuple scaleWidth, HTuple scaleHeight, string interpolation, string alignCorners, HTuple genParamName, HTuple genParamValue)

HDlLayer HDlLayer.CreateDlLayerZoomFactor(string layerName, double scaleWidth, double scaleHeight, string interpolation, string alignCorners, string genParamName, string genParamValue)

def create_dl_layer_zoom_factor(dllayer_input: HHandle, layer_name: str, scale_width: Union[int, float], scale_height: Union[int, float], interpolation: str, align_corners: str, gen_param_name: MaybeSequence[str], gen_param_value: MaybeSequence[Union[int, float, str]]) -> HHandle

Description

The operator create_dl_layer_zoom_factorcreate_dl_layer_zoom_factorCreateDlLayerZoomFactorCreateDlLayerZoomFactorCreateDlLayerZoomFactorcreate_dl_layer_zoom_factor creates a zoom layer using a size factor and returns the layer handle in DLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomdllayer_zoom.

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

The parameter LayerNameLayerNameLayerNameLayerNamelayerNamelayer_name sets an individual layer name. Note that if creating a model using create_dl_modelcreate_dl_modelCreateDlModelCreateDlModelCreateDlModelcreate_dl_model each layer of the created network must have an unique name.

The parameters ScaleWidthScaleWidthScaleWidthScaleWidthscaleWidthscale_width and ScaleHeightScaleHeightScaleHeightScaleHeightscaleHeightscale_height specify the ratio between the output and the corresponding input dimension. Together they define the output size of the zoom layer DLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomdllayer_zoom.

The parameter InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation defines the interpolation mode. Currently only 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" interpolation is supported.

The parameter AlignCornersAlignCornersAlignCornersAlignCornersalignCornersalign_corners defines how coordinates are transformed from the output to the input image:

'true'"true""true""true""true""true":

The transformation is applied on the HALCON Non-Standard Cartesian coordinate system (edge-centered, with the origin in the upper left corner, see chapter Transformations / 2D Transformations). Using the axis as an example, this leads to:

'false'"false""false""false""false""false":

The transformation is applied in the HALCON standard coordinate system (pixel centered, with the origin in the center of the upper left pixel, see chapter Transformations / 2D Transformations). Using the axis as an example, this leads to:

Note that this parameter applies only to InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear".

The following generic parameters GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name and the corresponding values GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value are supported:

'is_inference_output'"is_inference_output""is_inference_output""is_inference_output""is_inference_output""is_inference_output":

Determines whether apply_dl_modelapply_dl_modelApplyDlModelApplyDlModelApplyDlModelapply_dl_model will include the output of this layer in the dictionary DLResultBatchDLResultBatchDLResultBatchDLResultBatchDLResultBatchdlresult_batch even without specifying this layer in OutputsOutputsOutputsOutputsoutputsoutputs ('true'"true""true""true""true""true") or not ('false'"false""false""false""false""false").

Default: 'false'"false""false""false""false""false"

'num_trainable_params'"num_trainable_params""num_trainable_params""num_trainable_params""num_trainable_params""num_trainable_params":

Number of trainable parameters (weights and biases) of the layer.

Certain parameters of layers created using this operator create_dl_layer_zoom_factorcreate_dl_layer_zoom_factorCreateDlLayerZoomFactorCreateDlLayerZoomFactorCreateDlLayerZoomFactorcreate_dl_layer_zoom_factor can be set and retrieved using further operators. The following tables give an overview, which parameters can be set using set_dl_model_layer_paramset_dl_model_layer_paramSetDlModelLayerParamSetDlModelLayerParamSetDlModelLayerParamset_dl_model_layer_param and which ones can be retrieved using get_dl_model_layer_paramget_dl_model_layer_paramGetDlModelLayerParamGetDlModelLayerParamGetDlModelLayerParamget_dl_model_layer_param or get_dl_layer_paramget_dl_layer_paramGetDlLayerParamGetDlLayerParamGetDlLayerParamget_dl_layer_param. Note, the operators set_dl_model_layer_paramset_dl_model_layer_paramSetDlModelLayerParamSetDlModelLayerParamSetDlModelLayerParamset_dl_model_layer_param and get_dl_model_layer_paramget_dl_model_layer_paramGetDlModelLayerParamGetDlModelLayerParamGetDlModelLayerParamget_dl_model_layer_param require a model created by create_dl_modelcreate_dl_modelCreateDlModelCreateDlModelCreateDlModelcreate_dl_model.

Layer Parameters set get
'align_corners'"align_corners""align_corners""align_corners""align_corners""align_corners" (AlignCornersAlignCornersAlignCornersAlignCornersalignCornersalign_corners)
'input_layer'"input_layer""input_layer""input_layer""input_layer""input_layer" (DLLayerInputDLLayerInputDLLayerInputDLLayerInputDLLayerInputdllayer_input)
'interpolation_mode'"interpolation_mode""interpolation_mode""interpolation_mode""interpolation_mode""interpolation_mode" (InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation)
'name'"name""name""name""name""name" (LayerNameLayerNameLayerNameLayerNamelayerNamelayer_name)
'output_layer'"output_layer""output_layer""output_layer""output_layer""output_layer" (DLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomdllayer_zoom)
'scale_params'"scale_params""scale_params""scale_params""scale_params""scale_params" (ScaleWidthScaleWidthScaleWidthScaleWidthscaleWidthscale_width and ScaleHeightScaleHeightScaleHeightScaleHeightscaleHeightscale_height)
'shape'"shape""shape""shape""shape""shape"
'type'"type""type""type""type""type"
Generic Layer Parameters set get
'is_inference_output'"is_inference_output""is_inference_output""is_inference_output""is_inference_output""is_inference_output"
'num_trainable_params'"num_trainable_params""num_trainable_params""num_trainable_params""num_trainable_params""num_trainable_params"

Execution Information

Parameters

DLLayerInputDLLayerInputDLLayerInputDLLayerInputDLLayerInputdllayer_input (input_control)  dl_layer HDlLayer, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Feeding layer.

LayerNameLayerNameLayerNameLayerNamelayerNamelayer_name (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Name of the layer.

ScaleWidthScaleWidthScaleWidthScaleWidthscaleWidthscale_width (input_control)  number HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Ratio output/input width of the layer.

Default value: 2.0

ScaleHeightScaleHeightScaleHeightScaleHeightscaleHeightscale_height (input_control)  number HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Ratio output/input height of the layer.

Default value: 2.0

InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Mode of interpolation.

Default value: 'bilinear' "bilinear" "bilinear" "bilinear" "bilinear" "bilinear"

List of values: 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear"

AlignCornersAlignCornersAlignCornersAlignCornersalignCornersalign_corners (input_control)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Pixel alignment for interpolation.

Default value: 'false' "false" "false" "false" "false" "false"

List of values: 'false'"false""false""false""false""false", 'true'"true""true""true""true""true"

GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control)  attribute.name(-array) HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)

Generic input parameter names.

Default value: []

List of values: 'is_inference_output'"is_inference_output""is_inference_output""is_inference_output""is_inference_output""is_inference_output"

GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control)  attribute.value(-array) HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)

Generic input parameter values.

Default value: []

Suggested values: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false"

DLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomDLLayerZoomdllayer_zoom (output_control)  dl_layer HDlLayer, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Zoom layer.

Alternatives

create_dl_layer_zoom_sizecreate_dl_layer_zoom_sizeCreateDlLayerZoomSizeCreateDlLayerZoomSizeCreateDlLayerZoomSizecreate_dl_layer_zoom_size, create_dl_layer_zoom_to_layer_sizecreate_dl_layer_zoom_to_layer_sizeCreateDlLayerZoomToLayerSizeCreateDlLayerZoomToLayerSizeCreateDlLayerZoomToLayerSizecreate_dl_layer_zoom_to_layer_size

Module

Deep Learning Training