SciPy ndimage中min_or_max_filter的C源码及名称映射问询

首先，min_or_max_filter的Python接口和C层的NI_MinOrMaxFilter是通过C扩展绑定和**类型注解文件（.pyi）**配合实现映射的，具体分为几个核心环节：

1. C底层函数到Python模块的绑定 #

SciPy的C扩展会通过Python C API，将底层C实现函数（比如NI_MinOrMaxFilter）包装成Python可调用的函数，这个绑定逻辑一般在同目录的.c或.pyx（Cython）文件中：

• 在nd_image.c或关联的绑定文件里，会定义一个Python函数对象，把它关联到NI_MinOrMaxFilter的处理逻辑，再将这个函数以min_or_max_filter的名称添加到ndimage模块的符号表中。
• 纯C扩展会用PyMethodDef结构体完成绑定，Cython实现则会用cdef extern/def语法，完成C函数名到Python函数名的映射。

2. .pyi类型存根文件的作用 #

.pyi文件仅提供类型提示，不包含执行逻辑：

• 它里面的min_or_max_filter函数定义，是对C扩展暴露的Python函数的类型注解，名称完全对应C扩展绑定后对外暴露的Python函数名。
• 简单来说，.pyi里的函数名和Python用户实际调用的函数名一致，而这个名称是在C扩展绑定阶段，从底层C函数（如NI_MinOrMaxFilter）映射而来的。

3. min_or_max_filter的具体对应关系 #

你找到的NI_MinOrMaxFilter是核心底层实现，它会被C扩展的中间包装函数调用，这个包装函数最终以min_or_max_filter的名称暴露给Python模块。你可以在ndimage的C扩展绑定代码中找到类似如下的逻辑：

static PyMethodDef ndimage_methods[] = {
    {"min_or_max_filter", (PyCFunction)py_min_or_max_filter, METH_VARARGS | METH_KEYWORDS, "Filter an array with a min or max filter..."},
    // 其他函数绑定项
    {NULL, NULL, 0, NULL}
};

这里的py_min_or_max_filter就是中间包装函数，内部会调用NI_MinOrMaxFilter完成计算，同时处理Python参数到C类型的转换、异常捕获等逻辑。

内容的提问来源于stack exchange，提问作者Cos_ma