Convolution

The convolution primitive computes a forward, backward, or weight update for a batched convolution operation on 1D, 2D, or 3D spatial data with bias. More...

Functions
mkldnn_status_t MKLDNN_API	mkldnn_convolution_forward_desc_init (mkldnn_convolution_desc_t *conv_desc, mkldnn_prop_kind_t prop_kind, mkldnn_alg_kind_t alg_kind, const mkldnn_memory_desc_t *src_desc, const mkldnn_memory_desc_t *weights_desc, const mkldnn_memory_desc_t *bias_desc, const mkldnn_memory_desc_t *dst_desc, const mkldnn_dims_t strides, const mkldnn_dims_t padding_l, const mkldnn_dims_t padding_r)
	Initializes a convolution descriptor conv_desc for forward propagation using prop_kind (possible values are mkldnn_forward_training and mkldnn_forward_inference), alg_kind, memory descriptors, strides, padding_l, and padding_r. More...
mkldnn_status_t MKLDNN_API	mkldnn_dilated_convolution_forward_desc_init (mkldnn_convolution_desc_t *conv_desc, mkldnn_prop_kind_t prop_kind, mkldnn_alg_kind_t alg_kind, const mkldnn_memory_desc_t *src_desc, const mkldnn_memory_desc_t *weights_desc, const mkldnn_memory_desc_t *bias_desc, const mkldnn_memory_desc_t *dst_desc, const mkldnn_dims_t strides, const mkldnn_dims_t dilates, const mkldnn_dims_t padding_l, const mkldnn_dims_t padding_r)
	Initializes a dilated convolution descriptor conv_desc for forward propagation using prop_kind (possible values are mkldnn_forward_training and mkldnn_forward_inference), alg_kind, memory descriptors, strides, dilates, padding_l, and padding_r. More...
mkldnn_status_t MKLDNN_API	mkldnn_convolution_backward_data_desc_init (mkldnn_convolution_desc_t *conv_desc, mkldnn_alg_kind_t alg_kind, const mkldnn_memory_desc_t *diff_src_desc, const mkldnn_memory_desc_t *weights_desc, const mkldnn_memory_desc_t *diff_dst_desc, const mkldnn_dims_t strides, const mkldnn_dims_t padding_l, const mkldnn_dims_t padding_r)
	Initializes a convolution descriptor conv_desc for backward propagation with respect to data using alg_kind, memory descriptors, strides, padding_l, and padding_r. More...
mkldnn_status_t MKLDNN_API	mkldnn_dilated_convolution_backward_data_desc_init (mkldnn_convolution_desc_t *conv_desc, mkldnn_alg_kind_t alg_kind, const mkldnn_memory_desc_t *diff_src_desc, const mkldnn_memory_desc_t *weights_desc, const mkldnn_memory_desc_t *diff_dst_desc, const mkldnn_dims_t strides, const mkldnn_dims_t dilates, const mkldnn_dims_t padding_l, const mkldnn_dims_t padding_r)
	Initializes a dilated convolution descriptor conv_desc for backward propagation with respect to data using alg_kind, memory descriptors, strides, dilates padding_l, and padding_r. More...
mkldnn_status_t MKLDNN_API	mkldnn_convolution_backward_weights_desc_init (mkldnn_convolution_desc_t *conv_desc, mkldnn_alg_kind_t alg_kind, const mkldnn_memory_desc_t *src_desc, const mkldnn_memory_desc_t *diff_weights_desc, const mkldnn_memory_desc_t *diff_bias_desc, const mkldnn_memory_desc_t *diff_dst_desc, const mkldnn_dims_t strides, const mkldnn_dims_t padding_l, const mkldnn_dims_t padding_r)
	Initializes a convolution descriptor conv_desc for backward propagation with respect to weights using alg_kind, memory descriptors, strides, padding_l, and padding_r. More...
mkldnn_status_t MKLDNN_API	mkldnn_dilated_convolution_backward_weights_desc_init (mkldnn_convolution_desc_t *conv_desc, mkldnn_alg_kind_t alg_kind, const mkldnn_memory_desc_t *src_desc, const mkldnn_memory_desc_t *diff_weights_desc, const mkldnn_memory_desc_t *diff_bias_desc, const mkldnn_memory_desc_t *diff_dst_desc, const mkldnn_dims_t strides, const mkldnn_dims_t dilates, const mkldnn_dims_t padding_l, const mkldnn_dims_t padding_r)
	Initializes a convolution descriptor conv_desc for backward propagation with respect to weights using alg_kind, memory descriptors, strides, dilates padding_l, and padding_r. More...

