//===- GlobalizeObjectGraph.cpp ----------------------------------*- C++-*-===// // // This file is licensed under the Apache License v2.0 with LLVM Exceptions. // See https://llvm.org/LICENSE.txt for license information. // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception // Also available under a BSD-style license. See LICENSE. // //===----------------------------------------------------------------------===// #include "PassDetail.h" #include "mlir/Dialect/Func/IR/FuncOps.h" #include "mlir/IR/BlockAndValueMapping.h" #include "mlir/IR/Builders.h" #include "mlir/IR/BuiltinOps.h" #include "torch-mlir/Dialect/Torch/IR/TorchDialect.h" #include "torch-mlir/Dialect/Torch/IR/TorchOps.h" #include "torch-mlir/Dialect/Torch/Transforms/Passes.h" #include "llvm/ADT/STLExtras.h" #include "llvm/ADT/SetVector.h" #include "llvm/ADT/StringExtras.h" #include "llvm/ADT/StringMap.h" #include "llvm/ADT/StringSet.h" using namespace mlir; using namespace mlir::torch; using namespace mlir::torch::Torch; static FailureOr findRootNnModule(ModuleOp module) { NnModuleOp rootNnModule; for (NnModuleOp op : module.getOps()) { if (!op.use_empty()) continue; if (rootNnModule) { op.emitError() .append("found more than one root module (module that is not a " "child of any other module)") .attachNote(rootNnModule.getLoc()) .append("see other root module here"); return failure(); } rootNnModule = op; } if (!rootNnModule) { module.emitError() << "module does not contain a root torch.nn_module"; return failure(); } return rootNnModule; } static bool hasMeaningfulObjectIdentity(Type type) { return !type.isa(); } //===----------------------------------------------------------------------===// // Object graph recursive traversal. //===----------------------------------------------------------------------===// namespace { struct LinkageInfo { std::string linkageName; bool isPrivate; }; } // namespace namespace { /// Calculates the linkage names of all the potentially exported objects in the /// module and also creates GlobalSlotOp's for each SlotOp and tracks their /// associations. /// /// The mechanics of both of these tasks involve the same object graph /// traversal, so it's useful to roll them together. class ObjectGraphInfo { public: ObjectGraphInfo(ModuleOp module) : globalSlotBuilder(module.getBodyRegion()), symbolTable(module) {} LogicalResult initialize(NnModuleOp rootNnModule) { if (failed(collectUsedSlots())) return failure(); return recursivelyTraverse(rootNnModule); } LinkageInfo getSlotLinkageInfo(SlotOp op) { auto it = slotLinkageInfo.find(op); assert(it != slotLinkageInfo.end()); return it->second; } Optional getFuncLinkageInfo(NnModuleOp instance, FuncOp methodFunc) { auto it = funcLinkageInfo.find({instance, methodFunc}); if (it == funcLinkageInfo.end()) return None; return it->second; } GlobalSlotOp getGlobalSlotFor(SlotOp slot) { auto it = slotToGlobalSlot.find(slot); assert(it != slotToGlobalSlot.end() && "didn't create global slot"); return it->second; } private: LogicalResult collectUsedSlots() { // Collect all the slots in each module. llvm::StringMap> moduleClassNameToSlots; symbolTable.getOp()->walk([&](NnModuleOp moduleOp) { llvm::StringMap nameToSlot; for (auto attrOp : moduleOp.getOps()) nameToSlot[attrOp.name()] = attrOp; moduleClassNameToSlots[moduleOp.getClassName()] = nameToSlot; }); // Find all the module slots that are accessed through `PrimGetAttrOp` or // `PrimSetAttrOp`. symbolTable.getOp()->walk([&](Operation *op) { if (!isa(op)) return; Value module; StringRef slotName; if (auto getAttrOp = llvm::dyn_cast(op)) { module = getAttrOp.receiver(); slotName = getAttrOp.name(); } else { auto setAttrOp = cast(op); module = setAttrOp.receiver(); slotName = setAttrOp.name(); } auto moduleType = module.getType().cast(); auto slots = moduleClassNameToSlots.find(moduleType.getClassName()); // TODO: Improve verifier so that this can never happen if (slots == moduleClassNameToSlots.end()) op->emitError() << "Reference to non-existing module type " << moduleType.getClassName(); llvm::StringMap nameToSlot = slots->getValue(); auto slotIt = nameToSlot.find(slotName); // TODO: Improve verifier so that this can never happen if (slotIt == nameToSlot.end()) op->emitError() << "Reference to non-existing module slot " << slotName << "in " << moduleType.getClassName(); usedSlots.insert(slotIt->getValue()); }); return success(); } LogicalResult recursivelyTraverse(NnModuleOp nnModule) { std::string pathToClassFromRoot = llvm::join(nameStack, "."); if (!seenNnModules.insert({nnModule, pathToClassFromRoot}).second) { return nnModule.emitError() << "reachable by multiple paths from root object: '." << seenNnModules[nnModule] << "' and '." << pathToClassFromRoot << "'"; } auto classType = symbolTable.lookup( nnModule.getType().cast().getClassName()); for (auto t : llvm::zip(nnModule.getOps(), classType.getOps())) { auto slot = std::get<0>(t); auto attr = std::get<1>(t); nameStack.push_back(attr.name().str()); if (attr.type().isa()) { if (failed( recursivelyTraverse(slot.value().getDefiningOp()))) return failure(); } else { std::string linkageName = llvm::join(nameStack, "."); auto globalSlot = globalSlotBuilder.create( slot.getLoc(), linkageName, /*sym_visibility=*/nullptr, attr.type()); if (attr.isPrivate()) globalSlot.setVisibility(SymbolTable::Visibility::Private); assert(slotToGlobalSlot.find(slot) == slotToGlobalSlot.end()); slotToGlobalSlot[slot] = globalSlot; slotLinkageInfo[slot] = LinkageInfo{linkageName, attr.isPrivate()}; if (failed(populateGlobalSlotInitializer(globalSlot, slot))) return failure(); } nameStack.pop_back(); } for (auto method : classType.getOps()) { nameStack.push_back(method.name().str()); funcLinkageInfo[{nnModule, symbolTable.lookup(method.function())}] = LinkageInfo{llvm::join(nameStack, "."), method.isPrivate()}; nameStack.pop_back(); } return success(); } LogicalResult populateGlobalSlotInitializer(GlobalSlotOp globalSlot, SlotOp slot) { OpBuilder builder(globalSlot.getContext()); builder.createBlock(&globalSlot.getRegion()); SmallPtrSet needToClone; Value initialValue = slot.value(); SmallVector worklist = {initialValue.getDefiningOp()}; while (!worklist.empty()) { Operation *op = worklist.pop_back_val(); if (!needToClone.insert(op).second) continue; for (Value operand : op->getOperands()) { if (auto def = operand.getDefiningOp()) worklist.push_back(def); } } worklist.assign(needToClone.begin(), needToClone.end()); llvm::sort(worklist, [](Operation *lhs, Operation *rhs) { return lhs->isBeforeInBlock(rhs); }); BlockAndValueMapping mapping; for (Operation *op : worklist) { builder.clone(*op, mapping); for (Value result : op->getResults()) { if (!hasMeaningfulObjectIdentity(result.getType())) continue; if (usedSlots.find(slot) == usedSlots.end()) continue; if (!objectsWithIdentityAlreadyCopiedIntoInitializers.insert(result) .second) { return op->emitError() << "potentially-aliased value used to " "initialize multiple slots"; } } } builder.create(globalSlot->getLoc(), mapping.lookup(initialValue)); return success(); } // Builder for creating GlobalSlotOp's in the module. OpBuilder globalSlotBuilder; // Symbol table for the module. SymbolTable symbolTable; // The set of NnModuleOp's that have already been processed. // Used for diagnostics. // The map value is the original path from the root that we found it at. DenseMap seenNnModules; // The stack of attribute names we have traversed during our recursive // traversal of the class/object hierarchy. // // Linkage names are calculated based on the set of attribute names traversed // from the root class/module in the program. std::vector nameStack; // Linkage info for each SlotOp in the program. DenseMap slotLinkageInfo; // Linkage info for each method in the program. Since we are going to be // monomorphizing all the functions, we also need to key this off of the // instance (NnModuleOp) that the func is monomorphized for. DenseMap, LinkageInfo> funcLinkageInfo; // The corresponding GlobalSlotOp for each SlotOp in the program. DenseMap slotToGlobalSlot; // A set of values that we have copied into torch.global_slot initializers, // which cannot be used in multiple initializers because their object // identity is important. DenseSet objectsWithIdentityAlreadyCopiedIntoInitializers; // Used to keep track of all the used torch slots so that the restrictions can // be applied to those slots only. DenseSet usedSlots; }; } // namespace //===----------------------------------------------------------------------===// // Monomorphization. //===----------------------------------------------------------------------===// namespace { // When used in an Monomorphization, indicates that the arg at `argIndex` will // correspond to instance `instance. struct ArgInstance { int argIndex; Value instance; // Result of an NnModuleOp. }; static llvm::hash_code hash_value(const ArgInstance &argInstance) { return llvm::hash_combine(argInstance.argIndex, argInstance.instance); } static bool operator==(const ArgInstance &lhs, const ArgInstance &rhs) { return std::make_tuple(lhs.argIndex, lhs.instance) == std::make_tuple(rhs.argIndex, rhs.instance); } } // namespace namespace { // Record indicating that a particular function must be monomorphized for the // given ArgInstance's, which involves deleting those arguments and specializing // all their uses to operate on GlobalSlotOp's that we have created for the // SlotOp's of the NnModuleOp instances. // // NOTE: Unlike the more traditional use of monomorphization to mean a single // *type* is being specialized for, here we are specializing for a specific // *instance*. This still fits the definition of monomorphization though, albeit // with each instance being considered to have a maximally refined type which is // a set with a single element (just this instance). This does not correspond to // any notion of "type" that we have in the IR, but still fits the formal // definition. struct Monomorphization { FuncOp func; std::vector argInstances; }; } // namespace template <> struct llvm::DenseMapInfo { static Monomorphization getEmptyKey() { return Monomorphization{nullptr, {ArgInstance{-1, nullptr}}}; } static Monomorphization getTombstoneKey() { return Monomorphization{nullptr, {ArgInstance{-2, nullptr}}}; } static unsigned getHashValue(Monomorphization val) { return llvm::hash_combine(val.func.getAsOpaquePointer(), llvm::hash_combine_range(val.argInstances.begin(), val.argInstances.end())); } static bool isEqual(Monomorphization lhs, Monomorphization rhs) { return lhs.func == rhs.func && std::equal(lhs.argInstances.begin(), lhs.argInstances.end(), rhs.argInstances.begin(), rhs.argInstances.end()); } }; // Populate `mapping` such that values of NnModuleType in the function are // mapped to appropriate global objects of NnModuleType. // // This generalizes to a full abstract interpretation of the function, but // currently only analyzes a subset of ops. static LogicalResult analyzeInstances(FuncOp func, ArrayRef argInstances, BlockAndValueMapping &mapping) { for (auto &argInstance : argInstances) mapping.map(func.getArgument(argInstance.argIndex), argInstance.instance); auto walkResult = func.walk([&](PrimGetAttrOp op) { if (!op.getType().isa()) return WalkResult::advance(); auto instance = mapping.lookupOrNull(op.receiver()); assert(instance && "verifyFuncConformsToSubset should ensure this"); for (auto slot : instance.getDefiningOp().getOps()) { if (slot.name() == op.name()) { mapping.map(op, slot.value()); break; } } return WalkResult::advance(); }); return success(!walkResult.wasInterrupted()); } static FailureOr createMonomorphizationForCall(func::CallOp op, BlockAndValueMapping &mapping, SymbolTable &symbolTable) { auto func = symbolTable.lookup(op.getCallee()); Monomorphization monomorphization; monomorphization.func = func; for (auto operand : llvm::enumerate(op->getOperands())) { if (!operand.value().getType().isa()) continue; Value instance = mapping.lookupOrNull(operand.value()); assert(instance && "verifyFuncConformsToSubset should ensure this"); monomorphization.argInstances.push_back( ArgInstance{static_cast(operand.index()), instance}); } return monomorphization; } namespace { class MonomorphizationTracker { public: MonomorphizationTracker(ModuleOp module) : module(module), symbolTable(module) {} LogicalResult initialize(DenseMap> &instances) { for (auto func : module.getOps()) { Monomorphization monomorphization; monomorphization.func = func; bool canTriviallyMonomorphize = true; for (auto arg : llvm::enumerate(func.getArguments())) { auto type = arg.value().getType().dyn_cast(); if (!type) continue; auto classType = symbolTable.lookup(type.getClassName()); auto &classTypeInstances = instances[classType]; if (classTypeInstances.size() != 1) { canTriviallyMonomorphize = false; break; } monomorphization.argInstances.push_back( {static_cast(arg.index()), classTypeInstances[0]}); } if (canTriviallyMonomorphize) { dirtyMonomorphizations.push_back(monomorphization); monomorphizations.insert(monomorphization); } } while (!dirtyMonomorphizations.empty()) { Monomorphization dirty = dirtyMonomorphizations.pop_back_val(); if (failed(generateNewMonomorphizations(dirty))) return failure(); } return success(); } llvm::SetVector &getMonomorphizations() { return monomorphizations; } private: LogicalResult generateNewMonomorphizations(const Monomorphization &m) { auto func = m.func; BlockAndValueMapping mapping; if (failed(analyzeInstances(func, m.argInstances, mapping))) return failure(); auto walkResult = func.walk([&](func::CallOp op) { FailureOr maybeMonomorphization = createMonomorphizationForCall(op, mapping, symbolTable); if (failed(maybeMonomorphization)) return WalkResult::interrupt(); if (monomorphizations.insert(*maybeMonomorphization)) dirtyMonomorphizations.push_back(*maybeMonomorphization); return WalkResult::advance(); }); return success(!walkResult.wasInterrupted()); } ModuleOp module; SymbolTable symbolTable; SmallVector dirtyMonomorphizations; llvm::SetVector monomorphizations; }; } // namespace // Verify that a value conforms to the subset of allowed uses for // !torch.nn.Module<"..."> types. static LogicalResult verifyNnModuleValueUses(Value value) { // Trivially succeed for non-module types. if (!value.getType().isa()) return success(); for (Operation *op : value.getUsers()) { if (isa(op)) continue; // Only allow `value` as the receiver. if (isa(op) && cast(op).value() != value) continue; // TODO: Improve this based on real user use cases. // This is a diagnostic that users will hit if they do not conform to // the supported subset of TorchScript. return op->emitError() << "unsupported use of a torch.nn.Module. Expected " "only method calls or attribute get/set"; } return success(); } // Verify that `func` conforms to the subset of allowable method bodies // that we can convert. static LogicalResult verifyFuncConformsToSubset(FuncOp func) { // TODO: Investingate why WalkResult::interrupt() doesn't propagate properly. LogicalResult ret = success(); func.walk([&](Block *block) { for (Value arg : block->getArguments()) { if (failed(verifyNnModuleValueUses(arg))) { ret = failure(); return WalkResult::interrupt(); } } for (Operation &op : *block) { for (Value result : op.getResults()) { if (failed(verifyNnModuleValueUses(result))) { ret = failure(); return WalkResult::interrupt(); } } } return WalkResult::advance(); }); return ret; } static LogicalResult verifyPublicMonomorphizations(ModuleOp module, SymbolTable &symbolTable, MonomorphizationTracker &tracker) { DenseMap numMonomorphizations; for (auto &monomorphization : tracker.getMonomorphizations()) { numMonomorphizations[monomorphization.func] += 1; } bool sawError = false; for (auto classType : module.getOps()) { for (auto method : classType.getOps()) { if (!method.isPrivate()) { if (numMonomorphizations[symbolTable.lookup( method.function())] > 1) { method.emitError() << "public function with multiple monomorphizations"; sawError = true; } } } } return success(!sawError); } // Rewrite `func`, given that all values of `NnModuleType` have been mapped in // `mapping` to corresponding global instances. static LogicalResult rewriteMonomorphizedFuncClone(FuncOp func, BlockAndValueMapping mapping, SymbolTable &symbolTable, DenseMap &newFuncs, ObjectGraphInfo &objectGraphInfo) { SmallVector toErase; auto handlePrimSetAttr = [&](PrimSetAttrOp op) { auto instance = mapping.lookup(op.receiver()).getDefiningOp(); SlotOp affectedSlot; for (auto slot : instance.getOps()) { if (slot.name() == op.name()) affectedSlot = slot; } OpBuilder(op).create( op.getLoc(), objectGraphInfo.getGlobalSlotFor(affectedSlot).sym_name(), op.value()); toErase.push_back(op); return WalkResult::advance(); }; auto handlePrimGetAttr = [&](PrimGetAttrOp op) { if (!op.getType().isa()) { auto instance = mapping.lookup(op.receiver()).getDefiningOp(); SlotOp affectedSlot; for (auto slot : instance.getOps()) { if (slot.name() == op.name()) affectedSlot = slot; } auto newOp = OpBuilder(op).create( op.getLoc(), op.getType(), objectGraphInfo.getGlobalSlotFor(affectedSlot).sym_name()); op.replaceAllUsesWith(&*newOp); } toErase.push_back(op); return WalkResult::advance(); }; auto handleCall = [&](func::CallOp op) { FailureOr maybeMonomorphization = createMonomorphizationForCall(op, mapping, symbolTable); if (failed(maybeMonomorphization)) return WalkResult::interrupt(); Monomorphization monomorphization = std::move(*maybeMonomorphization); auto newArguments = llvm::to_vector<6>( llvm::make_filter_range(op->getOperands(), [](Value v) { return !v.getType().isa(); })); assert(newFuncs.find(monomorphization) != newFuncs.end()); auto newOp = OpBuilder(op).create( op.getLoc(), newFuncs[monomorphization], newArguments); op.replaceAllUsesWith(newOp); toErase.push_back(op); return WalkResult::advance(); }; auto walkResult = func.walk([&](Operation *op) { if (auto primSetAttr = dyn_cast(op)) return handlePrimSetAttr(primSetAttr); if (auto primGetAttr = dyn_cast(op)) return handlePrimGetAttr(primGetAttr); if (auto call = dyn_cast(op)) return handleCall(call); return WalkResult::advance(); }); for (auto op : toErase) { op->dropAllDefinedValueUses(); op->erase(); } llvm::BitVector argsToErase(func.getNumArguments()); for (auto type : llvm::enumerate(func.getArgumentTypes())) { if (type.value().isa()) { argsToErase.set(type.index()); } } func.eraseArguments(argsToErase); return success(!walkResult.wasInterrupted()); } static LogicalResult globalizeObjectGraph(ModuleOp module) { // Step 1: Traverse object graph and collect information. FailureOr maybeRootNnModule = findRootNnModule(module); if (failed(maybeRootNnModule)) return failure(); NnModuleOp rootNnModule = *maybeRootNnModule; ObjectGraphInfo objectGraphInfo(module); if (failed(objectGraphInfo.initialize(rootNnModule))) return failure(); DenseMap> instances; SymbolTable symbolTable(module); for (auto nnModule : module.getOps()) { auto classType = nnModule.getClassType(symbolTable); instances[classType].push_back(nnModule); } // Step 2: Verify all functions are suitable to be analyzed by our later code. // This eliminates special handling / error code later. // // This is important, because in principle, we can perform arbitrarily complex // static analysis to discover how to monomorphize th eprogram, including // tracking instances through control flow, through get/set attr, etc. We // implement a very simple subset of cases. for (auto func : module.getOps()) { if (failed(verifyFuncConformsToSubset(func))) return failure(); } // Step 3: Calculate the set of monomorphized functions that need to be // created. For each call that passes !torch.nn.Module to a function, we need // to create a specialized version of that function just for that instance (or // combination of instances in the case of multiple arguments). // // At this stage, we only analyze which monomorphizations are needed and // whether it is possible to monomorphize the program. The actual // cloning/rewriting mechanics happen later. // // This lets us know which GlobalSlotOp we need to reference when we replace // PrimSetAttrOp/PrimGetAttrOp. // // Note that in general there can be mutually recursive functions that // re-enter themselves with a different set of instances -- the process of // calculating these monomorphizations is a fixed-point iteration that // discovers all needed monomorphizations. In practice this yields a // controllable number. MonomorphizationTracker tracker(module); if (failed(tracker.initialize(instances))) return failure(); if (failed(verifyPublicMonomorphizations(module, symbolTable, tracker))) { return failure(); } // Step 4: Clone/rewrite functions to implement the necessary // monomorphizations. DenseMap newFuncs; int uniquifier = 0; for (auto &monomorphization : tracker.getMonomorphizations()) { auto newFunc = cast(monomorphization.func->clone()); newFuncs[monomorphization] = newFunc; Optional linkageInfo = None; // If it is potentially a method, check its linkage info. if (monomorphization.argInstances.size() != 0 && monomorphization.argInstances[0].argIndex == 0) { linkageInfo = objectGraphInfo.getFuncLinkageInfo( monomorphization.argInstances[0].instance.getDefiningOp(), monomorphization.func); } if (linkageInfo.hasValue()) { // It's a method. newFunc.setVisibility(linkageInfo->isPrivate ? SymbolTable::Visibility::Private : SymbolTable::Visibility::Public); newFunc.setName(linkageInfo->linkageName); } else { // It's a free function. // TODO: Make the name nicer (no suffix in typical case). newFunc.setName( (Twine(newFunc.getName()) + "$" + Twine(uniquifier++)).str()); } module.push_back(newFunc); } for (auto &kv : newFuncs) { BlockAndValueMapping mapping; if (failed(analyzeInstances(kv.second, kv.first.argInstances, mapping))) return failure(); if (failed(rewriteMonomorphizedFuncClone(kv.second, mapping, symbolTable, newFuncs, objectGraphInfo))) return failure(); } // Step 5: Clean up object graph. DenseSet liveFuncs; for (auto &kv : newFuncs) { liveFuncs.insert(kv.second); } for (auto &op : llvm::make_early_inc_range(module.getOps())) { if (isa(&op)) continue; if (auto func = dyn_cast(op)) { if (liveFuncs.contains(func)) continue; } op.dropAllDefinedValueUses(); op.dropAllReferences(); op.erase(); } return success(); } namespace { class GlobalizeObjectGraphPass : public GlobalizeObjectGraphBase { void runOnOperation() override { if (failed(globalizeObjectGraph(getOperation()))) return signalPassFailure(); } }; } // namespace std::unique_ptr> mlir::torch::Torch::createGlobalizeObjectGraphPass() { return std::make_unique(); }