state.h

Go to the documentation of this file.

/*
 * Licensed to the Apache Software Foundation (ASF) under one
 * or more contributor license agreements.  See the NOTICE file
 * distributed with this work for additional information
 * regarding copyright ownership.  The ASF licenses this file
 * to you under the Apache License, Version 2.0 (the
 * "License"); you may not use this file except in compliance
 * with the License.  You may obtain a copy of the License at
 *
 *   http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing,
 * software distributed under the License is distributed on an
 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
 * KIND, either express or implied.  See the License for the
 * specific language governing permissions and limitations
 * under the License.
 */
#ifndef TVM_S_TIR_SCHEDULE_STATE_H_
#define TVM_S_TIR_SCHEDULE_STATE_H_
 
#include <tvm/ffi/reflection/registry.h>
#include <tvm/ir/module.h>
#include <tvm/ir/prim/expr.h>
#include <tvm/s_tir/sblock_scope.h>
#include <tvm/s_tir/stmt.h>
#include <tvm/tirx/function.h>
 
#include <unordered_map>
#include <utility>
 
namespace tvm {
namespace s_tir {
using namespace tvm::tirx;
 
struct SBlockInfo {
  SBlockScope scope{ffi::UnsafeInit()};
  // The properties below are information about the current block realization under its parent scope
  bool affine_binding{false};
  bool region_cover{false};
  bool stage_pipeline{false};
 
  SBlockInfo() = default;
 
  explicit SBlockInfo(SBlockScope scope, bool affine_binding = false, bool region_cover = false,
                      bool stage_pipeline = false)
      : scope(std::move(scope)),         //
        affine_binding(affine_binding),  //
        region_cover(region_cover),
        stage_pipeline(stage_pipeline) {}
};
 
enum ScheduleDebugMask : uint32_t {
  kVerifySRefTree = 1,
  kVerifyCachedFlags = 2,
};
 
class ScheduleStateObj : public ffi::Object {
 public:
  IRModule mod;
  std::unordered_map<StmtSRef, SBlockInfo, ffi::ObjectPtrHash, ffi::ObjectPtrEqual> block_info;
  std::unordered_map<const StmtNode*, StmtSRef> stmt2ref;
  int debug_mask;
  bool enable_check;
 
  static void RegisterReflection() {
    namespace refl = tvm::ffi::reflection;
    refl::ObjectDef<ScheduleStateObj>()
        .def_ro("mod", &ScheduleStateObj::mod)
        .def_ro("debug_mask", &ScheduleStateObj::debug_mask)
        .def_ro("enable_check", &ScheduleStateObj::enable_check);
  }
 
  TVM_DLL void Replace(const tirx::StmtSRef& src_sref, const Stmt& tgt_stmt,
                       const ffi::Map<SBlock, SBlock>& block_sref_reuse);
  TVM_DLL void DebugVerify() const;
 
  static constexpr const bool _type_mutable = true;
  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.ScheduleState", ScheduleStateObj, ffi::Object);
 
  /******** Property of blocks ********/
  TVM_DLL SBlockInfo GetSBlockInfo(const StmtSRef& block_sref) const;
  TVM_DLL void UpdateScopeSBlockInfo(const Stmt& stmt);
  SBlockScope GetSBlockScope(const StmtSRef& scope_root) const {
    return GetSBlockInfo(scope_root).scope;
  }
  bool IsAffineBlockBinding(const StmtSRef& block_sref) const {
    return GetSBlockInfo(block_sref).affine_binding;
  }
  bool IsRegionCoveredConsumer(const StmtSRef& consumer_block_sref) const {
    return GetSBlockInfo(consumer_block_sref).region_cover;
  }
  bool IsStagePipeline(const StmtSRef& scope_root) const {
    return GetSBlockInfo(scope_root).stage_pipeline;
  }
};
 
class ScheduleState : public ffi::ObjectRef {
 public:
  explicit ScheduleState(ffi::UnsafeInit tag, ffi::ObjectPtr<ScheduleStateObj> data)
      : ffi::ObjectRef(tag) {
    data_ = std::move(data);
  }
 
  TVM_DLL explicit ScheduleState(IRModule mod, int debug_mask = 0, bool enable_check = true);
 
  TVM_FFI_DEFINE_OBJECT_REF_METHODS_NOTNULLABLE(ScheduleState, ffi::ObjectRef, ScheduleStateObj);
};
 
}  // namespace s_tir
}  // namespace tvm
 
#endif  // TVM_S_TIR_SCHEDULE_STATE_H_