-
-
Notifications
You must be signed in to change notification settings - Fork 854
GSoC 2024 ‐ Jaysukh Makvana
I am Jaysukh Makvana from Surat, Gujarat, India. I am a final year Bachelor of Technology student in the department of Computer Science and Technology at Indian Institute of Technology, Jodhpur.
Referring the implementation of Complex64 and Complex128 arrays, I proposed adding support for Boolean array in stdlib-js which will be backed by Uint8Array. BooleanArray should have prototypes that any typed array have like get, set, sort, reverse, at etc. After implementing the BooleanArray constructors and prototypes we need to refactor the packages of @stdlib/array/*
to add the support of boolean datatype across the entire array namespace. In the same way, We need to refactor the packages of @stdlib/strided/*
to add the support of boolean datatype across the entire strided namespace. In parallel, We need to add some assertion package which we need to deal with different BooleanArray operation. Similar to strided and array namespace we need to refactor the packages of @stdlib/ndarray/*
to add the support of boolean datatype across ndarray namespace. In the end, We need to add new packages like mskfilter, mskreject and mskput to ndarray namespace to get ndarray API parity with typed arrays.
- At the starting of Coding Period, I had
@stdlib/array/bool
containing constructors and some prototypes like set, length etc. So, I started my work with adding the various prototypes for the BooleanArray. I added the map, sort, find, findLast, findIndex, findLastIndex, reverse, toReversed, toSorted, every, some, indexOf, lastIndexOf, includes, slice, subarray, reduce, reduceRight, join, toString, keys, values, with, at, fill, filter, toLocaleString, copyWithin, entries and forEach prototypes for BooleanArray. I added benchmarks, tests and docs files for the same. - I added the some assertion utilities which I needed to refactor the array and strided namespace which includes
@stdlib/assert/is-booleanarray
,@stdlib/assert/is-same-booleanarray
and it's base implementation. I added the one of the important package which reinterprets the BooleanArray as Uint8Array as@stdlib/strided/base/reinterpret-boolean
. - After those work, I refactored the packages of array namespace to add the support of boolean datatype to array namespace.
- Similarly, I refactored the packages of strided namespace to add the support of boolean datatype to strided namespace.
- Similarly, I refactored the packages of ndarray namespace to add the support of boolean datatype to ndarray namespace.
- Finally, I added the
@stdlib/ndarray/base/mskfilter
and@stdlib/ndarray/base/mskreject
which used for the masking of ndarray.
-
#2292, #2363, #2376, #2384, #2385, #2390, #2413, #2421, #2432, #2441, #2472, #2509, #2557, #2590, #2607, #2611 : These PRs added the implementation, documentation, tests and benchmarks of the all the prototypes that any typed array have to the BooleanArray.
-
These PRs added the assertion which is used for the BooleanArray for various purposes.
#2299:
@stdlib/assert/is-booleanarray
#2401:
@stdlib/assert/is-same-booleanarray
-
#2306, #2307, #2308, #2309, #2310, #2353, #2354, #2362, #2369, #2391, #2392, #2404, #2419, #2420, #2422, #2423, #2424, #2446, #2447, #2450, #2452, #2453, #2459, #2460, #2461, #2462, #2470, #2471, #2473, #2474, #2486, #2487, #2488, #2494, #2556 : These PRs refactored the various pacages of array namespace and added boolean datatype support to them.
-
#2357 : This PR added the
@stdlib/array/base/assert/is-booleanarray
package which is used to quick test whether a value is a BooleanArray. -
#2508, #2513, #2519, #2520, #2521, #2522, #2523, #2524, #2525, #2526, : These PRs refactored the pacages of strided namespace and added boolean datatype support to them.
-
#2297 : This PR added the
@stdlib/strided/base/reinterpret-boolean
package which is used to reinterpret BooleanArray as Uint8Array. -
#2505, #2507, #2550, #2551, #2552, #2553, #2554, #2555, #2571, #2572, #2574, #2586, #2587, #2588, #2589, #2598 : These PRs refactored the various pacages of ndarray namespace and added boolean datatype support to them.
-
These PRs added the some packages for ndarray namespace.
#2575:
@stdlib/ndarray/base/assert/is-boolean-data-type
#2604:
@stdlib/ndarray/base/mskfilter
-
#2281, #2282, #2283, #2431, #2489 : These PRs includes the various maintainence work like fix the documentation or examples for various packages.
Curretly, project having support of BooleanAray across the entire array, strided and ndarray namespaces.
TODO: add a summary of what remains left to do. If there is a tracking issue, include a link to that issue.
TODO: add a summary of any unexpected challenges that you faced, along with any lessons learned during the course of your project.
This summer has been an incredible learning experience. Through this program, I have gained valuable insights into various aspects of feature development within a codebase. I've learned how to write and implement tests to ensure code correctness, add benchmarks to assess performance efficiency, and, most importantly, write clean and readable code. I am deeply grateful to Athan Reines and Philipp Burckhardt for providing me with this opportunity. I would also like to extend my heartfelt thanks to my mentors, Athan Reines and Pranav Goswami, for reviewing my work, providing valuable feedback and being readliy available for the discussions.