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 34 kB

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