################################################################################ # # Copyright (C) 2016-2022 Advanced Micro Devices, Inc. All rights reserved. # # Permission is hereby granted, free of charge, to any person obtaining a copy # of this software and associated documentation files (the "Software"), to deal # in the Software without restriction, including without limitation the rights # to use, copy, modify, merge, publish, distribute, sublicense, and/or sell # copies of the Software, and to permit persons to whom the Software is # furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included in # all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE # SOFTWARE. # ################################################################################ from .SolutionStructs import Solution from .Common import printExit, restoreDefaultGlobalParameters, assignGlobalParameters, ensurePath from .Utilities.ConditionalImports import yamlDumper from . import LibraryIO from copy import deepcopy from enum import IntEnum import yaml import os import sys import argparse verbosity = 1 class Logic: def __init__(self, sols, sizes): self.sols = sols self.sizes = sizes def allFiles(startDir): current = os.listdir(startDir) files = [] for filename in [_current for _current in current if os.path.splitext(_current)[-1].lower() == '.yaml']: fullPath = os.path.join(startDir,filename) if os.path.isdir(fullPath): files = files + allFiles(fullPath) else: files.append(fullPath) return files def reindexSolutions(logic): for i, s in enumerate(logic.sols): s["SolutionIndex"] = i def fixSizeInconsistencies(sizes, fileType): duplicates = list() for i in range(0,len(sizes)): currSize = sizes[i][0] # >= so size will be trimmed when a SolutionTag is included if len(currSize) >= 8: currSize = currSize[:-4] if currSize in (item for index in sizes for item in index): duplicates.append(i-len(duplicates)) else: sizes[i][0] = currSize sizes_ = deepcopy(sizes) if len(duplicates) > 0: for i in duplicates: sizes_.pop(i) verbose(len(duplicates), "duplicate size(s) removed from", fileType, "logic file") return sizes_, len(sizes_) def solsEq(s1o, s2o): s1 = deepcopy(s1o) s2 = deepcopy(s2o) s1["AssignedProblemIndependentDerivedParameters"] = False s1["AssignedDerivedParameters"] = False s2["AssignedProblemIndependentDerivedParameters"] = False s2["AssignedDerivedParameters"] = False return Solution(s1) == Solution(s2) def addKernel(solutionPool, solution): for item in solutionPool: if solsEq(item, solution): index = item["SolutionIndex"] debug("...Reuse previously existed kernel", end="") break else: index = len(solutionPool) _solution = deepcopy(solution) # if we don't we will see some subtle errors _solution["SolutionIndex"] = index solutionPool.append(_solution) debug("...A new kernel has been added", end="") debug("({}) {}".format(index, solutionPool[index]["SolutionNameMin"] if "SolutionNameMin" in solutionPool[index] else "(SolutionName N/A)")) return solutionPool, index def removeUnusedKernels(origLogic, prefix=""): origNumSolutions = len(origLogic.sols) kernelsInUse = [ index for _, [index, _] in origLogic.sizes ] for i, solution in enumerate(origLogic.sols): solutionIndex = solution["SolutionIndex"] origLogic.sols[i]["__InUse__"] = True if solutionIndex in kernelsInUse else False # debug prints for o in [o for o in origLogic.sols if o["__InUse__"]==False]: debug("{}Solution ({}) {} is unused".format( prefix, o["SolutionIndex"], o["SolutionNameMin"] if "SolutionNameMin" in o else "(SolutionName N/A)")) # filter out dangling kernels origLogic.sols = [ {k: v for k, v in o.items() if k != "__InUse__"} for o in origLogic.sols if o["__InUse__"]==True ] # reindex solutions idMap = {} # new = idMap[old] for i, solution in enumerate(origLogic.sols): idMap[solution["SolutionIndex"]] = i origLogic.sols[i]["SolutionIndex"] = i for i, [size, [oldSolIndex, eff]] in enumerate(origLogic.sizes): origLogic.sizes[i] = [size, [idMap[oldSolIndex], eff]] numInvalidRemoved = origNumSolutions - len(origLogic.sols) return numInvalidRemoved # this is for complying the behavior of legacy merge script, where incremental logic # file always replaces the base logic file even it's slower in performance - # in the future we may let default force merge policy = False def defaultForceMergePolicy(incFile): if "arcturus" in incFile: forceMerge = False else: forceMerge = True return forceMerge def msg(*args, **kwargs): for i in args: print(i, end=" ") print(**kwargs) def verbose(*args, **kwargs): if verbosity < 1: return msg(*args, **kwargs) def debug(*args, **kwargs): if verbosity < 2: return msg(*args, **kwargs) # Tags distinguishing solution types # Can be added to size key to allow solutions of each type to be present # in logic file for a given size class MfmaTag(IntEnum): VALU = 0 MFMA = 1 def __str__(self): return ["VALU", "MFMA"][self] def __repr__(self): return str(self) class AlphaValueTag(IntEnum): ANY = 0 ONE = 1 NEG_ONE = 2 ZERO = 3 def __str__(self): return "Alpha="+["Any", "1", "-1", "0"][self] def __repr__(self): return str(self) class BetaValueTag(IntEnum): ANY = 0 ONE = 1 NEG_ONE = 2 ZERO = 3 def __str__(self): return "Beta="+["Any", "1", "-1", "0"][self] def __repr__(self): return str(self) def strToScalarValueTag(Class, value): if value == "Any": return Class.ANY if value == 1: return Class.ONE if value == -1: return Class.NEG_ONE if value == 0: return Class.ZERO else: raise RuntimeError("Unsupported value for Alpha/Beta scalar value") class CEqualsDTag(IntEnum): C_EQ_D = 0 C_NEQ_D = 1 def __str__(self): return ["C=D", "C!=D"][self] def __repr__(self): return str(self) # Tag of form (MFMATag, AlphaValueTag, BetaValueTag, CEqualsDTag) def getSolutionTag(solution): tagTuple = () if solution.get("EnableMatrixInstruction", False) or solution.get("MatrixInstruction", False): tagTuple = tagTuple + (MfmaTag.MFMA,) else: tagTuple = tagTuple + (MfmaTag.VALU,) tagTuple = tagTuple + (strToScalarValueTag(AlphaValueTag, solution.get("AssertAlphaValue", "Any")),) tagTuple = tagTuple + (strToScalarValueTag(BetaValueTag, solution.get("AssertBetaValue", "Any")),) tagTuple = tagTuple + (CEqualsDTag.C_EQ_D if solution.get("AssertCEqualsD", False) else CEqualsDTag.C_NEQ_D ,) return tagTuple def findSolutionWithIndex(solutionData, solIndex): # Check solution at the index corresponding to solIndex first if solIndex < len(solutionData) and solutionData[solIndex]["SolutionIndex"] == solIndex: return solutionData[solIndex] else: debug("Searching for index...") solution = [s for s in solutionData if s["SolutionIndex"]==solIndex] assert(len(solution) == 1) return solution[0] def addSolutionTagToKeys(solutionMap, solutionPool): return [[[getSolutionTag(findSolutionWithIndex(solutionPool, idx))] + keys, [idx, eff]] for [keys, [idx, eff]] in solutionMap] def removeSolutionTagFromKeys(solutionMap): return [[keys[1:], [idx, incEff]] for keys, [idx, incEff] in solutionMap] # To be used with add_solution_tags to allow faster general solutions to supercede slower specific ones def findFastestCompatibleSolution(origDict, sizeMapping): tags = sizeMapping[0] # Tag of form (MFMATag, AlphaValueTag, BetaValueTag, CEqualsDTag) compatibleTagList = [tags] # Add all compatible tags to the list if tags[1] != AlphaValueTag.ANY: compatibleTagList = compatibleTagList + [(t[0], AlphaValueTag.ANY) + t[2:] for t in compatibleTagList] if tags[2] != BetaValueTag.ANY: compatibleTagList = compatibleTagList + [t[:2] + (BetaValueTag.ANY,) + t[3:] for t in compatibleTagList] if tags[3] != CEqualsDTag.C_NEQ_D: compatibleTagList = compatibleTagList + [t[:3] + (CEqualsDTag.C_NEQ_D,) + t[4:] for t in compatibleTagList] #Find the fastest efficiency of all compatible tags maxEfficiency = 0 for tag in compatibleTagList: result = origDict.get((tag,) + sizeMapping[1:], None) if result: _, eff = origDict[(tag,) + sizeMapping[1:]] maxEfficiency = max(maxEfficiency, eff) return maxEfficiency # returns merged logic data as list def mergeLogic(origLogic, incLogic, forceMerge, trimSize=True, addSolutionTags=False): origNumSizes = len(origLogic.sizes) origNumSolutions = len(origLogic.sols) incNumSizes = len(incLogic.sizes) incNumSolutions = len(incLogic.sols) verbose(origNumSizes, "sizes and", origNumSolutions, "kernels in base logic file") verbose(incNumSizes, "sizes and", incNumSolutions, "kernels in incremental logic file") # Add SolutionTag to distinguish solutions with different requirements origTaggedSizes = addSolutionTagToKeys(origLogic.sizes, origLogic.sols) incTaggedSizes = addSolutionTagToKeys(incLogic.sizes, incLogic.sols) if addSolutionTags: origLogic.sizes = origTaggedSizes incLogic.sizes = incTaggedSizes # Print warning if addSolutionTags=False results in removed sizes else: origSet = {tuple(size) for size, [_, _] in origLogic.sizes} origTaggedSet = {tuple(size) for size, [_, _] in origTaggedSizes} incSet = {tuple(size) for size, [_, _] in incLogic.sizes} incTaggedSet = {tuple(size) for size, [_, _] in incTaggedSizes} if len(origSet) != len(origTaggedSet): verbose("Warning:", len(origTaggedSet) - len(origSet), "duplicate sizes are present in base logic", "that may not be handled correctly unless --add_solution_tags is used") if len(incSet) != len(incTaggedSet): verbose("Warning:", len(incTaggedSet) - len(incSet), "duplicate sizes are present in incremental logic", "that may not be handled correctly unless --add_solution_tags is used") if trimSize: # trim 8-tuple gemm size format to 4-tuple [m, n, b, k] # TODO future gemm size could include dictionary format so need robust preprocessing [origLogic.sizes, origNumSizes] = fixSizeInconsistencies(origLogic.sizes, "base") [incLogic.sizes, incNumSizes] = fixSizeInconsistencies(incLogic.sizes, "incremental") numOrigRemoved = removeUnusedKernels(origLogic, "Base logic file: ") numIncRemoved = removeUnusedKernels(incLogic, "Inc logic file: ") solutionPool = deepcopy(origLogic.sols) solutionMap = deepcopy(origLogic.sizes) origDict = {tuple(origSize): [i, origEff] for i, [origSize, [origIndex, origEff]] in enumerate(origLogic.sizes)} for incSize, [incIndex, incEff] in incLogic.sizes: incSolution = findSolutionWithIndex(incLogic.sols, incIndex) try: j, origEff = origDict[tuple(incSize)] if incEff > origEff or forceMerge: if incEff > origEff: verbose("[O]", incSize, "already exists and has improved in performance.", end="") elif forceMerge: verbose("[!]", incSize, "already exists but does not improve in performance.", end="") verbose("Efficiency:", origEff, "->", incEff, "(force_merge=True)" if forceMerge else "") solutionPool, index = addKernel(solutionPool, incSolution) solutionMap[j][1] = [index, incEff] else: verbose("[X]", incSize, "already exists but does not improve in performance.", end="") verbose("Efficiency:", origEff, "->", incEff) except KeyError: if addSolutionTags and findFastestCompatibleSolution(origDict, tuple(incSize)) > incEff: verbose("[X]", incSize, "has been rejected because a compatible solution already exists with higher performance") else: verbose("[-]", incSize, "has been added to solution table, Efficiency: N/A ->", incEff) solutionPool, index = addKernel(solutionPool, incSolution) solutionMap.append([incSize,[index, incEff]]) verbose(numOrigRemoved, "unused kernels removed from base logic file") verbose(numIncRemoved, "unused kernels removed from incremental logic file") # Remove SolutionTag for yaml output if addSolutionTags: solutionMap = removeSolutionTagFromKeys(solutionMap) mergedLogic = Logic(solutionPool, solutionMap) numReplaced = removeUnusedKernels(mergedLogic, "Merged data: ") numSizesAdded = len(solutionMap)-len(origLogic.sizes) numSolutionsAdded = len(solutionPool)-len(origLogic.sols) numSolutionsRemoved = numReplaced+numOrigRemoved # incremental file not counted return [mergedLogic, numSizesAdded, numSolutionsAdded, numSolutionsRemoved] def getSizesAndSols(data): if type(data) is list: return Logic(data[5], data[7]) elif type(data) is dict: sols = data["Solutions"] sizes = data["Library"]["table"] return Logic(sols, sizes) else: printExit("Bad data") def updateSizesAndSols(data, logic): if type(data) is list: data[5] = logic.sols data[7] = logic.sizes elif type(data) is dict: data["Solutions"] = logic.sols data["Library"]["table"] = logic.sizes else: printExit("Bad data") def avoidRegressions(originalDir, incrementalDir, outputPath, forceMerge, trimSize=True, addSolutionTags=False): originalFiles = allFiles(originalDir) incrementalFiles = allFiles(incrementalDir) ensurePath(outputPath) # filter the incremental logic files that have the corresponding base file incrementalFiles = [ i for i in incrementalFiles if os.path.split(i)[-1] in [os.path.split(o)[-1] for o in originalFiles] ] for incFile in incrementalFiles: basename = os.path.split(incFile)[-1] origFile = os.path.join(originalDir, basename) forceMerge = defaultForceMergePolicy(incFile) if forceMerge is None else forceMerge msg("Base logic file:", origFile, "| Incremental:", incFile, "| Merge policy: %s"%("Forced" if forceMerge else "Winner"), "| Trim size:", trimSize, "| Add solution tags:", addSolutionTags) origData = LibraryIO.readYAML(origFile) incData = LibraryIO.readYAML(incFile) origLogic = getSizesAndSols(origData) incLogic = getSizesAndSols(incData) # So far "SolutionIndex" in logic yamls has zero impact on actual 1-1 size mapping (but the order of the Solution does) # since mergeLogic() takes that value very seriously so we reindex them here so it doesn't choke on duplicated SolutionIndex reindexSolutions(origLogic) reindexSolutions(incLogic) mergedLogic, *stats = mergeLogic(origLogic, incLogic, forceMerge, trimSize, addSolutionTags) msg(stats[0], "size(s) and", stats[1], "kernel(s) added,", stats[2], "kernel(s) removed") updateSizesAndSols(origData, mergedLogic) with open(os.path.join(outputPath, basename), "w") as outFile: yaml.dump(origData, outFile, yamlDumper, default_flow_style=None) msg("File written to", os.path.join(outputPath, basename)) msg("------------------------------") def main(): restoreDefaultGlobalParameters() assignGlobalParameters({}) argParser = argparse.ArgumentParser() argParser.add_argument("original_dir", help="The library logic directory without tuned sizes") argParser.add_argument("incremental_dir", help="The incremental logic directory") argParser.add_argument("output_dir", help="The output logic directory") argParser.add_argument("-v", "--verbosity", help="0: summary, 1: verbose, 2: debug", default=1, type=int) argParser.add_argument("--force_merge", help="Merge previously known sizes unconditionally. Default behavior if not arcturus", default="none") argParser.add_argument("--notrim", help="Do not trim long size format down to short format (m,n,b,k). Default is --trim", action="store_false") argParser.add_argument("--add_solution_tags", help="Add tags to the size key for solution properies, allowing for solutions with different requirements " "to exist for the same size. Default doesn't add this tag.", action="store_true") args = argParser.parse_args(sys.argv[1:]) originalDir = args.original_dir incrementalDir = args.incremental_dir outputPath = args.output_dir global verbosity verbosity = args.verbosity forceMerge = args.force_merge.lower() trimSize = args.notrim add_solution_tags = args.add_solution_tags if forceMerge in ["none"]: forceMerge=None elif forceMerge in ["true", "1"]: forceMerge=True elif forceMerge in ["false", "0"]: forceMerge=False avoidRegressions(originalDir, incrementalDir, outputPath, forceMerge, trimSize, add_solution_tags)