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