Detailed Description

The convolution primitive computes a forward, backward, or weight update for a batched convolution operation on 1D, 2D, or 3D spatial data with bias.

See also

Convolution in developer guide

Convolution in C++ API

Function Documentation

mkldnn_convolution_forward_desc_init()

mkldnn_status_t MKLDNN_API mkldnn_convolution_forward_desc_init	(	mkldnn_convolution_desc_t *	conv_desc,
		mkldnn_prop_kind_t	prop_kind,
		mkldnn_alg_kind_t	alg_kind,
		const mkldnn_memory_desc_t *	src_desc,
		const mkldnn_memory_desc_t *	weights_desc,
		const mkldnn_memory_desc_t *	bias_desc,
		const mkldnn_memory_desc_t *	dst_desc,
		const mkldnn_dims_t	strides,
		const mkldnn_dims_t	padding_l,
		const mkldnn_dims_t	padding_r
	)

Initializes a convolution descriptor conv_desc for forward propagation using prop_kind (possible values are mkldnn_forward_training and mkldnn_forward_inference), alg_kind, memory descriptors, strides, padding_l, and padding_r.

In order to create a convolution without bias, bias_desc should either be NULL or point to a descriptor with memory format kind equal to mkldnn_format_kind_undef.

Note

If padding_r is NULL, the padding is supposed to be symmetric.

Memory descriptors are allowed to be initialized with mkldnn_format_kind_any value of format_kind.

Inputs:

• src (mkldnn_query_src_md, 0)
• weights (mkldnn_query_weights_md, 0)
• bias (mkldnn_query_weights_md, 1), if created with bias

Outputs:

• dst (mkldnn_query_dst_md, 0)

Examples:

cpu_cnn_inference_f32.c, and cpu_cnn_training_f32.c.

mkldnn_dilated_convolution_forward_desc_init()

mkldnn_status_t MKLDNN_API mkldnn_dilated_convolution_forward_desc_init	(	mkldnn_convolution_desc_t *	conv_desc,
		mkldnn_prop_kind_t	prop_kind,
		mkldnn_alg_kind_t	alg_kind,
		const mkldnn_memory_desc_t *	src_desc,
		const mkldnn_memory_desc_t *	weights_desc,
		const mkldnn_memory_desc_t *	bias_desc,
		const mkldnn_memory_desc_t *	dst_desc,
		const mkldnn_dims_t	strides,
		const mkldnn_dims_t	dilates,
		const mkldnn_dims_t	padding_l,
		const mkldnn_dims_t	padding_r
	)

Initializes a dilated convolution descriptor conv_desc for forward propagation using prop_kind (possible values are mkldnn_forward_training and mkldnn_forward_inference), alg_kind, memory descriptors, strides, dilates, padding_l, and padding_r.

In order to create a dilated convolution without bias, bias_desc should either be NULL or point to a descriptor with memory format kind equals mkldnn_format_kind_undef.

Note

If padding_r is NULL, the padding is supposed to be symmetric.

Memory descriptors are allowed to be initialized with mkldnn_format_kind_any value of format_kind.

Inputs:

• src (mkldnn_query_src_md, 0)
• weights (mkldnn_query_weights_md, 0)
• bias (mkldnn_query_weights_md, 1), if created with bias

Outputs:

• dst (mkldnn_query_dst_md, 0)

mkldnn_convolution_backward_data_desc_init()

mkldnn_status_t MKLDNN_API mkldnn_convolution_backward_data_desc_init	(	mkldnn_convolution_desc_t *	conv_desc,
		mkldnn_alg_kind_t	alg_kind,
		const mkldnn_memory_desc_t *	diff_src_desc,
		const mkldnn_memory_desc_t *	weights_desc,
		const mkldnn_memory_desc_t *	diff_dst_desc,
		const mkldnn_dims_t	strides,
		const mkldnn_dims_t	padding_l,
		const mkldnn_dims_t	padding_r
	)

