tools/generate-transpose-test.py - platform/external/XNNPACK - Git at Google

 #!/usr/bin/env python
 # Copyright 2021 Google LLC
 #
 # This source code is licensed under the BSD-style license found in the
 # LICENSE file in the root directory of this source tree.

 import argparse
 import codecs
 import math
 import os
 import re
 import sys
 import yaml

 sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
 import xngen
 import xnncommon

 parser = argparse.ArgumentParser(
     description="Matrix transpose microkernel test generator")
 parser.add_argument(
     "-s",
     "--spec",
     metavar="FILE",
     required=True,
     help="Specification (YAML) file")
 parser.add_argument(
     "-o",
     "--output",
     metavar="FILE",
     required=True,
     help="Output (C++ source) file")
 parser.set_defaults(defines=list())


 def split_ukernel_name(name):
   match = re.fullmatch(r"xnn_x(.+)_transpose(v|c)_ukernel__(\d+)x(\d+)_(.+)", name)
   if match is None:
     raise ValueError("Unexpected microkernel name: " + name)
   if match.group(1) == 'x':
     element_size = None
   else:
     element_size = int(int(match.group(1)) / 8)
   tile_height = int(match.group(3))
   tile_width = int(match.group(4))

   arch, isa = xnncommon.parse_target_name(target_name=match.group(5))
   return tile_height, tile_width, element_size, arch, isa


 TRANSPOSE_TEST_TEMPLATE = """\
 TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 2})
     .output_stride(${TILE_HEIGHT * 2})
     .block_width(${TILE_WIDTH})
     .block_height(${TILE_HEIGHT})
     .element_size(${ELEMENT_SIZE})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_1_${TILE_HEIGHT * 2}_bw_1_${TILE_WIDTH * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   for(size_t i = 1; i <= ${TILE_HEIGHT * 2}; ++i){
     for(size_t j = 1; j <= ${TILE_WIDTH * 2}; ++j){
       TransposeMicrokernelTester()
         .input_stride(j * 3)
         .output_stride(i * 7)
         .block_width(j)
         .block_height(i)
         .element_size(${ELEMENT_SIZE})
         .iterations(1)
         .Test(${KERNEL});
     }
   }
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 2})
     .output_stride(${TILE_HEIGHT})
     .block_width(${TILE_WIDTH * 2})
     .block_height(${TILE_HEIGHT})
     .element_size(${ELEMENT_SIZE})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH + 1}_${TILE_WIDTH * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   for(size_t i = ${TILE_WIDTH + 1}; i < ${TILE_WIDTH * 2}; ++i){
     TransposeMicrokernelTester()
       .input_stride(i)
       .output_stride(${TILE_HEIGHT * 2})
       .block_width(i)
       .block_height(${TILE_HEIGHT})
       .element_size(${ELEMENT_SIZE})
       .iterations(1)
       .Test(${KERNEL});
   }
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH + 1}_${TILE_WIDTH * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   for(size_t i = ${TILE_WIDTH + 1}; i < ${TILE_WIDTH * 2}; ++i){
     TransposeMicrokernelTester()
       .input_stride(i)
       .output_stride(${TILE_HEIGHT * 2})
       .block_width(i)
       .block_height(${TILE_HEIGHT * 2})
       .element_size(${ELEMENT_SIZE})
       .iterations(1)
       .Test(${KERNEL});
   }
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH})
     .output_stride(${TILE_HEIGHT * 3 + 4})
     .block_width(${TILE_WIDTH})
     .block_height(${TILE_HEIGHT * 2})
     .element_size(${ELEMENT_SIZE})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT + 1}_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH}){
   $if ISA_CHECK:
     ${ISA_CHECK};
   for(size_t i = ${TILE_HEIGHT + 1}; i < ${TILE_HEIGHT * 2}; ++i){
     TransposeMicrokernelTester()
       .input_stride(${TILE_WIDTH + 17})
       .output_stride(i)
       .block_width(${TILE_WIDTH + 3})
       .block_height(i)
       .element_size(${ELEMENT_SIZE})
       .iterations(1)
       .Test(${KERNEL});
   }
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT + 1}_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH * 2}){
   $if ISA_CHECK:
     ${ISA_CHECK};
   for(size_t i = ${TILE_HEIGHT + 1}; i < ${TILE_HEIGHT * 2}; ++i){
     TransposeMicrokernelTester()
       .input_stride(${TILE_WIDTH * 2})
       .output_stride(i)
       .block_width(${TILE_WIDTH * 2})
       .block_height(i)
       .element_size(${ELEMENT_SIZE})
       .iterations(1)
       .Test(${KERNEL});
   }
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT + 1}_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH + 1}_${TILE_WIDTH * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   for(size_t i = ${TILE_HEIGHT + 1}; i < ${TILE_HEIGHT * 2}; ++i){
     for(size_t j = ${TILE_WIDTH + 1}; j < ${TILE_WIDTH * 2}; ++j){
       TransposeMicrokernelTester()
         .input_stride(j)
         .output_stride(i)
         .block_width(j)
         .block_height(i)
         .element_size(${ELEMENT_SIZE})
         .iterations(1)
         .Test(${KERNEL});
     }
   }
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}_is_${TILE_WIDTH * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 2})
     .output_stride(${TILE_HEIGHT})
     .block_width(${TILE_WIDTH})
     .block_height(${TILE_HEIGHT})
     .element_size(${ELEMENT_SIZE})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}_os_${TILE_HEIGHT * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH})
     .output_stride(${TILE_HEIGHT * 2})
     .block_width(${TILE_WIDTH})
     .block_height(${TILE_HEIGHT})
     .element_size(${ELEMENT_SIZE})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}_is_${TILE_WIDTH * 2}_os_${TILE_HEIGHT * 2}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 2})
     .output_stride(${TILE_HEIGHT * 2})
     .block_width(${TILE_WIDTH})
     .block_height(${TILE_HEIGHT})
     .element_size(${ELEMENT_SIZE})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 17}_bw_${TILE_WIDTH * 19}_ies_${ELEMENT_SIZE + 11}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 19})
     .output_stride(${TILE_HEIGHT * 17})
     .block_width(${TILE_WIDTH * 19})
     .block_height(${TILE_HEIGHT * 17})
     .element_size(${ELEMENT_SIZE})
     .input_element_stride(${ELEMENT_SIZE + 11})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 3}_bw_${TILE_WIDTH * 5}_oes_${ELEMENT_SIZE + 11}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 5})
     .output_stride(${TILE_HEIGHT * 3})
     .block_width(${TILE_WIDTH * 5})
     .block_height(${TILE_HEIGHT * 3})
     .element_size(${ELEMENT_SIZE})
     .output_element_stride(${ELEMENT_SIZE + 11})
     .iterations(1)
     .Test(${KERNEL});
 }

 TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 7}_bw_${TILE_WIDTH * 23}_ies_${ELEMENT_SIZE + 17}_oes_${ELEMENT_SIZE + 13}) {
   $if ISA_CHECK:
     ${ISA_CHECK};
   TransposeMicrokernelTester()
     .input_stride(${TILE_WIDTH * 23 + 5})
     .output_stride(${TILE_HEIGHT * 7 + 6})
     .block_width(${TILE_WIDTH * 23})
     .block_height(${TILE_HEIGHT * 7})
     .element_size(${ELEMENT_SIZE})
     .input_element_stride(${ELEMENT_SIZE + 17})
     .output_element_stride(${ELEMENT_SIZE + 13})
     .iterations(1)
     .Test(${KERNEL});
 }
 """


 def generate_test_cases(ukernel, tile_height, tile_width, element_size, isa):
   """Generates all tests cases for a Vector Convert Operation micro-kernel.

   Args:
     ukernel: C name of the micro-kernel function.
     tile_height: Number of vertical elements processed by the ukernel.
     tile_width: Number of horizontal elements processed by the ukernel.
     element_size: Size of each element in bytes.
     isa: instruction set required to run the micro-kernel. Generated unit test
       will skip execution if the host processor doesn't support this ISA.

   Returns:
     Code for the test case.
   """
   _, test_name = ukernel.split("_", 1)
   test_args = [ukernel]
   return xngen.preprocess(
       TRANSPOSE_TEST_TEMPLATE, {
           "TEST_NAME": test_name.upper().replace("UKERNEL_", "") + '_' + str(element_size),
           "KERNEL": ukernel,
           "TILE_HEIGHT": tile_height,
           "TILE_WIDTH": tile_width,
           "ELEMENT_SIZE": element_size,
           "ISA_CHECK": xnncommon.generate_isa_check_macro(isa),
       })

 def generate_memcpy_test_cases(ukernel, tile_height, isa):
   """Generates all tests cases for a Vector Convert Operation micro-kernel.

   Args:
     ukernel: C name of the micro-kernel function.
     tile_height: Number of vertical elements processed by the ukernel.
     isa: instruction set required to run the micro-kernel. Generated unit test
       will skip execution if the host processor doesn't support this ISA.

   Returns:
     Code for the test case.
   """
   _, test_name = ukernel.split("_", 1)
   test_args = [ukernel]
   return xngen.preprocess(
       TRANSPOSE_MEMCPY_TEST_TEMPLATE, {
           "TEST_NAME": test_name.upper().replace("UKERNEL_", ""),
           "KERNEL": ukernel,
           "TILE_HEIGHT": tile_height,
           "ISA_CHECK": xnncommon.generate_isa_check_macro(isa),
       })


 def main(args):
   options = parser.parse_args(args)

   with codecs.open(options.spec, "r", encoding="utf-8") as spec_file:
     spec_yaml = yaml.safe_load(spec_file)
     if not isinstance(spec_yaml, list):
       raise ValueError("expected a list of micro-kernels in the spec")

     tests = """\
 // Copyright 2021 Google LLC
 //
 // This source code is licensed under the BSD-style license found in the
 // LICENSE file in the root directory of this source tree.
 //
 // Auto-generated file. Do not edit!
 //   Specification: {specification}
 //   Generator: {generator}


 #include <gtest/gtest.h>

 #include <xnnpack/common.h>
 #include <xnnpack/isa-checks.h>

 #include <xnnpack/transpose.h>
 #include "transpose-microkernel-tester.h"
 """.format(
     specification=options.spec, generator=sys.argv[0])

     for ukernel_spec in spec_yaml:
       name = ukernel_spec["name"]
       tile_height, tile_width, element_size, arch, isa = split_ukernel_name(name)

       # specification can override architecture
       arch = ukernel_spec.get("arch", arch)

       if element_size is not None:
         test_case = generate_test_cases(name, tile_height, tile_width, element_size, isa)
       else:
         test_case = generate_test_cases(name, tile_height, tile_width, 1, isa)
         test_case += generate_test_cases(name, tile_height, tile_width, 3, isa)
         test_case += generate_test_cases(name, tile_height, tile_width, 5, isa)
       tests += "\n\n" + xnncommon.postprocess_test_case(test_case, arch, isa)

     txt_changed = True
     if os.path.exists(options.output):
       with codecs.open(options.output, "r", encoding="utf-8") as output_file:
         txt_changed = output_file.read() != tests

     if txt_changed:
       with codecs.open(options.output, "w", encoding="utf-8") as output_file:
         output_file.write(tests)


 if __name__ == "__main__":
   main(sys.argv[1:])
	#!/usr/bin/env python
	# Copyright 2021 Google LLC
	#
	# This source code is licensed under the BSD-style license found in the
	# LICENSE file in the root directory of this source tree.

	import argparse
	import codecs
	import math
	import os
	import re
	import sys
	import yaml

	sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
	import xngen
	import xnncommon

	parser = argparse.ArgumentParser(
	description="Matrix transpose microkernel test generator")
	parser.add_argument(
	"-s",
	"--spec",
	metavar="FILE",
	required=True,
	help="Specification (YAML) file")
	parser.add_argument(
	"-o",
	"--output",
	metavar="FILE",
	required=True,
	help="Output (C++ source) file")
	parser.set_defaults(defines=list())


	def split_ukernel_name(name):
	match = re.fullmatch(r"xnn_x(.+)_transpose(v\|c)_ukernel__(\d+)x(\d+)_(.+)", name)
	if match is None:
	raise ValueError("Unexpected microkernel name: " + name)
	if match.group(1) == 'x':
	element_size = None
	else:
	element_size = int(int(match.group(1)) / 8)
	tile_height = int(match.group(3))
	tile_width = int(match.group(4))

	arch, isa = xnncommon.parse_target_name(target_name=match.group(5))
	return tile_height, tile_width, element_size, arch, isa


	TRANSPOSE_TEST_TEMPLATE = """\
	TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 2})
	.output_stride(${TILE_HEIGHT * 2})
	.block_width(${TILE_WIDTH})
	.block_height(${TILE_HEIGHT})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_1_${TILE_HEIGHT * 2}_bw_1_${TILE_WIDTH * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	for(size_t i = 1; i <= ${TILE_HEIGHT * 2}; ++i){
	for(size_t j = 1; j <= ${TILE_WIDTH * 2}; ++j){
	TransposeMicrokernelTester()
	.input_stride(j * 3)
	.output_stride(i * 7)
	.block_width(j)
	.block_height(i)
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}
	}
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 2})
	.output_stride(${TILE_HEIGHT})
	.block_width(${TILE_WIDTH * 2})
	.block_height(${TILE_HEIGHT})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH + 1}_${TILE_WIDTH * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	for(size_t i = ${TILE_WIDTH + 1}; i < ${TILE_WIDTH * 2}; ++i){
	TransposeMicrokernelTester()
	.input_stride(i)
	.output_stride(${TILE_HEIGHT * 2})
	.block_width(i)
	.block_height(${TILE_HEIGHT})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH + 1}_${TILE_WIDTH * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	for(size_t i = ${TILE_WIDTH + 1}; i < ${TILE_WIDTH * 2}; ++i){
	TransposeMicrokernelTester()
	.input_stride(i)
	.output_stride(${TILE_HEIGHT * 2})
	.block_width(i)
	.block_height(${TILE_HEIGHT * 2})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH})
	.output_stride(${TILE_HEIGHT * 3 + 4})
	.block_width(${TILE_WIDTH})
	.block_height(${TILE_HEIGHT * 2})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT + 1}_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH}){
	$if ISA_CHECK:
	${ISA_CHECK};
	for(size_t i = ${TILE_HEIGHT + 1}; i < ${TILE_HEIGHT * 2}; ++i){
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH + 17})
	.output_stride(i)
	.block_width(${TILE_WIDTH + 3})
	.block_height(i)
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT + 1}_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH * 2}){
	$if ISA_CHECK:
	${ISA_CHECK};
	for(size_t i = ${TILE_HEIGHT + 1}; i < ${TILE_HEIGHT * 2}; ++i){
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 2})
	.output_stride(i)
	.block_width(${TILE_WIDTH * 2})
	.block_height(i)
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT + 1}_${TILE_HEIGHT * 2}_bw_${TILE_WIDTH + 1}_${TILE_WIDTH * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	for(size_t i = ${TILE_HEIGHT + 1}; i < ${TILE_HEIGHT * 2}; ++i){
	for(size_t j = ${TILE_WIDTH + 1}; j < ${TILE_WIDTH * 2}; ++j){
	TransposeMicrokernelTester()
	.input_stride(j)
	.output_stride(i)
	.block_width(j)
	.block_height(i)
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}
	}
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}_is_${TILE_WIDTH * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 2})
	.output_stride(${TILE_HEIGHT})
	.block_width(${TILE_WIDTH})
	.block_height(${TILE_HEIGHT})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}_os_${TILE_HEIGHT * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH})
	.output_stride(${TILE_HEIGHT * 2})
	.block_width(${TILE_WIDTH})
	.block_height(${TILE_HEIGHT})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT}_bw_${TILE_WIDTH}_is_${TILE_WIDTH * 2}_os_${TILE_HEIGHT * 2}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 2})
	.output_stride(${TILE_HEIGHT * 2})
	.block_width(${TILE_WIDTH})
	.block_height(${TILE_HEIGHT})
	.element_size(${ELEMENT_SIZE})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 17}_bw_${TILE_WIDTH * 19}_ies_${ELEMENT_SIZE + 11}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 19})
	.output_stride(${TILE_HEIGHT * 17})
	.block_width(${TILE_WIDTH * 19})
	.block_height(${TILE_HEIGHT * 17})
	.element_size(${ELEMENT_SIZE})
	.input_element_stride(${ELEMENT_SIZE + 11})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 3}_bw_${TILE_WIDTH * 5}_oes_${ELEMENT_SIZE + 11}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 5})
	.output_stride(${TILE_HEIGHT * 3})
	.block_width(${TILE_WIDTH * 5})
	.block_height(${TILE_HEIGHT * 3})
	.element_size(${ELEMENT_SIZE})
	.output_element_stride(${ELEMENT_SIZE + 11})
	.iterations(1)
	.Test(${KERNEL});
	}

	TEST(${TEST_NAME}, bh_${TILE_HEIGHT * 7}_bw_${TILE_WIDTH * 23}_ies_${ELEMENT_SIZE + 17}_oes_${ELEMENT_SIZE + 13}) {
	$if ISA_CHECK:
	${ISA_CHECK};
	TransposeMicrokernelTester()
	.input_stride(${TILE_WIDTH * 23 + 5})
	.output_stride(${TILE_HEIGHT * 7 + 6})
	.block_width(${TILE_WIDTH * 23})
	.block_height(${TILE_HEIGHT * 7})
	.element_size(${ELEMENT_SIZE})
	.input_element_stride(${ELEMENT_SIZE + 17})
	.output_element_stride(${ELEMENT_SIZE + 13})
	.iterations(1)
	.Test(${KERNEL});
	}
	"""


	def generate_test_cases(ukernel, tile_height, tile_width, element_size, isa):
	"""Generates all tests cases for a Vector Convert Operation micro-kernel.

	Args:
	ukernel: C name of the micro-kernel function.
	tile_height: Number of vertical elements processed by the ukernel.
	tile_width: Number of horizontal elements processed by the ukernel.
	element_size: Size of each element in bytes.
	isa: instruction set required to run the micro-kernel. Generated unit test
	will skip execution if the host processor doesn't support this ISA.

	Returns:
	Code for the test case.
	"""
	_, test_name = ukernel.split("_", 1)
	test_args = [ukernel]
	return xngen.preprocess(
	TRANSPOSE_TEST_TEMPLATE, {
	"TEST_NAME": test_name.upper().replace("UKERNEL_", "") + '_' + str(element_size),
	"KERNEL": ukernel,
	"TILE_HEIGHT": tile_height,
	"TILE_WIDTH": tile_width,
	"ELEMENT_SIZE": element_size,
	"ISA_CHECK": xnncommon.generate_isa_check_macro(isa),
	})

	def generate_memcpy_test_cases(ukernel, tile_height, isa):
	"""Generates all tests cases for a Vector Convert Operation micro-kernel.

	Args:
	ukernel: C name of the micro-kernel function.
	tile_height: Number of vertical elements processed by the ukernel.
	isa: instruction set required to run the micro-kernel. Generated unit test
	will skip execution if the host processor doesn't support this ISA.

	Returns:
	Code for the test case.
	"""
	_, test_name = ukernel.split("_", 1)
	test_args = [ukernel]
	return xngen.preprocess(
	TRANSPOSE_MEMCPY_TEST_TEMPLATE, {
	"TEST_NAME": test_name.upper().replace("UKERNEL_", ""),
	"KERNEL": ukernel,
	"TILE_HEIGHT": tile_height,
	"ISA_CHECK": xnncommon.generate_isa_check_macro(isa),
	})


	def main(args):
	options = parser.parse_args(args)

	with codecs.open(options.spec, "r", encoding="utf-8") as spec_file:
	spec_yaml = yaml.safe_load(spec_file)
	if not isinstance(spec_yaml, list):
	raise ValueError("expected a list of micro-kernels in the spec")

	tests = """\
	// Copyright 2021 Google LLC
	//
	// This source code is licensed under the BSD-style license found in the
	// LICENSE file in the root directory of this source tree.
	//
	// Auto-generated file. Do not edit!
	// Specification: {specification}
	// Generator: {generator}


	#include <gtest/gtest.h>

	#include <xnnpack/common.h>
	#include <xnnpack/isa-checks.h>

	#include <xnnpack/transpose.h>
	#include "transpose-microkernel-tester.h"
	""".format(
	specification=options.spec, generator=sys.argv[0])

	for ukernel_spec in spec_yaml:
	name = ukernel_spec["name"]
	tile_height, tile_width, element_size, arch, isa = split_ukernel_name(name)

	# specification can override architecture
	arch = ukernel_spec.get("arch", arch)

	if element_size is not None:
	test_case = generate_test_cases(name, tile_height, tile_width, element_size, isa)
	else:
	test_case = generate_test_cases(name, tile_height, tile_width, 1, isa)
	test_case += generate_test_cases(name, tile_height, tile_width, 3, isa)
	test_case += generate_test_cases(name, tile_height, tile_width, 5, isa)
	tests += "\n\n" + xnncommon.postprocess_test_case(test_case, arch, isa)

	txt_changed = True
	if os.path.exists(options.output):
	with codecs.open(options.output, "r", encoding="utf-8") as output_file:
	txt_changed = output_file.read() != tests

	if txt_changed:
	with codecs.open(options.output, "w", encoding="utf-8") as output_file:
	output_file.write(tests)


	if __name__ == "__main__":
	main(sys.argv[1:])