tvm
tune_context.h
Go to the documentation of this file.
1 /*
2  * Licensed to the Apache Software Foundation (ASF) under one
3  * or more contributor license agreements. See the NOTICE file
4  * distributed with this work for additional information
5  * regarding copyright ownership. The ASF licenses this file
6  * to you under the Apache License, Version 2.0 (the
7  * "License"); you may not use this file except in compliance
8  * with the License. You may obtain a copy of the License at
9  *
10  * http://www.apache.org/licenses/LICENSE-2.0
11  *
12  * Unless required by applicable law or agreed to in writing,
13  * software distributed under the License is distributed on an
14  * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
15  * KIND, either express or implied. See the License for the
16  * specific language governing permissions and limitations
17  * under the License.
18  */
19 #ifndef TVM_S_TIR_META_SCHEDULE_TUNE_CONTEXT_H_
20 #define TVM_S_TIR_META_SCHEDULE_TUNE_CONTEXT_H_
21 
22 #include <tvm/ffi/container/array.h>
23 #include <tvm/ffi/container/map.h>
24 #include <tvm/ffi/function.h>
25 #include <tvm/ffi/optional.h>
26 #include <tvm/ffi/reflection/registry.h>
27 #include <tvm/ffi/string.h>
28 #include <tvm/ir/expr.h>
29 #include <tvm/ir/module.h>
30 #include <tvm/runtime/object.h>
36 #include <tvm/target/target.h>
37 
38 namespace tvm {
39 namespace s_tir {
40 namespace meta_schedule {
41 
42 class TaskSchedulerNode;
43 class MeasureCallback;
44 class TuneContext;
45 
47 class TuneContextNode : public runtime::Object {
48  public:
50 
52  ffi::Optional<IRModule> mod;
54  ffi::Optional<Target> target;
56  ffi::Optional<SpaceGenerator> space_generator;
58  ffi::Optional<SearchStrategy> search_strategy;
60  ffi::Optional<ffi::String> task_name;
67 
68  static void RegisterReflection() {
69  namespace refl = tvm::ffi::reflection;
70  refl::ObjectDef<TuneContextNode>()
71  .def_ro("mod", &TuneContextNode::mod)
72  .def_ro("target", &TuneContextNode::target)
73  .def_ro("space_generator", &TuneContextNode::space_generator)
74  .def_ro("search_strategy", &TuneContextNode::search_strategy)
75  .def_ro("task_name", &TuneContextNode::task_name)
76  .def_ro("num_threads", &TuneContextNode::num_threads)
77  .def_ro("rand_state", &TuneContextNode::rand_state);
78  // `logger` is not registered
79  }
80 
84  void Initialize();
89  TuneContext Clone() const;
90 
91  static constexpr const bool _type_mutable = true;
92  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.meta_schedule.TuneContext", TuneContextNode, Object);
93 };
94 
99 class TuneContext : public runtime::ObjectRef {
100  public:
106  explicit TuneContext(ObjectPtr<TuneContextNode> data) : ObjectRef(data) {
107  TVM_FFI_ICHECK(data != nullptr);
108  }
120  TVM_DLL explicit TuneContext(ffi::Optional<IRModule> mod, ffi::Optional<Target> target,
121  ffi::Optional<SpaceGenerator> space_generator,
122  ffi::Optional<SearchStrategy> search_strategy,
123  ffi::Optional<ffi::String> task_name, int num_threads,
124  TRandState rand_state, ffi::Function logger);
126 };
127 
128 } // namespace meta_schedule
129 } // namespace s_tir
130 } // namespace tvm
131 
132 #endif // TVM_S_TIR_META_SCHEDULE_TUNE_CONTEXT_H_
The auto tuning context.
Definition: tune_context.h:47
void Initialize()
Initialize members that needs initialization with tune context.
ffi::Optional< Target > target
The target to be tuned for.
Definition: tune_context.h:54
TRandState rand_state
The random state.
Definition: tune_context.h:64
TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.meta_schedule.TuneContext", TuneContextNode, Object)
ffi::Function logger
The tuning task's logging function. t.
Definition: tune_context.h:66
ffi::Optional< SpaceGenerator > space_generator
The design space generator.
Definition: tune_context.h:56
static void RegisterReflection()
Definition: tune_context.h:68
ffi::Optional< IRModule > mod
The workload to be tuned.
Definition: tune_context.h:52
ffi::Optional< SearchStrategy > search_strategy
The search strategy.
Definition: tune_context.h:58
static constexpr const bool _type_mutable
Definition: tune_context.h:91
int num_threads
The number of threads to be used.
Definition: tune_context.h:62
support::LinearCongruentialEngine::TRandState TRandState
Definition: tune_context.h:49
ffi::Optional< ffi::String > task_name
The name of the tuning task.
Definition: tune_context.h:60
TuneContext Clone() const
Clone the tune context.
Managed reference to TuneContextNode.
Definition: tune_context.h:99
TuneContext(ObjectPtr< TuneContextNode > data)
Constructor from ObjectPtr<TuneContextNode>.
Definition: tune_context.h:106
TVM_FFI_DEFINE_OBJECT_REF_METHODS_NOTNULLABLE(TuneContext, ObjectRef, TuneContextNode)
TuneContext(ffi::Optional< IRModule > mod, ffi::Optional< Target > target, ffi::Optional< SpaceGenerator > space_generator, ffi::Optional< SearchStrategy > search_strategy, ffi::Optional< ffi::String > task_name, int num_threads, TRandState rand_state, ffi::Function logger)
Constructor.
support::LinearCongruentialEngine::TRandState TRandState
Definition: tune_context.h:101
int64_t TRandState
Definition: random_engine.h:46
Base expr nodes in TVM.
IRModule that holds the functions and type definitions.
Definition: repr_printer.h:91
tvm::relax::Function Function
Definition: transform.h:38
tvm::PrimExpr mod(const tvm::PrimExpr &a, const tvm::PrimExpr &b)
Definition: broadcast.h:308
Performance counters for profiling via the PAPI library.
Definition: analyzer.h:37
A managed object in the TVM runtime.
Random number generator. It provides a generic interface consistent with std::uniform_random_bit_gene...
Compilation target object.