Skip to content

ENH, API: New sorting mechanism for DType API #28516

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 30 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
30 commits
Select commit Hold shift + click to select a range
4700c13
ENH: Allocate lock only once in StringDType quicksort
MaanasArora Mar 14, 2025
5fb0b5f
ENH: Add dtype slots for sorting and begin integration
MaanasArora Mar 26, 2025
76be21b
MAINT: Rename sort compare slot access function
MaanasArora Mar 26, 2025
59590d2
ENH: Add dtype slot sorting functionality support to all sort kinds
MaanasArora Mar 26, 2025
b89accd
ENH: Add descending flag to internal sorting functions
MaanasArora Mar 26, 2025
a437eb9
MAINT: Improve get dtype sort compare function name
MaanasArora Mar 27, 2025
aa63d11
MAINT: Fix doc typo
MaanasArora Mar 27, 2025
16e95a2
MAINT: Error out when non-legacy dtype has no sort_compare function
MaanasArora Mar 27, 2025
42e76d6
DOC: Add release notes for new dtype sorting API
MaanasArora Mar 28, 2025
88636cc
DOC: Add doc for sort compare slot in release notes
MaanasArora Mar 28, 2025
9d14ec1
DOC: Add note for potential deprecation of sort arrfuncs in release note
MaanasArora Mar 30, 2025
a556455
MAINT: Reorder dtype slots to prevent changing existing slot numbers
MaanasArora Mar 30, 2025
3c0957e
BUG: Error on missing `sort_compare` slot only when dtype is privatel…
MaanasArora Mar 30, 2025
9506798
DOC: Add C-API documentation for new sorting slots
MaanasArora Apr 1, 2025
6ce5351
ENH: Replace array object with context and auxdata in sortfunc signat…
MaanasArora Apr 5, 2025
96a53b2
BUG: Fix unnecessarily private function call due to underscore typo
MaanasArora Apr 5, 2025
9a2b100
MAINT: Fix whitespace typos
MaanasArora Apr 5, 2025
8d4c75d
ENH: Allow flexible sorting compare for arr or descr in npy_sort func…
MaanasArora Apr 11, 2025
50988ba
ENH: Add new sort func implementations and use in stringdtype
MaanasArora Apr 11, 2025
ca5797e
DOC: Fix missing newline in ctype doc
MaanasArora Apr 11, 2025
95cfd8f
DOC: Add sortfunc typedef docs
MaanasArora Apr 12, 2025
6dd4f4c
DOC: Fix missing newline in ctype doc
MaanasArora Apr 12, 2025
4fa813c
ENH: Define SortCompareFunc type
MaanasArora Apr 12, 2025
894911e
Update dtype sorting signatures: move context, move out auxdata to ge…
MaanasArora May 13, 2025
57687ac
MAINT: Check error in Get(Arg)SortFunc using return value
MaanasArora May 13, 2025
0edb4ea
DOC: Add missing newlines to c-types in array.rst
MaanasArora May 14, 2025
167301e
MAINT: Rename new sort funcs and restore older names for existing pub…
MaanasArora May 24, 2025
e6b8c1e
MAINT: Rename start pointer in new sort func documentation to data
MaanasArora May 24, 2025
579c351
ENH: Add flags to new get_(arg)sort_function
MaanasArora May 28, 2025
d854b00
DOC: Mention new sort func buffers to be contiguous
MaanasArora May 28, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
ENH: Add dtype slot sorting functionality support to all sort kinds
  • Loading branch information
MaanasArora committed May 20, 2025
commit 59590d29057fcbde9849c8523dbcbcd2b79bc22b
70 changes: 66 additions & 4 deletions numpy/_core/src/multiarray/stringdtype/dtype.c
Original file line number Diff line number Diff line change
Expand Up @@ -539,18 +539,78 @@ _stringdtype_quicksort(void *start, npy_intp num, void *varr) {
return _stringdtype_sort(start, num, varr, &npy_quicksort);
}

int
_stringdtype_heapsort(void *start, npy_intp num, void *varr) {
return _stringdtype_sort(start, num, varr, &npy_heapsort);
}

int
_stringdtype_timsort(void *start, npy_intp num, void *varr) {
return _stringdtype_sort(start, num, varr, &npy_timsort);
}

int
stringdtype_get_sort_function(
PyArray_Descr *descr, NPY_SORTKIND sort_kind, PyArray_SortFunc **out_sort) {

switch (sort_kind) {
default:
case NPY_QUICKSORT:
*out_sort = &_stringdtype_quicksort;
return 0;
break;
case NPY_HEAPSORT:
*out_sort = &_stringdtype_heapsort;
break;
case NPY_STABLESORT:
*out_sort = &_stringdtype_timsort;
break;
}

return 0;
}

int
_stringdtype_argsort(void *vv, npy_intp *tosort, npy_intp num, void *varr,
PyArray_ArgSortFunc *argsort) {
PyArray_StringDTypeObject *descr = (PyArray_StringDTypeObject *)PyArray_DESCR(varr);

NpyString_acquire_allocator(descr);
int result = argsort(vv, tosort, num, varr);
NpyString_release_allocator(descr->allocator);

return result;
}

int
_stringdtype_aquicksort(void *vv, npy_intp *tosort, npy_intp n, void *varr) {
return _stringdtype_argsort(vv, tosort, n, varr, &npy_aquicksort);
}

int
_stringdtype_aheapsort(void *vv, npy_intp *tosort, npy_intp n, void *varr) {
return _stringdtype_argsort(vv, tosort, n, varr, &npy_aheapsort);
}

