You can not select more than 25 topics Topics must start with a chinese character,a letter or number, can include dashes ('-') and can be up to 35 characters long.

data_dumper.cc 36 kB

5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
4 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
4 years ago
4 years ago
5 years ago
5 years ago
5 years ago
4 years ago
4 years ago
4 years ago
4 years ago
5 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
4 years ago
5 years ago
4 years ago
5 years ago
5 years ago
5 years ago
4 years ago
5 years ago
5 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
4 years ago
5 years ago
4 years ago
5 years ago
5 years ago
5 years ago
4 years ago
5 years ago
5 years ago
4 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
5 years ago
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829
  1. /**
  2. * Copyright 2020 Huawei Technologies Co., Ltd
  3. *
  4. * Licensed under the Apache License, Version 2.0 (the "License");
  5. * you may not use this file except in compliance with the License.
  6. * You may obtain a copy of the License at
  7. *
  8. * http://www.apache.org/licenses/LICENSE-2.0
  9. *
  10. * Unless required by applicable law or agreed to in writing, software
  11. * distributed under the License is distributed on an "AS IS" BASIS,
  12. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13. * See the License for the specific language governing permissions and
  14. * limitations under the License.
  15. */
  16. #include "graph/load/model_manager/data_dumper.h"
  17. #include <cstdlib>
  18. #include <ctime>
  19. #include <map>
  20. #include <utility>
  21. #include <vector>
  22. #include "common/debug/memory_dumper.h"
  23. #include "common/properties_manager.h"
  24. #include "common/util.h"
  25. #include "framework/common/debug/ge_log.h"
  26. #include "framework/common/util.h"
  27. #include "graph/anchor.h"
  28. #include "graph/debug/ge_attr_define.h"
  29. #include "graph/load/model_manager/model_utils.h"
  30. #include "graph/manager/util/debug.h"
  31. #include "graph/utils/attr_utils.h"
  32. #include "graph/utils/tensor_utils.h"
  33. #include "proto/dump_task.pb.h"
  34. #include "proto/ge_ir.pb.h"
  35. #include "proto/op_mapping_info.pb.h"
  36. #include "runtime/base.h"
  37. #include "runtime/mem.h"
  38. namespace {
  39. const uint32_t kAicpuLoadFlag = 1;
  40. const uint32_t kAicpuUnloadFlag = 0;
  41. const int64_t kOpDebugSize = 2048;
  42. const int64_t kOpDebugShape = 2048;
  43. const int8_t kDecimal = 10;
  44. const uint32_t kAddrLen = sizeof(void *);
  45. const char *const kDumpOutput = "output";
  46. const char *const kDumpInput = "input";
  47. const char *const kDumpAll = "all";
  48. // parse for format like nodename:input:index
  49. static bool ParseNameIndex(const std::string &node_name_index, std::string &node_name, std::string &input_or_output,
  50. size_t &index) {
  51. auto sep = node_name_index.rfind(':');
  52. if (sep == std::string::npos) {
  53. return false;
  54. }
  55. auto index_str = node_name_index.substr(sep + 1);
  56. index = static_cast<size_t>(std::strtol(index_str.c_str(), nullptr, kDecimal));
  57. auto node_name_without_index = node_name_index.substr(0, sep);
  58. sep = node_name_without_index.rfind(':');
  59. if (sep == std::string::npos) {
  60. return false;
  61. }
  62. node_name = node_name_without_index.substr(0, sep);
  63. input_or_output = node_name_without_index.substr(sep + 1);
  64. return !(input_or_output != kDumpInput && input_or_output != kDumpOutput);
  65. }
  66. static bool IsTensorDescWithSkipDumpAddrType(bool has_mem_type_attr, vector<int64_t> v_memory_type, size_t i) {
  67. return has_mem_type_attr && (v_memory_type[i] == RT_MEMORY_L1);
  68. }
  69. } // namespace
  70. static int32_t GetIrDataType(ge::DataType data_type) {
  71. static const std::map<ge::DataType, ge::proto::DataType> data_type_map = {
  72. {ge::DT_UNDEFINED, ge::proto::DT_UNDEFINED},
  73. {ge::DT_FLOAT, ge::proto::DT_FLOAT},
  74. {ge::DT_FLOAT16, ge::proto::DT_FLOAT16},
  75. {ge::DT_INT8, ge::proto::DT_INT8},
  76. {ge::DT_UINT8, ge::proto::DT_UINT8},
  77. {ge::DT_INT16, ge::proto::DT_INT16},
  78. {ge::DT_UINT16, ge::proto::DT_UINT16},
  79. {ge::DT_INT32, ge::proto::DT_INT32},
  80. {ge::DT_INT64, ge::proto::DT_INT64},
  81. {ge::DT_UINT32, ge::proto::DT_UINT32},
  82. {ge::DT_UINT64, ge::proto::DT_UINT64},
  83. {ge::DT_BOOL, ge::proto::DT_BOOL},
  84. {ge::DT_DOUBLE, ge::proto::DT_DOUBLE},
  85. {ge::DT_DUAL, ge::proto::DT_DUAL},
  86. {ge::DT_DUAL_SUB_INT8, ge::proto::DT_DUAL_SUB_INT8},
  87. {ge::DT_DUAL_SUB_UINT8, ge::proto::DT_DUAL_SUB_UINT8},
  88. {ge::DT_COMPLEX64, ge::proto::DT_COMPLEX64},
  89. {ge::DT_COMPLEX128, ge::proto::DT_COMPLEX128},
  90. {ge::DT_QINT8, ge::proto::DT_QINT8},
  91. {ge::DT_QINT16, ge::proto::DT_QINT16},
  92. {ge::DT_QINT32, ge::proto::DT_QINT32},
  93. {ge::DT_QUINT8, ge::proto::DT_QUINT8},
  94. {ge::DT_QUINT16, ge::proto::DT_QUINT16},
  95. {ge::DT_RESOURCE, ge::proto::DT_RESOURCE},
  96. {ge::DT_STRING_REF, ge::proto::DT_STRING_REF},
  97. {ge::DT_STRING, ge::proto::DT_STRING},
  98. {ge::DT_VARIANT, ge::proto::DT_VARIANT},
  99. };
  100. auto iter = data_type_map.find(data_type);
  101. if (iter == data_type_map.end()) {
  102. return static_cast<int32_t>(ge::proto::DT_UNDEFINED);
  103. }
  104. return static_cast<int32_t>(iter->second);
  105. }
  106. namespace ge {
  107. DataDumper::~DataDumper() {
  108. ReleaseDevMem(&dev_mem_load_);
  109. ReleaseDevMem(&dev_mem_unload_);
  110. }
  111. void DataDumper::ReleaseDevMem(void **ptr) noexcept {
  112. if (ptr == nullptr) {
  113. return;
  114. }
  115. if (*ptr != nullptr) {
  116. rtError_t rt_ret = rtFree(*ptr);
  117. if (rt_ret != RT_ERROR_NONE) {
  118. GELOGE(RT_FAILED, "Call rtFree failed, ret: 0x%X", rt_ret);
  119. }
  120. *ptr = nullptr;
  121. }
  122. }
  123. void DataDumper::SetLoopAddr(void *global_step, void *loop_per_iter, void *loop_cond) {
  124. global_step_ = reinterpret_cast<uintptr_t>(global_step);
  125. loop_per_iter_ = reinterpret_cast<uintptr_t>(loop_per_iter);
  126. loop_cond_ = reinterpret_cast<uintptr_t>(loop_cond);
  127. }
  128. void DataDumper::SaveDumpInput(const std::shared_ptr<Node> &node) {
  129. if (node != nullptr) {
  130. auto input_op_desc = node->GetOpDesc();
  131. if (input_op_desc == nullptr) {
  132. GELOGE(PARAM_INVALID, "input op desc is null.");
  133. return;
  134. }
  135. for (auto &out_data_anchor : node->GetAllOutDataAnchors()) {
  136. for (auto &dst_in_data_anchor : out_data_anchor->GetPeerInDataAnchors()) {
  137. ge::NodePtr dst_node = dst_in_data_anchor->GetOwnerNode();
  138. auto op_desc = dst_node->GetOpDesc();
  139. if (op_desc == nullptr) {
  140. GELOGE(PARAM_INVALID, "input op desc is null.");
  141. return;
  142. }
  143. input_map_.insert(
  144. {op_desc->GetName(), {input_op_desc, dst_in_data_anchor->GetIdx(), out_data_anchor->GetIdx()}});
  145. }
  146. }
  147. }
  148. }
  149. void DataDumper::SaveEndGraphId(uint32_t task_id, uint32_t stream_id) {
  150. end_graph_task_id_ = task_id;
  151. end_graph_stream_id_ = stream_id;
  152. }
  153. void DataDumper::SaveOpDebugId(uint32_t task_id, uint32_t stream_id, void *op_debug_addr, bool is_op_debug) {
  154. op_debug_task_id_ = task_id;
  155. op_debug_stream_id_ = stream_id;
  156. op_debug_addr_ = op_debug_addr;
  157. is_op_debug_ = is_op_debug;
  158. }
  159. void DataDumper::SaveDumpTask(uint32_t task_id, uint32_t stream_id, const std::shared_ptr<OpDesc> &op_desc,
  160. uintptr_t args) {
  161. if (op_desc == nullptr) {
  162. GELOGE(PARAM_INVALID, "Opdesc is nullptr");
  163. return;
  164. }
  165. GELOGI("Save dump task %s, task id: %u, stream id: %u", op_desc->GetName().c_str(), task_id, stream_id);
  166. op_list_.push_back({task_id, stream_id, op_desc, args, true});
  167. for (auto iter = input_map_.equal_range(op_desc->GetName()); iter.first != iter.second; ++iter.first) {
  168. InnerInputMapping &inner_input_mapping = iter.first->second;
  169. auto &data_op = inner_input_mapping.data_op;
  170. if (data_op == nullptr) {
  171. GELOGE(PARAM_INVALID, "data_op is null.");
  172. return;
  173. }
  174. auto input_tensor = op_desc->GetInputDescPtr(inner_input_mapping.input_anchor_index);
  175. if (input_tensor == nullptr) {
  176. GELOGE(PARAM_INVALID, "input_tensor is null, index: %d, size: %zu.", inner_input_mapping.input_anchor_index,
  177. op_desc->GetInputsSize());
  178. return;
  179. }
  180. int64_t data_size = 0;
  181. if (AttrUtils::GetInt(input_tensor, ATTR_NAME_INPUT_ORIGIN_SIZE, data_size)) {
  182. GELOGI("Get aipp data size according to attr is %ld", data_size);
  183. } else if (TensorUtils::GetTensorSizeInBytes(*input_tensor, data_size) != SUCCESS) {
  184. GELOGE(PARAM_INVALID, "Get input size filed");
  185. return;
  186. }
  187. GELOGI("Save input dump task %s, id: %u,stream id :%u,data size :%ld", data_op->GetName().c_str(), task_id,
  188. stream_id, data_size);
  189. op_list_.push_back({task_id, stream_id, data_op, args, false, inner_input_mapping.input_anchor_index,
  190. inner_input_mapping.output_anchor_index, input_tensor->GetShape().GetDims(), data_size});
  191. }
  192. }
  193. static void SetOpMappingLoopAddr(uintptr_t step_id, uintptr_t loop_per_iter, uintptr_t loop_cond,
  194. aicpu::dump::OpMappingInfo &op_mapping_info) {
  195. if (step_id != 0) {
  196. GELOGI("step_id exists.");
  197. op_mapping_info.set_step_id_addr(static_cast<uint64_t>(step_id));
  198. }
  199. if (loop_per_iter != 0) {
  200. GELOGI("loop_per_iter exists.");
  201. op_mapping_info.set_iterations_per_loop_addr(static_cast<uint64_t>(loop_per_iter));
  202. }
  203. if (loop_cond != 0) {
  204. GELOGI("loop_cond exists.");
  205. op_mapping_info.set_loop_cond_addr(static_cast<uint64_t>(loop_cond));
  206. }
  207. }
  208. Status DataDumper::GenerateOutput(aicpu::dump::Output &output, const OpDesc::Vistor<GeTensorDesc> &tensor_descs,
  209. const uintptr_t &addr, size_t index) {
  210. output.set_data_type(static_cast<int32_t>(GetIrDataType(tensor_descs.at(index).GetDataType())));
  211. output.set_format(static_cast<int32_t>(tensor_descs.at(index).GetFormat()));
  212. for (auto dim : tensor_descs.at(index).GetShape().GetDims()) {
  213. output.mutable_shape()->add_dim(dim);
  214. }
  215. for (auto dim : tensor_descs.at(index).GetOriginShape().GetDims()) {
  216. output.mutable_origin_shape()->add_dim(dim);
  217. }
  218. int64_t output_size = 0;
  219. if (TensorUtils::GetTensorSizeInBytes(tensor_descs.at(index), output_size) != SUCCESS) {
  220. REPORT_CALL_ERROR("E19999", "Get tensor size fail");
  221. GELOGE(PARAM_INVALID, "Get output size filed");
  222. return PARAM_INVALID;
  223. }
  224. GELOGD("Get output size in dump is %ld", output_size);
  225. std::string origin_name;
  226. int32_t origin_output_index = -1;
  227. (void)AttrUtils::GetStr(&tensor_descs.at(index), ATTR_NAME_DATA_DUMP_ORIGIN_NAME, origin_name);
  228. (void)AttrUtils::GetInt(&tensor_descs.at(index), ATTR_NAME_DATA_DUMP_ORIGIN_OUTPUT_INDEX, origin_output_index);
  229. output.set_size(output_size);
  230. output.set_original_name(origin_name);
  231. output.set_original_output_index(origin_output_index);
  232. output.set_original_output_format(static_cast<int32_t>(tensor_descs.at(index).GetOriginFormat()));
  233. output.set_original_output_data_type(static_cast<int32_t>(tensor_descs.at(index).GetOriginDataType()));
  234. output.set_address(static_cast<uint64_t>(addr));
  235. return SUCCESS;
  236. }
  237. Status DataDumper::DumpRefOutput(const DataDumper::InnerDumpInfo &inner_dump_info, aicpu::dump::Output &output,
  238. size_t i, const std::string &node_name_index) {
  239. std::string dump_op_name;
  240. std::string input_or_output;
  241. size_t index;
  242. // parser and find which node's input or output tensor desc is chosen for dump info
  243. if (!ParseNameIndex(node_name_index, dump_op_name, input_or_output, index)) {
  244. GELOGE(PARAM_INVALID, "Op [%s] output desc[%zu] with invalid ATTR_DATA_DUMP_REF attr[%s].",
  245. inner_dump_info.op->GetName().c_str(), i, node_name_index.c_str());
  246. return PARAM_INVALID;
  247. }
  248. GE_CHECK_NOTNULL(compute_graph_);
  249. auto replace_node = compute_graph_->FindNode(dump_op_name);
  250. GE_RT_PARAM_INVALID_WITH_LOG_IF_TRUE(replace_node == nullptr,
  251. "Op [%s] output desc[%zu] with invalid ATTR_DATA_DUMP_REF attr[%s],"
  252. " cannot find redirect node[%s].",
  253. inner_dump_info.op->GetName().c_str(), i, node_name_index.c_str(),
  254. dump_op_name.c_str());
  255. auto replace_opdesc = replace_node->GetOpDesc();
  256. GE_CHECK_NOTNULL(replace_opdesc);
  257. auto iter = ref_info_.find(replace_opdesc);
  258. GE_RT_PARAM_INVALID_WITH_LOG_IF_TRUE(iter == ref_info_.end(),
  259. "Op [%s] output desc[%zu] cannot find any saved redirect node[%s]'s info.",
  260. inner_dump_info.op->GetName().c_str(), i, replace_opdesc->GetName().c_str());
  261. GE_CHECK_NOTNULL(iter->second);
  262. auto addr = reinterpret_cast<uintptr_t>(iter->second);
  263. if (input_or_output == kDumpInput) {
  264. const auto &replace_input_descs = replace_opdesc->GetAllInputsDesc();
  265. addr += kAddrLen * index;
  266. GE_CHK_STATUS_RET(GenerateOutput(output, replace_input_descs, addr, index), "Generate output failed");
  267. } else if (input_or_output == kDumpOutput) {
  268. const auto &replace_output_descs = replace_opdesc->GetAllOutputsDesc();
  269. const auto replace_input_size = replace_opdesc->GetAllInputsDesc().size();
  270. addr += (index + replace_input_size) * kAddrLen;
  271. GE_CHK_STATUS_RET(GenerateOutput(output, replace_output_descs, addr, index), "Generate output failed");
  272. }
  273. GELOGD("Op [%s] output desc[%zu] dump info is replaced by node[%s] [%s] tensor_desc [%zu]",
  274. inner_dump_info.op->GetName().c_str(), i, dump_op_name.c_str(), input_or_output.c_str(), index);
  275. return SUCCESS;
  276. }
  277. Status DataDumper::DumpOutputWithTask(const InnerDumpInfo &inner_dump_info, aicpu::dump::Task &task) {
  278. const auto &output_descs = inner_dump_info.op->GetAllOutputsDesc();
  279. const std::vector<void *> output_addrs = ModelUtils::GetOutputDataAddrs(*runtime_param_, inner_dump_info.op);
  280. if (output_descs.size() != output_addrs.size()) {
  281. REPORT_INNER_ERROR("E19999", "output_desc size:%zu != output addr size:%zu in op:%s(%s)",
  282. output_descs.size(), output_addrs.size(),
  283. inner_dump_info.op->GetName().c_str(), inner_dump_info.op->GetType().c_str());
  284. GELOGE(PARAM_INVALID, "Invalid output desc addrs size %zu, op %s has %zu output desc.", output_addrs.size(),
  285. inner_dump_info.op->GetName().c_str(), output_descs.size());
  286. return PARAM_INVALID;
  287. }
  288. std::vector<int64_t> v_memory_type;
  289. bool has_mem_type_attr = ge::AttrUtils::GetListInt(inner_dump_info.op, ATTR_NAME_OUTPUT_MEM_TYPE_LIST, v_memory_type);
  290. GE_RT_PARAM_INVALID_WITH_LOG_IF_TRUE(has_mem_type_attr && (v_memory_type.size() != output_descs.size()),
  291. "DumpOutputWithTask[%s], output size[%zu], output memory type size[%zu]",
  292. inner_dump_info.op->GetName().c_str(), output_descs.size(),
  293. v_memory_type.size());
  294. for (size_t i = 0; i < output_descs.size(); ++i) {
  295. aicpu::dump::Output output;
  296. std::string node_name_index;
  297. const auto &output_desc = output_descs.at(i);
  298. // check dump output tensor desc is redirected by attr ATTR_DATA_DUMP_REF
  299. if (AttrUtils::GetStr(&output_desc, ATTR_DATA_DUMP_REF, node_name_index)) {
  300. GE_CHK_STATUS_RET(DumpRefOutput(inner_dump_info, output, i, node_name_index), "DumpRefOutput failed");
  301. task.mutable_output()->Add(std::move(output));
  302. } else {
  303. if (IsTensorDescWithSkipDumpAddrType(has_mem_type_attr, v_memory_type, i)) {
  304. GELOGI("[L1Fusion] DumpOutputWithTask[%s] output[%zu] is l1 addr.", inner_dump_info.op->GetName().c_str(), i);
  305. int64_t output_size = 0;
  306. if (TensorUtils::GetTensorSizeInBytes(output_descs.at(i), output_size) != SUCCESS) {
  307. REPORT_CALL_ERROR("E19999", "Get output tensor size fail in op:%s(%s), index:%zu",
  308. inner_dump_info.op->GetName().c_str(), inner_dump_info.op->GetType().c_str(), i);
  309. GELOGE(PARAM_INVALID, "Get output size failed.");
  310. return PARAM_INVALID;
  311. }
  312. GELOGI("Get output size of l1_fusion_dump is %ld", output_size);
  313. GenerateOpBuffer(output_size, task);
  314. } else {
  315. const auto input_size = inner_dump_info.op->GetInputsSize();
  316. auto addr = inner_dump_info.args + (i + input_size) * kAddrLen;
  317. GE_CHK_STATUS_RET(GenerateOutput(output, output_descs, addr, i), "Generate output failed");
  318. task.mutable_output()->Add(std::move(output));
  319. }
  320. }
  321. }
  322. return SUCCESS;
  323. }
  324. Status DataDumper::DumpOutput(const InnerDumpInfo &inner_dump_info, aicpu::dump::Task &task) {
  325. GELOGI("Start dump output");
  326. if (inner_dump_info.is_task) {
  327. // tbe or aicpu op, these ops are with task
  328. return DumpOutputWithTask(inner_dump_info, task);
  329. }
  330. // else data, const or variable op
  331. aicpu::dump::Output output;
  332. auto output_tensor = inner_dump_info.op->GetOutputDescPtr(inner_dump_info.output_anchor_index);
  333. const std::vector<void *> output_addrs = ModelUtils::GetOutputDataAddrs(*runtime_param_, inner_dump_info.op);
  334. if (output_tensor == nullptr) {
  335. REPORT_INNER_ERROR("E19999", "output_desc tensor is nullptr in op:%s(%s), index:%u, "
  336. "check invalid",
  337. inner_dump_info.op->GetName().c_str(), inner_dump_info.op->GetType().c_str(),
  338. inner_dump_info.output_anchor_index);
  339. GELOGE(PARAM_INVALID, "output_tensor is null, index: %d, size: %zu.", inner_dump_info.output_anchor_index,
  340. inner_dump_info.op->GetOutputsSize());
  341. return PARAM_INVALID;
  342. }
  343. output.set_data_type(static_cast<int32_t>(GetIrDataType(output_tensor->GetDataType())));
  344. output.set_format(static_cast<int32_t>(output_tensor->GetFormat()));
  345. for (auto dim : inner_dump_info.dims) {
  346. output.mutable_shape()->add_dim(dim);
  347. }
  348. std::string origin_name;
  349. int32_t origin_output_index = -1;
  350. (void)AttrUtils::GetStr(output_tensor, ATTR_NAME_DATA_DUMP_ORIGIN_NAME, origin_name);
  351. (void)AttrUtils::GetInt(output_tensor, ATTR_NAME_DATA_DUMP_ORIGIN_OUTPUT_INDEX, origin_output_index);
  352. output.set_size(inner_dump_info.data_size);
  353. output.set_original_name(origin_name);
  354. output.set_original_output_index(origin_output_index);
  355. output.set_original_output_format(static_cast<int32_t>(output_tensor->GetOriginFormat()));
  356. output.set_original_output_data_type(static_cast<int32_t>(output_tensor->GetOriginDataType()));
  357. // due to lhisi virtual addr bug, cannot use args now
  358. if (inner_dump_info.output_anchor_index >= static_cast<int>(output_addrs.size())) {
  359. REPORT_INNER_ERROR("E19999", "output_anchor_index:%u >= output addr size:%zu in op:%s(%s), "
  360. "check invalid", inner_dump_info.output_anchor_index, output_addrs.size(),
  361. inner_dump_info.op->GetName().c_str(), inner_dump_info.op->GetType().c_str());
  362. GELOGE(FAILED, "Index is out of range.");
  363. return FAILED;
  364. }
  365. auto data_addr = inner_dump_info.args + kAddrLen * static_cast<uint32_t>(inner_dump_info.input_anchor_index);
  366. output.set_address(static_cast<uint64_t>(data_addr));
  367. task.mutable_output()->Add(std::move(output));
  368. return SUCCESS;
  369. }
  370. Status DataDumper::GenerateInput(aicpu::dump::Input &input, const OpDesc::Vistor<GeTensorDesc> &tensor_descs,
  371. const uintptr_t &addr, size_t index) {
  372. input.set_data_type(static_cast<int32_t>(GetIrDataType(tensor_descs.at(index).GetDataType())));
  373. input.set_format(static_cast<int32_t>(tensor_descs.at(index).GetFormat()));
  374. for (auto dim : tensor_descs.at(index).GetShape().GetDims()) {
  375. input.mutable_shape()->add_dim(dim);
  376. }
  377. for (auto dim : tensor_descs.at(index).GetOriginShape().GetDims()) {
  378. input.mutable_origin_shape()->add_dim(dim);
  379. }
  380. int64_t input_size = 0;
  381. if (AttrUtils::GetInt(tensor_descs.at(index), ATTR_NAME_INPUT_ORIGIN_SIZE, input_size)) {
  382. GELOGI("Get aipp input size according to attr is %ld", input_size);
  383. } else if (TensorUtils::GetTensorSizeInBytes(tensor_descs.at(index), input_size) != SUCCESS) {
  384. REPORT_CALL_ERROR("E19999", "Get tensor size fail");
  385. GELOGE(PARAM_INVALID, "Get input size filed");
  386. return PARAM_INVALID;
  387. }
  388. GELOGD("Get input size in dump is %ld", input_size);
  389. input.set_size(input_size);
  390. input.set_address(static_cast<uint64_t>(addr));
  391. return SUCCESS;
  392. }
  393. Status DataDumper::DumpRefInput(const DataDumper::InnerDumpInfo &inner_dump_info, aicpu::dump::Input &input, size_t i,
  394. const std::string &node_name_index) {
  395. std::string dump_op_name;
  396. std::string input_or_output;
  397. size_t index;
  398. // parser and find which node's input or output tensor desc is chosen for dump info
  399. if (!ParseNameIndex(node_name_index, dump_op_name, input_or_output, index)) {
  400. GELOGE(PARAM_INVALID, "Op [%s] input desc[%zu] with invalid ATTR_DATA_DUMP_REF attr[%s].",
  401. inner_dump_info.op->GetName().c_str(), i, node_name_index.c_str());
  402. return PARAM_INVALID;
  403. }
  404. GE_CHECK_NOTNULL(compute_graph_);
  405. auto replace_node = compute_graph_->FindNode(dump_op_name);
  406. GE_RT_PARAM_INVALID_WITH_LOG_IF_TRUE(replace_node == nullptr,
  407. "Op [%s] input desc[%zu] with invalid ATTR_DATA_DUMP_REF attr[%s],"
  408. " cannot find redirect node[%s].",
  409. inner_dump_info.op->GetName().c_str(), i, node_name_index.c_str(),
  410. dump_op_name.c_str());
  411. auto replace_opdesc = replace_node->GetOpDesc();
  412. GE_CHECK_NOTNULL(replace_opdesc);
  413. auto iter = ref_info_.find(replace_opdesc);
  414. GE_RT_PARAM_INVALID_WITH_LOG_IF_TRUE(iter == ref_info_.end(),
  415. "Op [%s] input desc[%zu] cannot find any saved redirect node[%s]'s info.",
  416. inner_dump_info.op->GetName().c_str(), i, replace_opdesc->GetName().c_str());
  417. GE_CHECK_NOTNULL(iter->second);
  418. auto addr = reinterpret_cast<uintptr_t>(iter->second);
  419. if (input_or_output == kDumpInput) {
  420. const auto &replace_input_descs = replace_opdesc->GetAllInputsDesc();
  421. addr += kAddrLen * index;
  422. GE_CHK_STATUS_RET(GenerateInput(input, replace_input_descs, addr, index), "Generate input failed");
  423. } else if (input_or_output == kDumpOutput) {
  424. const auto &replace_output_descs = replace_opdesc->GetAllOutputsDesc();
  425. const auto replace_input_size = replace_opdesc->GetAllInputsDesc().size();
  426. addr += (index + replace_input_size) * kAddrLen;
  427. GE_CHK_STATUS_RET(GenerateInput(input, replace_output_descs, addr, index), "Generate input failed");
  428. }
  429. GELOGD("Op [%s] input desc[%zu] dump info is replaced by node[%s] [%s] tensor_desc [%zu]",
  430. inner_dump_info.op->GetName().c_str(), i, dump_op_name.c_str(), input_or_output.c_str(), index);
  431. return SUCCESS;
  432. }
  433. Status DataDumper::DumpInput(const InnerDumpInfo &inner_dump_info, aicpu::dump::Task &task) {
  434. GELOGI("Start dump input");
  435. const auto &input_descs = inner_dump_info.op->GetAllInputsDesc();
  436. const std::vector<void *> input_addrs = ModelUtils::GetInputDataAddrs(*runtime_param_, inner_dump_info.op);
  437. if (input_descs.size() != input_addrs.size()) {
  438. REPORT_INNER_ERROR("E19999", "input_desc size:%zu != input addr size:%zu in op:%s(%s)",
  439. input_descs.size(), input_addrs.size(),
  440. inner_dump_info.op->GetName().c_str(), inner_dump_info.op->GetType().c_str());
  441. GELOGE(PARAM_INVALID, "Invalid input desc addrs size %zu, op %s has %zu input desc.", input_addrs.size(),
  442. inner_dump_info.op->GetName().c_str(), input_descs.size());
  443. return PARAM_INVALID;
  444. }
  445. std::vector<int64_t> v_memory_type;
  446. bool has_mem_type_attr = ge::AttrUtils::GetListInt(inner_dump_info.op, ATTR_NAME_INPUT_MEM_TYPE_LIST, v_memory_type);
  447. GE_RT_PARAM_INVALID_WITH_LOG_IF_TRUE(has_mem_type_attr && (v_memory_type.size() != input_descs.size()),
  448. "DumpInput[%s], input size[%zu], input memory type size[%zu]",
  449. inner_dump_info.op->GetName().c_str(), input_descs.size(), v_memory_type.size());
  450. for (size_t i = 0; i < input_descs.size(); ++i) {
  451. aicpu::dump::Input input;
  452. std::string node_name_index;
  453. // check dump input tensor desc is redirected by attr ATTR_DATA_DUMP_REF
  454. if (AttrUtils::GetStr(&input_descs.at(i), ATTR_DATA_DUMP_REF, node_name_index)) {
  455. GE_CHK_STATUS_RET(DumpRefInput(inner_dump_info, input, i, node_name_index), "DumpRefInput failed");
  456. task.mutable_input()->Add(std::move(input));
  457. // normal dump without attr
  458. } else {
  459. if (IsTensorDescWithSkipDumpAddrType(has_mem_type_attr, v_memory_type, i)) {
  460. GELOGI("[L1Fusion] DumpInput[%s] input[%zu] is l1 addr", inner_dump_info.op->GetName().c_str(), i);
  461. int64_t input_size = 0;
  462. if (AttrUtils::GetInt(input_descs.at(i), ATTR_NAME_INPUT_ORIGIN_SIZE, input_size)) {
  463. GELOGI("Get aipp input size according to attr is %ld", input_size);
  464. } else if (TensorUtils::GetTensorSizeInBytes(input_descs.at(i), input_size) != SUCCESS) {
  465. REPORT_CALL_ERROR("E19999", "Get input tensor size fail in op:%s(%s), index:%zu",
  466. inner_dump_info.op->GetName().c_str(), inner_dump_info.op->GetType().c_str(), i);
  467. GELOGE(PARAM_INVALID, "Get input size failed.");
  468. return PARAM_INVALID;
  469. }
  470. GELOGI("Get input size of l1_fusion_dump is %ld", input_size);
  471. GenerateOpBuffer(input_size, task);
  472. } else {
  473. auto addr = inner_dump_info.args + kAddrLen * i;
  474. GE_CHK_STATUS_RET(GenerateInput(input, input_descs, addr, i), "Generate input failed");
  475. task.mutable_input()->Add(std::move(input));
  476. }
  477. }
  478. }
  479. return SUCCESS;
  480. }
  481. void DataDumper::GenerateOpBuffer(const int64_t &size, aicpu::dump::Task &task) {
  482. aicpu::dump::OpBuffer op_buffer;
  483. op_buffer.set_buffer_type(aicpu::dump::BufferType::L1);
  484. op_buffer.set_address(reinterpret_cast<uintptr_t>(l1_fusion_addr_));
  485. op_buffer.set_size(size);
  486. task.mutable_buffer()->Add(std::move(op_buffer));
  487. }
  488. Status DataDumper::ExecuteLoadDumpInfo(aicpu::dump::OpMappingInfo &op_mapping_info) {
  489. std::string proto_str;
  490. size_t proto_size = op_mapping_info.ByteSizeLong();
  491. bool ret = op_mapping_info.SerializeToString(&proto_str);
  492. if (!ret || proto_size == 0) {
  493. REPORT_INNER_ERROR("E19999", "Serialize proto to string fail");
  494. GELOGE(PARAM_INVALID, "Protobuf SerializeToString failed, proto size %zu.", proto_size);
  495. return PARAM_INVALID;
  496. }
  497. if (dev_mem_load_ != nullptr) {
  498. GELOGW("dev_mem_load_ has been used.");
  499. ReleaseDevMem(&dev_mem_load_);
  500. }
  501. rtError_t rt_ret = rtMalloc(&dev_mem_load_, proto_size, RT_MEMORY_HBM);
  502. if (rt_ret != RT_ERROR_NONE) {
  503. REPORT_CALL_ERROR("E19999", "Call rtMalloc failed, size:%zu, ret:0x%X",
  504. proto_size, rt_ret);
  505. GELOGE(RT_FAILED, "Call rtMalloc failed, ret: 0x%X", rt_ret);
  506. return RT_ERROR_TO_GE_STATUS(rt_ret);
  507. }
  508. GE_PRINT_DYNAMIC_MEMORY(rtMalloc, "load dump information.", proto_size)
  509. rt_ret = rtMemcpy(dev_mem_load_, proto_size, proto_str.c_str(), proto_size, RT_MEMCPY_HOST_TO_DEVICE);
  510. if (rt_ret != RT_ERROR_NONE) {
  511. REPORT_CALL_ERROR("E19999", "Call rtMemcpy failed, size:%zu, ret:0x%X",
  512. proto_size, rt_ret);
  513. GELOGE(RT_FAILED, "Call rtMemcpy failed, ret: 0x%X", rt_ret);
  514. return RT_ERROR_TO_GE_STATUS(rt_ret);
  515. }
  516. rt_ret = rtDatadumpInfoLoad(dev_mem_load_, proto_size);
  517. if (rt_ret != RT_ERROR_NONE) {
  518. REPORT_CALL_ERROR("E19999", "Call rtDatadumpInfoLoad failed, ret:0x%X", rt_ret);
  519. GELOGE(RT_FAILED, "Call rtDatadumpInfoLoad failed, ret: 0x%X", rt_ret);
  520. return RT_ERROR_TO_GE_STATUS(rt_ret);
  521. }
  522. load_flag_ = true;
  523. GELOGI("LoadDumpInfo success, proto size is: %zu.", proto_size);
  524. return SUCCESS;
  525. }
  526. Status DataDumper::ExecuteUnLoadDumpInfo(aicpu::dump::OpMappingInfo &op_mapping_info) {
  527. std::string proto_str;
  528. size_t proto_size = op_mapping_info.ByteSizeLong();
  529. bool ret = op_mapping_info.SerializeToString(&proto_str);
  530. if (!ret || proto_size == 0) {
  531. REPORT_INNER_ERROR("E19999", "Serialize proto to string fail");
  532. GELOGE(PARAM_INVALID, "Protobuf SerializeToString failed, proto size %zu.", proto_size);
  533. return PARAM_INVALID;
  534. }
  535. if (dev_mem_unload_ != nullptr) {
  536. GELOGW("dev_mem_unload_ has been used.");
  537. ReleaseDevMem(&dev_mem_unload_);
  538. }
  539. rtError_t rt_ret = rtMalloc(&dev_mem_unload_, proto_size, RT_MEMORY_HBM);
  540. if (rt_ret != RT_ERROR_NONE) {
  541. REPORT_CALL_ERROR("E19999", "Call rtMalloc failed, size:%zu, ret:0x%X",
  542. proto_size, rt_ret);
  543. GELOGE(RT_FAILED, "Call rtMalloc failed, ret: 0x%X", rt_ret);
  544. return RT_ERROR_TO_GE_STATUS(rt_ret);
  545. }
  546. GE_PRINT_DYNAMIC_MEMORY(rtMalloc, "unload dump information.", proto_size)
  547. rt_ret = rtMemcpy(dev_mem_unload_, proto_size, proto_str.c_str(), proto_size, RT_MEMCPY_HOST_TO_DEVICE);
  548. if (rt_ret != RT_ERROR_NONE) {
  549. REPORT_CALL_ERROR("E19999", "Call rtMemcpy failed, size:%zu, ret:0x%X",
  550. proto_size, rt_ret);
  551. GELOGE(RT_FAILED, "Call rtMemcpy failed, ret: 0x%X", rt_ret);
  552. return RT_ERROR_TO_GE_STATUS(rt_ret);
  553. }
  554. rt_ret = rtDatadumpInfoLoad(dev_mem_unload_, proto_size);
  555. if (rt_ret != RT_ERROR_NONE) {
  556. REPORT_CALL_ERROR("E19999", "Call rtDatadumpInfoLoad failed, ret:0x%X", rt_ret);
  557. GELOGE(RT_FAILED, "Call rtDatadumpInfoLoad failed, ret: 0x%X", rt_ret);
  558. return RT_ERROR_TO_GE_STATUS(rt_ret);
  559. }
  560. load_flag_ = false;
  561. GELOGI("UnloadDumpInfo success, proto size is: %zu.", proto_size);
  562. return SUCCESS;
  563. }
  564. Status DataDumper::LoadDumpInfo() {
  565. std::string dump_list_key;
  566. PrintCheckLog(dump_list_key);
  567. if (op_list_.empty()) {
  568. GELOGD("op_list_ is empty");
  569. }
  570. aicpu::dump::OpMappingInfo op_mapping_info;
  571. auto dump_path = dump_properties_.GetDumpPath() + std::to_string(device_id_) + "/";
  572. op_mapping_info.set_dump_path(dump_path);
  573. op_mapping_info.set_model_name(dump_list_key);
  574. op_mapping_info.set_model_id(model_id_);
  575. op_mapping_info.set_flag(kAicpuLoadFlag);
  576. op_mapping_info.set_dump_step(dump_properties_.GetDumpStep());
  577. SetOpMappingLoopAddr(global_step_, loop_per_iter_, loop_cond_, op_mapping_info);
  578. auto ret = BuildTaskInfo(op_mapping_info);
  579. if (ret != SUCCESS) {
  580. GELOGE(ret, "Build task info failed");
  581. return ret;
  582. }
  583. SetEndGraphIdToAicpu(end_graph_task_id_, end_graph_stream_id_, op_mapping_info);
  584. SetOpDebugIdToAicpu(op_debug_task_id_, op_debug_stream_id_, op_debug_addr_, op_mapping_info);
  585. if (!op_list_.empty() || is_op_debug_ || is_end_graph_) {
  586. auto ret = ExecuteLoadDumpInfo(op_mapping_info);
  587. if (ret != SUCCESS) {
  588. GELOGE(ret, "Execute load dump info failed");
  589. return ret;
  590. }
  591. }
  592. return SUCCESS;
  593. }
  594. Status DataDumper::BuildTaskInfo(aicpu::dump::OpMappingInfo &op_mapping_info) {
  595. for (const auto &op_iter : op_list_) {
  596. auto op_desc = op_iter.op;
  597. GELOGD("Op %s in model begin to add task in op_mapping_info", op_desc->GetName().c_str());
  598. aicpu::dump::Task task;
  599. task.set_end_graph(false);
  600. task.set_task_id(op_iter.task_id);
  601. task.set_stream_id(op_iter.stream_id);
  602. task.mutable_op()->set_op_name(op_desc->GetName());
  603. task.mutable_op()->set_op_type(op_desc->GetType());
  604. if (dump_properties_.GetDumpMode() == kDumpOutput) {
  605. Status ret = DumpOutput(op_iter, task);
  606. if (ret != SUCCESS) {
  607. GELOGE(ret, "Dump output failed");
  608. return ret;
  609. }
  610. op_mapping_info.mutable_task()->Add(std::move(task));
  611. continue;
  612. }
  613. if (dump_properties_.GetDumpMode() == kDumpInput) {
  614. if (op_iter.is_task) {
  615. Status ret = DumpInput(op_iter, task);
  616. if (ret != SUCCESS) {
  617. GELOGE(ret, "Dump input failed");
  618. return ret;
  619. }
  620. }
  621. op_mapping_info.mutable_task()->Add(std::move(task));
  622. continue;
  623. }
  624. if (dump_properties_.GetDumpMode() == kDumpAll || is_op_debug_) {
  625. auto ret = DumpOutput(op_iter, task);
  626. if (ret != SUCCESS) {
  627. GELOGE(ret, "Dump output failed when in dumping all");
  628. return ret;
  629. }
  630. if (op_iter.is_task) {
  631. ret = DumpInput(op_iter, task);
  632. if (ret != SUCCESS) {
  633. GELOGE(ret, "Dump input failed when in dumping all");
  634. return ret;
  635. }
  636. }
  637. op_mapping_info.mutable_task()->Add(std::move(task));
  638. continue;
  639. }
  640. }
  641. return SUCCESS;
  642. }
  643. void DataDumper::SetEndGraphIdToAicpu(uint32_t task_id, uint32_t stream_id,
  644. aicpu::dump::OpMappingInfo &op_mapping_info) {
  645. if (dump_properties_.GetDumpMode() == kDumpOutput || dump_properties_.GetDumpMode() == kDumpInput ||
  646. dump_properties_.GetDumpMode() == kDumpAll) {
  647. aicpu::dump::Task task;
  648. task.set_end_graph(true);
  649. task.set_task_id(end_graph_task_id_);
  650. task.set_stream_id(end_graph_stream_id_);
  651. task.mutable_op()->set_op_name(NODE_NAME_END_GRAPH);
  652. task.mutable_op()->set_op_type(ENDGRAPH);
  653. op_mapping_info.mutable_task()->Add(std::move(task));
  654. is_end_graph_ = true;
  655. if (op_mapping_info.model_name_param_case() == aicpu::dump::OpMappingInfo::kModelName) {
  656. GELOGI("Add end_graph_info to aicpu, model_name is %s, task_id is %u, stream_id is %u",
  657. op_mapping_info.model_name().c_str(), end_graph_task_id_, end_graph_stream_id_);
  658. return;
  659. }
  660. GELOGI("Add end_graph_info to aicpu, task_id is %u, stream_id is %u", end_graph_task_id_, end_graph_stream_id_);
  661. }
  662. }
  663. void DataDumper::SetOpDebugIdToAicpu(uint32_t task_id, uint32_t stream_id, void *op_debug_addr,
  664. aicpu::dump::OpMappingInfo &op_mapping_info) {
  665. if (is_op_debug_) {
  666. GELOGI("add op_debug_info to aicpu, task_id is %u, stream_id is %u", task_id, stream_id);
  667. aicpu::dump::Task task;
  668. task.set_end_graph(false);
  669. task.set_task_id(task_id);
  670. task.set_stream_id(stream_id);
  671. task.mutable_op()->set_op_name(NODE_NAME_OP_DEBUG);
  672. task.mutable_op()->set_op_type(OP_TYPE_OP_DEBUG);
  673. // set output
  674. aicpu::dump::Output output;
  675. output.set_data_type(DT_UINT8);
  676. output.set_format(FORMAT_ND);
  677. output.mutable_shape()->add_dim(kOpDebugShape);
  678. output.set_original_name(NODE_NAME_OP_DEBUG);
  679. output.set_original_output_index(0);
  680. output.set_original_output_format(FORMAT_ND);
  681. output.set_original_output_data_type(DT_UINT8);
  682. // due to lhisi virtual addr bug, cannot use args now
  683. output.set_address(static_cast<uint64_t>(reinterpret_cast<uintptr_t>(op_debug_addr)));
  684. output.set_size(kOpDebugSize);
  685. task.mutable_output()->Add(std::move(output));
  686. op_mapping_info.mutable_task()->Add(std::move(task));
  687. }
  688. }
  689. Status DataDumper::UnloadDumpInfo() {
  690. if (!load_flag_) {
  691. load_flag_ = false;
  692. return SUCCESS;
  693. }
  694. GELOGI("UnloadDumpInfo start.");
  695. aicpu::dump::OpMappingInfo op_mapping_info;
  696. op_mapping_info.set_model_id(model_id_);
  697. op_mapping_info.set_flag(kAicpuUnloadFlag);
  698. for (const auto &op_iter : op_list_) {
  699. aicpu::dump::Task task;
  700. task.set_task_id(op_iter.task_id);
  701. task.set_stream_id(op_iter.stream_id);
  702. op_mapping_info.mutable_task()->Add(std::move(task));
  703. }
  704. auto ret = ExecuteUnLoadDumpInfo(op_mapping_info);
  705. if (ret != SUCCESS) {
  706. GELOGE(ret, "Execute unload dump info failed");
  707. return ret;
  708. }
  709. return SUCCESS;
  710. }
  711. void DataDumper::DumpShrink() {
  712. compute_graph_.reset();
  713. input_map_.clear();
  714. ref_info_.clear();
  715. }
  716. void DataDumper::PrintCheckLog(string &dump_list_key) {
  717. std::set<std::string> model_list = dump_properties_.GetAllDumpModel();
  718. if (model_list.empty()) {
  719. return;
  720. }
  721. bool not_find_by_omname = model_list.find(om_name_) == model_list.end();
  722. bool not_find_by_modelname = model_list.find(model_name_) == model_list.end();
  723. dump_list_key = not_find_by_omname ? model_name_ : om_name_;
  724. GELOGI("%zu op need dump in known shape model %s.", op_list_.size(), dump_list_key.c_str());
  725. if (model_list.find(DUMP_ALL_MODEL) == model_list.end()) {
  726. if (not_find_by_omname && not_find_by_modelname) {
  727. std::string model_list_str;
  728. for (auto &model : model_list) {
  729. model_list_str += "[" + model + "].";
  730. }
  731. GELOGW("Model %s will not be set to dump, dump list: %s", dump_list_key.c_str(), model_list_str.c_str());
  732. return;
  733. }
  734. }
  735. std::set<std::string> config_dump_op_list = dump_properties_.GetPropertyValue(dump_list_key);
  736. std::set<std::string> dump_op_list;
  737. for (auto &inner_dump_info : op_list_) {
  738. // oplist value OpDescPtr is not nullptr
  739. dump_op_list.insert(inner_dump_info.op->GetName());
  740. }
  741. for (auto &dump_op : config_dump_op_list) {
  742. if (dump_op_list.find(dump_op) == dump_op_list.end()) {
  743. GELOGW("Op %s set to dump but not exist in model %s or not a valid op.", dump_op.c_str(), dump_list_key.c_str());
  744. }
  745. }
  746. }
  747. } // namespace ge

图引擎模块(GE)是MindSpore的一个子模块,其代码由C++实现,位于前端模块ME和底层硬件之间,起到承接作用。图引擎模块以ME下发的图作为输入,然后进行一系列的深度图优化操作,最后输出一张可以在底层硬件上高效运行的图。GE针对昇腾AI处理器的硬件结构特点,做了特定的优化工作,以此来充分发挥出昇腾AI处理器的强大算力。在进行模型训练/推理时,GE会被自动调用而用户并不感知。GE主要由GE API和GE Core两部分组成,详细的架构图如下所示