tvm
cost_model.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 
20 #ifndef TVM_S_TIR_META_SCHEDULE_COST_MODEL_H_
21 #define TVM_S_TIR_META_SCHEDULE_COST_MODEL_H_
22 
23 #include <tvm/ffi/container/array.h>
24 #include <tvm/ffi/function.h>
25 #include <tvm/ffi/reflection/registry.h>
26 #include <tvm/ffi/string.h>
27 #include <tvm/runtime/object.h>
32 
33 #include <vector>
34 
35 namespace tvm {
36 namespace s_tir {
37 namespace meta_schedule {
38 
39 class TuneContext;
40 
42 class CostModelNode : public runtime::Object {
43  public:
45  virtual ~CostModelNode() = default;
46 
51  virtual void Load(const ffi::String& path) = 0;
52 
57  virtual void Save(const ffi::String& path) = 0;
58 
65  virtual void Update(const TuneContext& context, const ffi::Array<MeasureCandidate>& candidates,
66  const ffi::Array<RunnerResult>& results) = 0;
67 
74  virtual std::vector<double> Predict(const TuneContext& context,
75  const ffi::Array<MeasureCandidate>& candidates) = 0;
76 
77  static constexpr const bool _type_mutable = true;
78  TVM_FFI_DECLARE_OBJECT_INFO("s_tir.meta_schedule.CostModel", CostModelNode, Object);
79 };
80 
83  public:
88  using FLoad = ffi::TypedFunction<void(ffi::String)>;
93  using FSave = ffi::TypedFunction<void(ffi::String)>;
101  using FUpdate = ffi::TypedFunction<void(const TuneContext&, const ffi::Array<MeasureCandidate>&,
102  const ffi::Array<RunnerResult>&)>;
109  using FPredict = ffi::TypedFunction<void(const TuneContext&, const ffi::Array<MeasureCandidate>&,
110  void* p_addr)>;
115  using FAsString = ffi::TypedFunction<ffi::String()>;
116 
127 
128  void Load(const ffi::String& path);
129  void Save(const ffi::String& path);
130  void Update(const TuneContext& context, const ffi::Array<MeasureCandidate>& candidates,
131  const ffi::Array<RunnerResult>& results);
132  std::vector<double> Predict(const TuneContext& context,
133  const ffi::Array<MeasureCandidate>& candidates);
134  TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.meta_schedule.PyCostModel", PyCostModelNode,
135  CostModelNode);
136 };
137 
142 class CostModel : public runtime::ObjectRef {
143  public:
153  TVM_DLL static CostModel PyCostModel(PyCostModelNode::FLoad f_load, //
154  PyCostModelNode::FSave f_save, //
155  PyCostModelNode::FUpdate f_update, //
156  PyCostModelNode::FPredict f_predict, //
157  PyCostModelNode::FAsString f_as_string);
159 };
160 
161 } // namespace meta_schedule
162 } // namespace s_tir
163 } // namespace tvm
164 
165 #endif // TVM_S_TIR_META_SCHEDULE_COST_MODEL_H_
Cost model.
Definition: cost_model.h:42
static constexpr const bool _type_mutable
Definition: cost_model.h:77
virtual void Save(const ffi::String &path)=0
Save the cost model to given file location.
TVM_FFI_DECLARE_OBJECT_INFO("s_tir.meta_schedule.CostModel", CostModelNode, Object)
virtual std::vector< double > Predict(const TuneContext &context, const ffi::Array< MeasureCandidate > &candidates)=0
Predict the normalized score (the larger the better) of given measure candidates.
virtual ~CostModelNode()=default
Virtual destructor.
virtual void Update(const TuneContext &context, const ffi::Array< MeasureCandidate > &candidates, const ffi::Array< RunnerResult > &results)=0
Update the cost model given running results.
virtual void Load(const ffi::String &path)=0
Load the cost model from given file location.
Managed reference to CostModelNode.
Definition: cost_model.h:142
static CostModel PyCostModel(PyCostModelNode::FLoad f_load, PyCostModelNode::FSave f_save, PyCostModelNode::FUpdate f_update, PyCostModelNode::FPredict f_predict, PyCostModelNode::FAsString f_as_string)
Create a feature extractor with customized methods on the python-side.
TVM_FFI_DEFINE_OBJECT_REF_METHODS_NULLABLE(CostModel, ObjectRef, CostModelNode)
The cost model with customized methods on the python-side.
Definition: cost_model.h:82
void Update(const TuneContext &context, const ffi::Array< MeasureCandidate > &candidates, const ffi::Array< RunnerResult > &results)
Update the cost model given running results.
void Save(const ffi::String &path)
Save the cost model to given file location.
ffi::TypedFunction< void(const TuneContext &, const ffi::Array< MeasureCandidate > &, void *p_addr)> FPredict
Predict the running results of given measure candidates.
Definition: cost_model.h:110
FUpdate f_update
The packed function to the Update function.
Definition: cost_model.h:122
FAsString f_as_string
The packed function to the AsString function.
Definition: cost_model.h:126
ffi::TypedFunction< void(const TuneContext &, const ffi::Array< MeasureCandidate > &, const ffi::Array< RunnerResult > &)> FUpdate
Update the cost model given running results.
Definition: cost_model.h:102
ffi::TypedFunction< void(ffi::String)> FSave
Save the cost model to given file location.
Definition: cost_model.h:93
FSave f_save
The packed function to the Save function.
Definition: cost_model.h:120
std::vector< double > Predict(const TuneContext &context, const ffi::Array< MeasureCandidate > &candidates)
Predict the normalized score (the larger the better) of given measure candidates.
void Load(const ffi::String &path)
Load the cost model from given file location.
FLoad f_load
The packed function to the Load function.
Definition: cost_model.h:118
ffi::TypedFunction< ffi::String()> FAsString
Get the cost model as string with name.
Definition: cost_model.h:115
TVM_FFI_DECLARE_OBJECT_INFO_FINAL("s_tir.meta_schedule.PyCostModel", PyCostModelNode, CostModelNode)
FPredict f_predict
The packed function to the Predict function.
Definition: cost_model.h:124
ffi::TypedFunction< void(ffi::String)> FLoad
Load the cost model from given file location.
Definition: cost_model.h:88
Managed reference to TuneContextNode.
Definition: tune_context.h:99
Performance counters for profiling via the PAPI library.
Definition: analyzer.h:37
A managed object in the TVM runtime.