int
_stringdtype_atimsort(void *vv, npy_intp *tosort, npy_intp n, void *varr) {
return _stringdtype_argsort(vv, tosort, n, varr, &npy_atimsort);
}

int
stringdtype_get_argsort_function(
PyArray_Descr *descr, NPY_SORTKIND sort_kind, PyArray_ArgSortFunc **out_argsort) {

switch (sort_kind) {
default:
PyErr_Format(PyExc_ValueError,
"Sort kind %d not supported for string dtype", sort_kind);
return -1;
case NPY_QUICKSORT:
*out_argsort = &npy_aquicksort;
break;
case NPY_HEAPSORT:
*out_argsort = &npy_aheapsort;
break;
case NPY_STABLESORT:
*out_argsort = &npy_atimsort;
break;
}

return 0;
Expand Down Expand Up @@ -697,6 +757,8 @@ static PyType_Slot PyArray_StringDType_Slots[] = {
{NPY_DT_setitem, &stringdtype_setitem},
{NPY_DT_getitem, &stringdtype_getitem},
{NPY_DT_sort_compare, &stringdtype_sort_compare},
{NPY_DT_get_sort_function, &stringdtype_get_sort_function},
{NPY_DT_get_argsort_function, &stringdtype_get_argsort_function},
{NPY_DT_ensure_canonical, &stringdtype_ensure_canonical},
{NPY_DT_PyArray_ArrFuncs_nonzero, &nonzero},
{NPY_DT_PyArray_ArrFuncs_compare, &compare},
Expand Down
4 changes: 2 additions & 2 deletions numpy/_core/src/npysort/heapsort.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ npy_heapsort(void *start, npy_intp num, void *varr)
{
PyArrayObject *arr = (PyArrayObject *)varr;
npy_intp elsize = PyArray_ITEMSIZE(arr);
PyArray_CompareFunc *cmp = PyDataType_GetArrFuncs(PyArray_DESCR(arr))->compare;
PyArray_CompareFunc *cmp = PyArray_SortCompare(PyArray_DESCR(arr));
if (elsize == 0) {
return 0; /* no need for sorting elements of no size */
}
Expand Down Expand Up @@ -116,7 +116,7 @@ npy_aheapsort(void *vv, npy_intp *tosort, npy_intp n, void *varr)
char *v = (char *)vv;
PyArrayObject *arr = (PyArrayObject *)varr;
npy_intp elsize = PyArray_ITEMSIZE(arr);
PyArray_CompareFunc *cmp = PyDataType_GetArrFuncs(PyArray_DESCR(arr))->compare;
PyArray_CompareFunc *cmp = PyArray_SortCompare(PyArray_DESCR(arr));
npy_intp *a, i, j, l, tmp;

/* The array needs to be offset by one for heapsort indexing */
Expand Down
4 changes: 2 additions & 2 deletions numpy/_core/src/npysort/mergesort.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -385,7 +385,7 @@ npy_mergesort(void *start, npy_intp num, void *varr)
{
PyArrayObject *arr = (PyArrayObject *)varr;
npy_intp elsize = PyArray_ITEMSIZE(arr);
PyArray_CompareFunc *cmp = PyDataType_GetArrFuncs(PyArray_DESCR(arr))->compare;
PyArray_CompareFunc *cmp = PyArray_SortCompare(PyArray_DESCR(arr));
char *pl = (char *)start;
char *pr = pl + num * elsize;
char *pw;
Expand Down Expand Up @@ -461,7 +461,7 @@ npy_amergesort(void *v, npy_intp *tosort, npy_intp num, void *varr)
{
PyArrayObject *arr = (PyArrayObject *)varr;
npy_intp elsize = PyArray_ITEMSIZE(arr);
PyArray_CompareFunc *cmp = PyDataType_GetArrFuncs(PyArray_DESCR(arr))->compare;
PyArray_CompareFunc *cmp = PyArray_SortCompare(PyArray_DESCR(arr));
npy_intp *pl, *pr, *pw;

/* Items that have zero size don't make sense to sort */
Expand Down
4 changes: 2 additions & 2 deletions numpy/_core/src/npysort/timsort.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -2250,7 +2250,7 @@ npy_timsort(void *start, npy_intp num, void *varr)
{
PyArrayObject *arr = reinterpret_cast<PyArrayObject *>(varr);
size_t len = PyArray_ITEMSIZE(arr);
PyArray_CompareFunc *cmp = PyDataType_GetArrFuncs(PyArray_DESCR(arr))->compare;
PyArray_CompareFunc *cmp = PyArray_SortCompare(PyArray_DESCR(arr));
int ret;
npy_intp l, n, stack_ptr, minrun;
run stack[TIMSORT_STACK_SIZE];
Expand Down Expand Up @@ -2686,7 +2686,7 @@ npy_atimsort(void *start, npy_intp *tosort, npy_intp num, void *varr)
{
PyArrayObject *arr = reinterpret_cast<PyArrayObject *>(varr);
size_t len = PyArray_ITEMSIZE(arr);
PyArray_CompareFunc *cmp = PyDataType_GetArrFuncs(PyArray_DESCR(arr))->compare;
PyArray_CompareFunc *cmp = PyArray_SortCompare(PyArray_DESCR(arr));
int ret;
npy_intp l, n, stack_ptr, minrun;
run stack[TIMSORT_STACK_SIZE];
Expand Down
pFad - Phonifier reborn

Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.

Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.


Alternative Proxies:

Alternative Proxy

pFad Proxy

pFad v3 Proxy

pFad v4 Proxy