Initializes a convolution descriptor conv_desc for backward propagation with respect to data using alg_kind, memory descriptors, strides, padding_l, and padding_r.

Note

Memory descriptors are allowed to be initialized with mkldnn_format_kind_any value of format_kind.

Inputs:

• diff_dst (mkldnn_query_diff_dst_md, 0)
• weights (mkldnn_query_weights_md, 0)

Outputs:

• diff_src (mkldnn_query_diff_src_md, 0)

mkldnn_dilated_convolution_backward_data_desc_init()

mkldnn_status_t MKLDNN_API mkldnn_dilated_convolution_backward_data_desc_init	(	mkldnn_convolution_desc_t *	conv_desc,
		mkldnn_alg_kind_t	alg_kind,
		const mkldnn_memory_desc_t *	diff_src_desc,
		const mkldnn_memory_desc_t *	weights_desc,
		const mkldnn_memory_desc_t *	diff_dst_desc,
		const mkldnn_dims_t	strides,
		const mkldnn_dims_t	dilates,
		const mkldnn_dims_t	padding_l,
		const mkldnn_dims_t	padding_r
	)

Initializes a dilated convolution descriptor conv_desc for backward propagation with respect to data using alg_kind, memory descriptors, strides, dilates padding_l, and padding_r.

Note

Memory descriptors are allowed to be initialized with mkldnn_format_kind_any value of format_kind.

Inputs:

• diff_dst (mkldnn_query_diff_dst_md, 0)
• weights (mkldnn_query_weights_md, 0)

Outputs:

• diff_src (mkldnn_query_diff_src_md, 0)

mkldnn_convolution_backward_weights_desc_init()

mkldnn_status_t MKLDNN_API mkldnn_convolution_backward_weights_desc_init	(	mkldnn_convolution_desc_t *	conv_desc,
		mkldnn_alg_kind_t	alg_kind,
		const mkldnn_memory_desc_t *	src_desc,
		const mkldnn_memory_desc_t *	diff_weights_desc,
		const mkldnn_memory_desc_t *	diff_bias_desc,
		const mkldnn_memory_desc_t *	diff_dst_desc,
		const mkldnn_dims_t	strides,
		const mkldnn_dims_t	padding_l,
		const mkldnn_dims_t	padding_r
	)

Initializes a convolution descriptor conv_desc for backward propagation with respect to weights using alg_kind, memory descriptors, strides, padding_l, and padding_r.

Note

Memory descriptors are allowed to be initialized with mkldnn_format_kind_any value of format_kind.

Inputs:

• src (mkldnn_query_src_md, 0)
• diff_dst (mkldnn_query_diff_dst_md, 0)

Outputs:

• diff_weights (mkldnn_query_diff_weights_md, 0)
• diff_bias (mkldnn_query_diff_weights_md, 1), if created with bias

Examples:

cpu_cnn_training_f32.c.

mkldnn_dilated_convolution_backward_weights_desc_init()

mkldnn_status_t MKLDNN_API mkldnn_dilated_convolution_backward_weights_desc_init	(	mkldnn_convolution_desc_t *	conv_desc,
		mkldnn_alg_kind_t	alg_kind,
		const mkldnn_memory_desc_t *	src_desc,
		const mkldnn_memory_desc_t *	diff_weights_desc,
		const mkldnn_memory_desc_t *	diff_bias_desc,
		const mkldnn_memory_desc_t *	diff_dst_desc,
		const mkldnn_dims_t	strides,
		const mkldnn_dims_t	dilates,
		const mkldnn_dims_t	padding_l,
		const mkldnn_dims_t	padding_r
	)

Initializes a convolution descriptor conv_desc for backward propagation with respect to weights using alg_kind, memory descriptors, strides, dilates padding_l, and padding_r.

Note

Memory descriptors are allowed to be initialized with mkldnn_format_kind_any value of format_kind.

Inputs:

• src (mkldnn_query_src_md, 0)
• diff_dst (mkldnn_query_diff_dst_md, 0)

Outputs:

• diff_weights (mkldnn_query_diff_weights_md, 0)
• diff_bias (mkldnn_query_diff_weights_md, 1), if created with bias