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.

python_bindings.cc 33 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
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665
  1. /**
  2. * Copyright 2019 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 <exception>
  17. #include "dataset/api/de_pipeline.h"
  18. #include "dataset/kernels/no_op.h"
  19. #include "dataset/kernels/data/one_hot_op.h"
  20. #include "dataset/kernels/image/center_crop_op.h"
  21. #include "dataset/kernels/image/cut_out_op.h"
  22. #include "dataset/kernels/image/decode_op.h"
  23. #include "dataset/kernels/image/hwc_to_chw_op.h"
  24. #include "dataset/kernels/image/image_utils.h"
  25. #include "dataset/kernels/image/normalize_op.h"
  26. #include "dataset/kernels/image/pad_op.h"
  27. #include "dataset/kernels/image/random_color_adjust_op.h"
  28. #include "dataset/kernels/image/random_crop_decode_resize_op.h"
  29. #include "dataset/kernels/image/random_crop_and_resize_op.h"
  30. #include "dataset/kernels/image/random_crop_op.h"
  31. #include "dataset/kernels/image/random_horizontal_flip_op.h"
  32. #include "dataset/kernels/image/random_resize_op.h"
  33. #include "dataset/kernels/image/random_rotation_op.h"
  34. #include "dataset/kernels/image/random_vertical_flip_op.h"
  35. #include "dataset/kernels/image/rescale_op.h"
  36. #include "dataset/kernels/image/resize_bilinear_op.h"
  37. #include "dataset/kernels/image/resize_op.h"
  38. #include "dataset/kernels/image/uniform_aug_op.h"
  39. #include "dataset/kernels/data/type_cast_op.h"
  40. #include "dataset/engine/datasetops/source/cifar_op.h"
  41. #include "dataset/engine/datasetops/source/image_folder_op.h"
  42. #include "dataset/engine/datasetops/source/io_block.h"
  43. #include "dataset/engine/datasetops/source/mnist_op.h"
  44. #include "dataset/engine/datasetops/source/manifest_op.h"
  45. #include "dataset/engine/datasetops/source/mindrecord_op.h"
  46. #include "dataset/engine/datasetops/source/random_data_op.h"
  47. #include "dataset/engine/datasetops/source/sampler/distributed_sampler.h"
  48. #include "dataset/engine/datasetops/source/sampler/pk_sampler.h"
  49. #include "dataset/engine/datasetops/source/sampler/random_sampler.h"
  50. #include "dataset/engine/datasetops/source/sampler/sequential_sampler.h"
  51. #include "dataset/engine/datasetops/source/sampler/subset_random_sampler.h"
  52. #include "dataset/engine/datasetops/source/sampler/weighted_random_sampler.h"
  53. #include "dataset/engine/datasetops/source/sampler/python_sampler.h"
  54. #include "dataset/engine/datasetops/source/tf_reader_op.h"
  55. #include "dataset/engine/jagged_connector.h"
  56. #include "dataset/engine/datasetops/source/text_file_op.h"
  57. #include "dataset/engine/datasetops/source/voc_op.h"
  58. #include "dataset/engine/datasetops/source/coco_op.h"
  59. #include "dataset/engine/gnn/graph.h"
  60. #include "dataset/kernels/data/to_float16_op.h"
  61. #include "dataset/text/kernels/jieba_tokenizer_op.h"
  62. #include "dataset/text/kernels/ngram_op.h"
  63. #include "dataset/text/kernels/unicode_char_tokenizer_op.h"
  64. #include "dataset/text/vocab.h"
  65. #include "dataset/text/kernels/lookup_op.h"
  66. #include "dataset/util/random.h"
  67. #include "mindrecord/include/shard_operator.h"
  68. #include "mindrecord/include/shard_pk_sample.h"
  69. #include "mindrecord/include/shard_distributed_sample.h"
  70. #include "mindrecord/include/shard_sample.h"
  71. #include "pybind11/pybind11.h"
  72. #include "pybind11/stl.h"
  73. #include "pybind11/stl_bind.h"
  74. namespace py = pybind11;
  75. namespace mindspore {
  76. namespace dataset {
  77. #define THROW_IF_ERROR(s) \
  78. do { \
  79. Status rc = std::move(s); \
  80. if (rc.IsError()) throw std::runtime_error(rc.ToString()); \
  81. } while (false)
  82. void bindDEPipeline(py::module *m) {
  83. (void)py::class_<DEPipeline>(*m, "DEPipeline")
  84. .def(py::init<>())
  85. .def(
  86. "AddNodeToTree",
  87. [](DEPipeline &de, const OpName &op_name, const py::dict &args) {
  88. DsOpPtr op;
  89. THROW_IF_ERROR(de.AddNodeToTree(op_name, args, &op));
  90. return op;
  91. },
  92. py::return_value_policy::reference)
  93. .def_static("AddChildToParentNode",
  94. [](const DsOpPtr &child_op, const DsOpPtr &parent_op) {
  95. THROW_IF_ERROR(DEPipeline::AddChildToParentNode(child_op, parent_op));
  96. })
  97. .def("AssignRootNode",
  98. [](DEPipeline &de, const DsOpPtr &dataset_op) { THROW_IF_ERROR(de.AssignRootNode(dataset_op)); })
  99. .def("SetBatchParameters",
  100. [](DEPipeline &de, const py::dict &args) { THROW_IF_ERROR(de.SetBatchParameters(args)); })
  101. .def("LaunchTreeExec", [](DEPipeline &de) { THROW_IF_ERROR(de.LaunchTreeExec()); })
  102. .def("GetNextAsMap",
  103. [](DEPipeline &de) {
  104. py::dict out;
  105. THROW_IF_ERROR(de.GetNextAsMap(&out));
  106. return out;
  107. })
  108. .def("GetNextAsList",
  109. [](DEPipeline &de) {
  110. py::list out;
  111. THROW_IF_ERROR(de.GetNextAsList(&out));
  112. return out;
  113. })
  114. .def("GetOutputShapes",
  115. [](DEPipeline &de) {
  116. py::list out;
  117. THROW_IF_ERROR(de.GetOutputShapes(&out));
  118. return out;
  119. })
  120. .def("GetOutputTypes",
  121. [](DEPipeline &de) {
  122. py::list out;
  123. THROW_IF_ERROR(de.GetOutputTypes(&out));
  124. return out;
  125. })
  126. .def("GetDatasetSize", &DEPipeline::GetDatasetSize)
  127. .def("GetBatchSize", &DEPipeline::GetBatchSize)
  128. .def("GetNumClasses", &DEPipeline::GetNumClasses)
  129. .def("GetRepeatCount", &DEPipeline::GetRepeatCount);
  130. }
  131. void bindDatasetOps(py::module *m) {
  132. (void)py::class_<TFReaderOp, DatasetOp, std::shared_ptr<TFReaderOp>>(*m, "TFReaderOp")
  133. .def_static("get_num_rows", [](const py::list &files, int64_t numParallelWorkers, bool estimate = false) {
  134. int64_t count = 0;
  135. std::vector<std::string> filenames;
  136. for (auto l : files) {
  137. !l.is_none() ? filenames.push_back(py::str(l)) : (void)filenames.emplace_back("");
  138. }
  139. THROW_IF_ERROR(TFReaderOp::CountTotalRows(&count, filenames, numParallelWorkers, estimate));
  140. return count;
  141. });
  142. (void)py::class_<CifarOp, DatasetOp, std::shared_ptr<CifarOp>>(*m, "CifarOp")
  143. .def_static("get_num_rows", [](const std::string &dir, bool isCifar10) {
  144. int64_t count = 0;
  145. THROW_IF_ERROR(CifarOp::CountTotalRows(dir, isCifar10, &count));
  146. return count;
  147. });
  148. (void)py::class_<ImageFolderOp, DatasetOp, std::shared_ptr<ImageFolderOp>>(*m, "ImageFolderOp")
  149. .def_static("get_num_rows_and_classes", [](const std::string &path) {
  150. int64_t count = 0, num_classes = 0;
  151. THROW_IF_ERROR(ImageFolderOp::CountRowsAndClasses(path, std::set<std::string>{}, &count, &num_classes));
  152. return py::make_tuple(count, num_classes);
  153. });
  154. (void)py::class_<MindRecordOp, DatasetOp, std::shared_ptr<MindRecordOp>>(*m, "MindRecordOp")
  155. .def_static("get_num_rows", [](const std::vector<std::string> &paths, bool load_dataset, const py::object &sampler,
  156. const int64_t num_padded) {
  157. int64_t count = 0;
  158. std::shared_ptr<mindrecord::ShardOperator> op;
  159. if (py::hasattr(sampler, "_create_for_minddataset")) {
  160. auto create = sampler.attr("_create_for_minddataset");
  161. op = create().cast<std::shared_ptr<mindrecord::ShardOperator>>();
  162. }
  163. THROW_IF_ERROR(MindRecordOp::CountTotalRows(paths, load_dataset, op, &count, num_padded));
  164. return count;
  165. });
  166. (void)py::class_<ManifestOp, DatasetOp, std::shared_ptr<ManifestOp>>(*m, "ManifestOp")
  167. .def_static("get_num_rows_and_classes",
  168. [](const std::string &file, const py::dict &dict, const std::string &usage) {
  169. int64_t count = 0, num_classes = 0;
  170. THROW_IF_ERROR(ManifestOp::CountTotalRows(file, dict, usage, &count, &num_classes));
  171. return py::make_tuple(count, num_classes);
  172. })
  173. .def_static("get_class_indexing", [](const std::string &file, const py::dict &dict, const std::string &usage) {
  174. std::map<std::string, int32_t> output_class_indexing;
  175. THROW_IF_ERROR(ManifestOp::GetClassIndexing(file, dict, usage, &output_class_indexing));
  176. return output_class_indexing;
  177. });
  178. (void)py::class_<MnistOp, DatasetOp, std::shared_ptr<MnistOp>>(*m, "MnistOp")
  179. .def_static("get_num_rows", [](const std::string &dir) {
  180. int64_t count = 0;
  181. THROW_IF_ERROR(MnistOp::CountTotalRows(dir, &count));
  182. return count;
  183. });
  184. (void)py::class_<TextFileOp, DatasetOp, std::shared_ptr<TextFileOp>>(*m, "TextFileOp")
  185. .def_static("get_num_rows", [](const py::list &files) {
  186. int64_t count = 0;
  187. std::vector<std::string> filenames;
  188. for (auto file : files) {
  189. !file.is_none() ? filenames.push_back(py::str(file)) : (void)filenames.emplace_back("");
  190. }
  191. THROW_IF_ERROR(TextFileOp::CountAllFileRows(filenames, &count));
  192. return count;
  193. });
  194. (void)py::class_<VOCOp, DatasetOp, std::shared_ptr<VOCOp>>(*m, "VOCOp")
  195. .def_static("get_num_rows",
  196. [](const std::string &dir, const std::string &task_type, const std::string &task_mode,
  197. const py::dict &dict, int64_t numSamples) {
  198. int64_t count = 0;
  199. THROW_IF_ERROR(VOCOp::CountTotalRows(dir, task_type, task_mode, dict, &count));
  200. return count;
  201. })
  202. .def_static("get_class_indexing", [](const std::string &dir, const std::string &task_type,
  203. const std::string &task_mode, const py::dict &dict) {
  204. std::map<std::string, int32_t> output_class_indexing;
  205. THROW_IF_ERROR(VOCOp::GetClassIndexing(dir, task_type, task_mode, dict, &output_class_indexing));
  206. return output_class_indexing;
  207. });
  208. (void)py::class_<CocoOp, DatasetOp, std::shared_ptr<CocoOp>>(*m, "CocoOp")
  209. .def_static("get_class_indexing",
  210. [](const std::string &dir, const std::string &file, const std::string &task) {
  211. std::vector<std::pair<std::string, std::vector<int32_t>>> output_class_indexing;
  212. THROW_IF_ERROR(CocoOp::GetClassIndexing(dir, file, task, &output_class_indexing));
  213. return output_class_indexing;
  214. })
  215. .def_static("get_num_rows", [](const std::string &dir, const std::string &file, const std::string &task) {
  216. int64_t count = 0;
  217. THROW_IF_ERROR(CocoOp::CountTotalRows(dir, file, task, &count));
  218. return count;
  219. });
  220. }
  221. void bindTensor(py::module *m) {
  222. (void)py::class_<GlobalContext>(*m, "GlobalContext")
  223. .def_static("config_manager", &GlobalContext::config_manager, py::return_value_policy::reference);
  224. (void)py::class_<ConfigManager, std::shared_ptr<ConfigManager>>(*m, "ConfigManager")
  225. .def("__str__", &ConfigManager::ToString)
  226. .def("set_rows_per_buffer", &ConfigManager::set_rows_per_buffer)
  227. .def("set_num_parallel_workers", &ConfigManager::set_num_parallel_workers)
  228. .def("set_worker_connector_size", &ConfigManager::set_worker_connector_size)
  229. .def("set_op_connector_size", &ConfigManager::set_op_connector_size)
  230. .def("set_seed", &ConfigManager::set_seed)
  231. .def("set_monitor_sampling_interval", &ConfigManager::set_monitor_sampling_interval)
  232. .def("get_rows_per_buffer", &ConfigManager::rows_per_buffer)
  233. .def("get_num_parallel_workers", &ConfigManager::num_parallel_workers)
  234. .def("get_worker_connector_size", &ConfigManager::worker_connector_size)
  235. .def("get_op_connector_size", &ConfigManager::op_connector_size)
  236. .def("get_seed", &ConfigManager::seed)
  237. .def("get_monitor_sampling_interval", &ConfigManager::monitor_sampling_interval)
  238. .def("load", [](ConfigManager &c, std::string s) { (void)c.LoadFile(s); });
  239. (void)py::class_<Tensor, std::shared_ptr<Tensor>>(*m, "Tensor", py::buffer_protocol())
  240. .def(py::init([](py::array arr) {
  241. std::shared_ptr<Tensor> out;
  242. THROW_IF_ERROR(Tensor::CreateTensor(&out, arr));
  243. return out;
  244. }))
  245. .def_buffer([](Tensor &tensor) {
  246. py::buffer_info info;
  247. THROW_IF_ERROR(Tensor::GetBufferInfo(tensor, &info));
  248. return info;
  249. })
  250. .def("__str__", &Tensor::ToString)
  251. .def("shape", &Tensor::shape)
  252. .def("type", &Tensor::type)
  253. .def("as_array", [](py::object &t) {
  254. auto &tensor = py::cast<Tensor &>(t);
  255. if (tensor.type() == DataType::DE_STRING) {
  256. py::array res;
  257. tensor.GetDataAsNumpyStrings(&res);
  258. return res;
  259. }
  260. py::buffer_info info;
  261. THROW_IF_ERROR(Tensor::GetBufferInfo(tensor, &info));
  262. return py::array(pybind11::dtype(info), info.shape, info.strides, info.ptr, t);
  263. });
  264. (void)py::class_<TensorShape>(*m, "TensorShape")
  265. .def(py::init<py::list>())
  266. .def("__str__", &TensorShape::ToString)
  267. .def("as_list", &TensorShape::AsPyList)
  268. .def("is_known", &TensorShape::known);
  269. (void)py::class_<DataType>(*m, "DataType")
  270. .def(py::init<std::string>())
  271. .def(py::self == py::self)
  272. .def("__str__", &DataType::ToString)
  273. .def("__deepcopy__", [](py::object &t, py::dict memo) { return t; });
  274. }
  275. void bindTensorOps1(py::module *m) {
  276. (void)py::class_<TensorOp, std::shared_ptr<TensorOp>>(*m, "TensorOp")
  277. .def("__deepcopy__", [](py::object &t, py::dict memo) { return t; });
  278. (void)py::class_<NormalizeOp, TensorOp, std::shared_ptr<NormalizeOp>>(
  279. *m, "NormalizeOp", "Tensor operation to normalize an image. Takes mean and std.")
  280. .def(py::init<float, float, float, float, float, float>(), py::arg("meanR"), py::arg("meanG"), py::arg("meanB"),
  281. py::arg("stdR"), py::arg("stdG"), py::arg("stdB"));
  282. (void)py::class_<RescaleOp, TensorOp, std::shared_ptr<RescaleOp>>(
  283. *m, "RescaleOp", "Tensor operation to rescale an image. Takes scale and shift.")
  284. .def(py::init<float, float>(), py::arg("rescale"), py::arg("shift"));
  285. (void)py::class_<CenterCropOp, TensorOp, std::shared_ptr<CenterCropOp>>(
  286. *m, "CenterCropOp", "Tensor operation to crop and image in the middle. Takes height and width (optional)")
  287. .def(py::init<int32_t, int32_t>(), py::arg("height"), py::arg("width") = CenterCropOp::kDefWidth);
  288. (void)py::class_<ResizeOp, TensorOp, std::shared_ptr<ResizeOp>>(
  289. *m, "ResizeOp", "Tensor operation to resize an image. Takes height, width and mode")
  290. .def(py::init<int32_t, int32_t, InterpolationMode>(), py::arg("targetHeight"),
  291. py::arg("targetWidth") = ResizeOp::kDefWidth, py::arg("interpolation") = ResizeOp::kDefInterpolation);
  292. (void)py::class_<UniformAugOp, TensorOp, std::shared_ptr<UniformAugOp>>(
  293. *m, "UniformAugOp", "Tensor operation to apply random augmentation(s).")
  294. .def(py::init<std::vector<std::shared_ptr<TensorOp>>, int32_t>(), py::arg("operations"),
  295. py::arg("NumOps") = UniformAugOp::kDefNumOps);
  296. (void)py::class_<ResizeBilinearOp, TensorOp, std::shared_ptr<ResizeBilinearOp>>(
  297. *m, "ResizeBilinearOp",
  298. "Tensor operation to resize an image using "
  299. "Bilinear mode. Takes height and width.")
  300. .def(py::init<int32_t, int32_t>(), py::arg("targetHeight"), py::arg("targetWidth") = ResizeBilinearOp::kDefWidth);
  301. (void)py::class_<DecodeOp, TensorOp, std::shared_ptr<DecodeOp>>(*m, "DecodeOp",
  302. "Tensor operation to decode a jpg image")
  303. .def(py::init<>())
  304. .def(py::init<bool>(), py::arg("rgb_format") = DecodeOp::kDefRgbFormat);
  305. (void)py::class_<RandomHorizontalFlipOp, TensorOp, std::shared_ptr<RandomHorizontalFlipOp>>(
  306. *m, "RandomHorizontalFlipOp", "Tensor operation to randomly flip an image horizontally.")
  307. .def(py::init<float>(), py::arg("probability") = RandomHorizontalFlipOp::kDefProbability);
  308. }
  309. void bindTensorOps2(py::module *m) {
  310. (void)py::class_<RandomVerticalFlipOp, TensorOp, std::shared_ptr<RandomVerticalFlipOp>>(
  311. *m, "RandomVerticalFlipOp", "Tensor operation to randomly flip an image vertically.")
  312. .def(py::init<float>(), py::arg("probability") = RandomVerticalFlipOp::kDefProbability);
  313. (void)py::class_<RandomCropOp, TensorOp, std::shared_ptr<RandomCropOp>>(*m, "RandomCropOp",
  314. "Gives random crop of specified size "
  315. "Takes crop size")
  316. .def(py::init<int32_t, int32_t, int32_t, int32_t, int32_t, int32_t, BorderType, bool, uint8_t, uint8_t, uint8_t>(),
  317. py::arg("cropHeight"), py::arg("cropWidth"), py::arg("padTop") = RandomCropOp::kDefPadTop,
  318. py::arg("padBottom") = RandomCropOp::kDefPadBottom, py::arg("padLeft") = RandomCropOp::kDefPadLeft,
  319. py::arg("padRight") = RandomCropOp::kDefPadRight, py::arg("borderType") = RandomCropOp::kDefBorderType,
  320. py::arg("padIfNeeded") = RandomCropOp::kDefPadIfNeeded, py::arg("fillR") = RandomCropOp::kDefFillR,
  321. py::arg("fillG") = RandomCropOp::kDefFillG, py::arg("fillB") = RandomCropOp::kDefFillB);
  322. (void)py::class_<HwcToChwOp, TensorOp, std::shared_ptr<HwcToChwOp>>(*m, "ChannelSwapOp").def(py::init<>());
  323. (void)py::class_<OneHotOp, TensorOp, std::shared_ptr<OneHotOp>>(
  324. *m, "OneHotOp", "Tensor operation to apply one hot encoding. Takes number of classes.")
  325. .def(py::init<int32_t>());
  326. (void)py::class_<RandomRotationOp, TensorOp, std::shared_ptr<RandomRotationOp>>(
  327. *m, "RandomRotationOp",
  328. "Tensor operation to apply RandomRotation."
  329. "Takes a range for degrees and "
  330. "optional parameters for rotation center and image expand")
  331. .def(py::init<float, float, float, float, InterpolationMode, bool, uint8_t, uint8_t, uint8_t>(),
  332. py::arg("startDegree"), py::arg("endDegree"), py::arg("centerX") = RandomRotationOp::kDefCenterX,
  333. py::arg("centerY") = RandomRotationOp::kDefCenterY,
  334. py::arg("interpolation") = RandomRotationOp::kDefInterpolation,
  335. py::arg("expand") = RandomRotationOp::kDefExpand, py::arg("fillR") = RandomRotationOp::kDefFillR,
  336. py::arg("fillG") = RandomRotationOp::kDefFillG, py::arg("fillB") = RandomRotationOp::kDefFillB);
  337. }
  338. void bindTensorOps3(py::module *m) {
  339. (void)py::class_<RandomCropAndResizeOp, TensorOp, std::shared_ptr<RandomCropAndResizeOp>>(
  340. *m, "RandomCropAndResizeOp",
  341. "Tensor operation to randomly crop an image and resize to a given size."
  342. "Takes output height and width and"
  343. "optional parameters for lower and upper bound for aspect ratio (h/w) and scale,"
  344. "interpolation mode, and max attempts to crop")
  345. .def(py::init<int32_t, int32_t, float, float, float, float, InterpolationMode, int32_t>(), py::arg("targetHeight"),
  346. py::arg("targetWidth"), py::arg("scaleLb") = RandomCropAndResizeOp::kDefScaleLb,
  347. py::arg("scaleUb") = RandomCropAndResizeOp::kDefScaleUb,
  348. py::arg("aspectLb") = RandomCropAndResizeOp::kDefAspectLb,
  349. py::arg("aspectUb") = RandomCropAndResizeOp::kDefAspectUb,
  350. py::arg("interpolation") = RandomCropAndResizeOp::kDefInterpolation,
  351. py::arg("maxIter") = RandomCropAndResizeOp::kDefMaxIter);
  352. (void)py::class_<RandomColorAdjustOp, TensorOp, std::shared_ptr<RandomColorAdjustOp>>(
  353. *m, "RandomColorAdjustOp",
  354. "Tensor operation to adjust an image's color randomly."
  355. "Takes range for brightness, contrast, saturation, hue and")
  356. .def(py::init<float, float, float, float, float, float, float, float>(), py::arg("bright_factor_start"),
  357. py::arg("bright_factor_end"), py::arg("contrast_factor_start"), py::arg("contrast_factor_end"),
  358. py::arg("saturation_factor_start"), py::arg("saturation_factor_end"), py::arg("hue_factor_start"),
  359. py::arg("hue_factor_end"));
  360. (void)py::class_<RandomResizeOp, TensorOp, std::shared_ptr<RandomResizeOp>>(
  361. *m, "RandomResizeOp",
  362. "Tensor operation to resize an image using a randomly selected interpolation. Takes height and width.")
  363. .def(py::init<int32_t, int32_t>(), py::arg("targetHeight"),
  364. py::arg("targetWidth") = RandomResizeOp::kDefTargetWidth);
  365. (void)py::class_<CutOutOp, TensorOp, std::shared_ptr<CutOutOp>>(
  366. *m, "CutOutOp", "Tensor operation to randomly erase a portion of the image. Takes height and width.")
  367. .def(py::init<int32_t, int32_t, int32_t, bool, uint8_t, uint8_t, uint8_t>(), py::arg("boxHeight"),
  368. py::arg("boxWidth"), py::arg("numPatches"), py::arg("randomColor") = CutOutOp::kDefRandomColor,
  369. py::arg("fillR") = CutOutOp::kDefFillR, py::arg("fillG") = CutOutOp::kDefFillG,
  370. py::arg("fillB") = CutOutOp::kDefFillB);
  371. }
  372. void bindTensorOps4(py::module *m) {
  373. (void)py::class_<TypeCastOp, TensorOp, std::shared_ptr<TypeCastOp>>(
  374. *m, "TypeCastOp", "Tensor operator to type cast data to a specified type.")
  375. .def(py::init<DataType>(), py::arg("data_type"))
  376. .def(py::init<std::string>(), py::arg("data_type"));
  377. (void)py::class_<NoOp, TensorOp, std::shared_ptr<NoOp>>(*m, "NoOp",
  378. "TensorOp that does nothing, for testing purposes only.")
  379. .def(py::init<>());
  380. (void)py::class_<ToFloat16Op, TensorOp, std::shared_ptr<ToFloat16Op>>(
  381. *m, "ToFloat16Op", py::dynamic_attr(), "Tensor operator to type cast float32 data to a float16 type.")
  382. .def(py::init<>());
  383. (void)py::class_<RandomCropDecodeResizeOp, TensorOp, std::shared_ptr<RandomCropDecodeResizeOp>>(
  384. *m, "RandomCropDecodeResizeOp", "equivalent to RandomCropAndResize but crops before decoding")
  385. .def(py::init<int32_t, int32_t, float, float, float, float, InterpolationMode, int32_t>(), py::arg("targetHeight"),
  386. py::arg("targetWidth"), py::arg("scaleLb") = RandomCropDecodeResizeOp::kDefScaleLb,
  387. py::arg("scaleUb") = RandomCropDecodeResizeOp::kDefScaleUb,
  388. py::arg("aspectLb") = RandomCropDecodeResizeOp::kDefAspectLb,
  389. py::arg("aspectUb") = RandomCropDecodeResizeOp::kDefAspectUb,
  390. py::arg("interpolation") = RandomCropDecodeResizeOp::kDefInterpolation,
  391. py::arg("maxIter") = RandomCropDecodeResizeOp::kDefMaxIter);
  392. (void)py::class_<PadOp, TensorOp, std::shared_ptr<PadOp>>(
  393. *m, "PadOp",
  394. "Pads image with specified color, default black, "
  395. "Takes amount to pad for top, bottom, left, right of image, boarder type and color")
  396. .def(py::init<int32_t, int32_t, int32_t, int32_t, BorderType, uint8_t, uint8_t, uint8_t>(), py::arg("padTop"),
  397. py::arg("padBottom"), py::arg("padLeft"), py::arg("padRight"), py::arg("borderTypes") = PadOp::kDefBorderType,
  398. py::arg("fillR") = PadOp::kDefFillR, py::arg("fillG") = PadOp::kDefFillG, py::arg("fillB") = PadOp::kDefFillB);
  399. }
  400. void bindTensorOps5(py::module *m) {
  401. (void)py::class_<JiebaTokenizerOp, TensorOp, std::shared_ptr<JiebaTokenizerOp>>(*m, "JiebaTokenizerOp", "")
  402. .def(py::init<const std::string, std::string, JiebaMode>(), py::arg("hmm_path"), py::arg("mp_path"),
  403. py::arg("mode") = JiebaMode::kMix)
  404. .def("add_word",
  405. [](JiebaTokenizerOp &self, const std::string word, int freq) { THROW_IF_ERROR(self.AddWord(word, freq)); });
  406. (void)py::class_<UnicodeCharTokenizerOp, TensorOp, std::shared_ptr<UnicodeCharTokenizerOp>>(
  407. *m, "UnicodeCharTokenizerOp", "Tokenize a scalar tensor of UTF-8 string to Unicode characters.")
  408. .def(py::init<>());
  409. (void)py::class_<LookupOp, TensorOp, std::shared_ptr<LookupOp>>(*m, "LookupOp",
  410. "Tensor operation to LookUp each word")
  411. .def(py::init<std::shared_ptr<Vocab>, WordIdType>(), py::arg("vocab"), py::arg("unknown"))
  412. .def(py::init<std::shared_ptr<Vocab>>(), py::arg("vocab"));
  413. (void)py::class_<NgramOp, TensorOp, std::shared_ptr<NgramOp>>(*m, "NgramOp", "TensorOp performs ngram mapping")
  414. .def(py::init<const std::vector<int32_t> &, int32_t, int32_t, const std::string &, const std::string &,
  415. const std::string &>(),
  416. py::arg("ngrams"), py::arg("l_pad_len"), py::arg("r_pad_len"), py::arg("l_pad_token"), py::arg("r_pad_token"),
  417. py::arg("separator"));
  418. }
  419. void bindSamplerOps(py::module *m) {
  420. (void)py::class_<Sampler, std::shared_ptr<Sampler>>(*m, "Sampler")
  421. .def("set_num_rows", [](Sampler &self, int64_t rows) { THROW_IF_ERROR(self.SetNumRowsInDataset(rows)); })
  422. .def("set_num_samples", [](Sampler &self, int64_t samples) { THROW_IF_ERROR(self.SetNumSamples(samples)); })
  423. .def("initialize", [](Sampler &self) { THROW_IF_ERROR(self.InitSampler()); })
  424. .def("get_indices",
  425. [](Sampler &self) {
  426. py::array ret;
  427. THROW_IF_ERROR(self.GetAllIdsThenReset(&ret));
  428. return ret;
  429. })
  430. .def("add_child",
  431. [](std::shared_ptr<Sampler> self, std::shared_ptr<Sampler> child) { THROW_IF_ERROR(self->AddChild(child)); });
  432. (void)py::class_<mindrecord::ShardOperator, std::shared_ptr<mindrecord::ShardOperator>>(*m, "ShardOperator");
  433. (void)py::class_<DistributedSampler, Sampler, std::shared_ptr<DistributedSampler>>(*m, "DistributedSampler")
  434. .def(py::init<int64_t, int64_t, int64_t, bool, uint32_t>());
  435. (void)py::class_<PKSampler, Sampler, std::shared_ptr<PKSampler>>(*m, "PKSampler")
  436. .def(py::init<int64_t, int64_t, bool>());
  437. (void)py::class_<RandomSampler, Sampler, std::shared_ptr<RandomSampler>>(*m, "RandomSampler")
  438. .def(py::init<int64_t, bool, bool>());
  439. (void)py::class_<SequentialSampler, Sampler, std::shared_ptr<SequentialSampler>>(*m, "SequentialSampler")
  440. .def(py::init<int64_t, int64_t>());
  441. (void)py::class_<SubsetRandomSampler, Sampler, std::shared_ptr<SubsetRandomSampler>>(*m, "SubsetRandomSampler")
  442. .def(py::init<int64_t, std::vector<int64_t>>());
  443. (void)py::class_<mindrecord::ShardSample, mindrecord::ShardOperator, std::shared_ptr<mindrecord::ShardSample>>(
  444. *m, "MindrecordSubsetRandomSampler")
  445. .def(py::init<std::vector<int64_t>, uint32_t>(), py::arg("indices"), py::arg("seed") = GetSeed());
  446. (void)py::class_<mindrecord::ShardPkSample, mindrecord::ShardOperator, std::shared_ptr<mindrecord::ShardPkSample>>(
  447. *m, "MindrecordPkSampler")
  448. .def(py::init([](int64_t kVal, std::string kColumn, bool shuffle) {
  449. if (shuffle == true) {
  450. return std::make_shared<mindrecord::ShardPkSample>(kColumn, kVal, std::numeric_limits<int64_t>::max(),
  451. GetSeed());
  452. } else {
  453. return std::make_shared<mindrecord::ShardPkSample>(kColumn, kVal);
  454. }
  455. }));
  456. (void)py::class_<WeightedRandomSampler, Sampler, std::shared_ptr<WeightedRandomSampler>>(*m, "WeightedRandomSampler")
  457. .def(py::init<int64_t, std::vector<double>, bool>());
  458. (void)py::class_<PythonSampler, Sampler, std::shared_ptr<PythonSampler>>(*m, "PythonSampler")
  459. .def(py::init<int64_t, py::object>());
  460. }
  461. void bindInfoObjects(py::module *m) {
  462. (void)py::class_<BatchOp::CBatchInfo>(*m, "CBatchInfo")
  463. .def(py::init<int64_t, int64_t, int64_t>())
  464. .def("get_epoch_num", &BatchOp::CBatchInfo::get_epoch_num)
  465. .def("get_batch_num", &BatchOp::CBatchInfo::get_batch_num);
  466. }
  467. void bindVocabObjects(py::module *m) {
  468. (void)py::class_<Vocab, std::shared_ptr<Vocab>>(*m, "Vocab")
  469. .def_static("from_list",
  470. [](const py::list &words) {
  471. std::shared_ptr<Vocab> v;
  472. THROW_IF_ERROR(Vocab::BuildFromPyList(words, &v));
  473. return v;
  474. })
  475. .def_static("from_file",
  476. [](const std::string &path, const std::string &dlm, int32_t vocab_size) {
  477. std::shared_ptr<Vocab> v;
  478. THROW_IF_ERROR(Vocab::BuildFromFile(path, dlm, vocab_size, &v));
  479. return v;
  480. })
  481. .def_static("from_dict", [](const py::dict &words) {
  482. std::shared_ptr<Vocab> v;
  483. THROW_IF_ERROR(Vocab::BuildFromPyDict(words, &v));
  484. return v;
  485. });
  486. }
  487. void bindGraphData(py::module *m) {
  488. (void)py::class_<gnn::Graph, std::shared_ptr<gnn::Graph>>(*m, "Graph")
  489. .def(py::init([](std::string dataset_file, int32_t num_workers) {
  490. std::shared_ptr<gnn::Graph> g_out = std::make_shared<gnn::Graph>(dataset_file, num_workers);
  491. THROW_IF_ERROR(g_out->Init());
  492. return g_out;
  493. }))
  494. .def("get_all_nodes",
  495. [](gnn::Graph &g, gnn::NodeType node_type) {
  496. std::shared_ptr<Tensor> out;
  497. THROW_IF_ERROR(g.GetAllNodes(node_type, &out));
  498. return out;
  499. })
  500. .def("get_all_edges",
  501. [](gnn::Graph &g, gnn::EdgeType edge_type) {
  502. std::shared_ptr<Tensor> out;
  503. THROW_IF_ERROR(g.GetAllEdges(edge_type, &out));
  504. return out;
  505. })
  506. .def("get_nodes_from_edges",
  507. [](gnn::Graph &g, std::vector<gnn::NodeIdType> edge_list) {
  508. std::shared_ptr<Tensor> out;
  509. THROW_IF_ERROR(g.GetNodesFromEdges(edge_list, &out));
  510. return out;
  511. })
  512. .def("get_all_neighbors",
  513. [](gnn::Graph &g, std::vector<gnn::NodeIdType> node_list, gnn::NodeType neighbor_type) {
  514. std::shared_ptr<Tensor> out;
  515. THROW_IF_ERROR(g.GetAllNeighbors(node_list, neighbor_type, &out));
  516. return out;
  517. })
  518. .def("get_sampled_neighbors",
  519. [](gnn::Graph &g, std::vector<gnn::NodeIdType> node_list, std::vector<gnn::NodeIdType> neighbor_nums,
  520. std::vector<gnn::NodeType> neighbor_types) {
  521. std::shared_ptr<Tensor> out;
  522. THROW_IF_ERROR(g.GetSampledNeighbors(node_list, neighbor_nums, neighbor_types, &out));
  523. return out;
  524. })
  525. .def("get_neg_sampled_neighbors",
  526. [](gnn::Graph &g, std::vector<gnn::NodeIdType> node_list, gnn::NodeIdType neighbor_num,
  527. gnn::NodeType neg_neighbor_type) {
  528. std::shared_ptr<Tensor> out;
  529. THROW_IF_ERROR(g.GetNegSampledNeighbors(node_list, neighbor_num, neg_neighbor_type, &out));
  530. return out;
  531. })
  532. .def("get_node_feature",
  533. [](gnn::Graph &g, std::shared_ptr<Tensor> node_list, std::vector<gnn::FeatureType> feature_types) {
  534. TensorRow out;
  535. THROW_IF_ERROR(g.GetNodeFeature(node_list, feature_types, &out));
  536. return out;
  537. })
  538. .def("graph_info", [](gnn::Graph &g) {
  539. py::dict out;
  540. THROW_IF_ERROR(g.GraphInfo(&out));
  541. return out;
  542. });
  543. }
  544. // This is where we externalize the C logic as python modules
  545. PYBIND11_MODULE(_c_dataengine, m) {
  546. m.doc() = "pybind11 for _c_dataengine";
  547. (void)py::class_<DatasetOp, std::shared_ptr<DatasetOp>>(m, "DatasetOp");
  548. (void)py::enum_<OpName>(m, "OpName", py::arithmetic())
  549. .value("STORAGE", OpName::kStorage)
  550. .value("SHUFFLE", OpName::kShuffle)
  551. .value("BATCH", OpName::kBatch)
  552. .value("BARRIER", OpName::kBarrier)
  553. .value("MINDRECORD", OpName::kMindrecord)
  554. .value("CACHE", OpName::kCache)
  555. .value("REPEAT", OpName::kRepeat)
  556. .value("SKIP", OpName::kSkip)
  557. .value("TAKE", OpName::kTake)
  558. .value("ZIP", OpName::kZip)
  559. .value("CONCAT", OpName::kConcat)
  560. .value("MAP", OpName::kMap)
  561. .value("FILTER", OpName::kFilter)
  562. .value("DEVICEQUEUE", OpName::kDeviceQueue)
  563. .value("GENERATOR", OpName::kGenerator)
  564. .export_values()
  565. .value("RENAME", OpName::kRename)
  566. .value("TFREADER", OpName::kTfReader)
  567. .value("PROJECT", OpName::kProject)
  568. .value("IMAGEFOLDER", OpName::kImageFolder)
  569. .value("MNIST", OpName::kMnist)
  570. .value("MANIFEST", OpName::kManifest)
  571. .value("VOC", OpName::kVoc)
  572. .value("COCO", OpName::kCoco)
  573. .value("CIFAR10", OpName::kCifar10)
  574. .value("CIFAR100", OpName::kCifar100)
  575. .value("RANDOMDATA", OpName::kRandomData)
  576. .value("CELEBA", OpName::kCelebA)
  577. .value("TEXTFILE", OpName::kTextFile);
  578. (void)py::enum_<JiebaMode>(m, "JiebaMode", py::arithmetic())
  579. .value("DE_JIEBA_MIX", JiebaMode::kMix)
  580. .value("DE_JIEBA_MP", JiebaMode::kMp)
  581. .value("DE_JIEBA_HMM", JiebaMode::kHmm)
  582. .export_values();
  583. (void)py::enum_<InterpolationMode>(m, "InterpolationMode", py::arithmetic())
  584. .value("DE_INTER_LINEAR", InterpolationMode::kLinear)
  585. .value("DE_INTER_CUBIC", InterpolationMode::kCubic)
  586. .value("DE_INTER_AREA", InterpolationMode::kArea)
  587. .value("DE_INTER_NEAREST_NEIGHBOUR", InterpolationMode::kNearestNeighbour)
  588. .export_values();
  589. (void)py::enum_<BorderType>(m, "BorderType", py::arithmetic())
  590. .value("DE_BORDER_CONSTANT", BorderType::kConstant)
  591. .value("DE_BORDER_EDGE", BorderType::kEdge)
  592. .value("DE_BORDER_REFLECT", BorderType::kReflect)
  593. .value("DE_BORDER_SYMMETRIC", BorderType::kSymmetric)
  594. .export_values();
  595. bindDEPipeline(&m);
  596. bindTensor(&m);
  597. bindTensorOps1(&m);
  598. bindTensorOps2(&m);
  599. bindTensorOps3(&m);
  600. bindTensorOps4(&m);
  601. bindTensorOps5(&m);
  602. bindSamplerOps(&m);
  603. bindDatasetOps(&m);
  604. bindInfoObjects(&m);
  605. bindVocabObjects(&m);
  606. bindGraphData(&m);
  607. }
  608. } // namespace dataset
  609. } // namespace mindspore