如何为Numba函数定义多签名以兼容标量与数组类型的输入输出
Numba 多类型入参/返回值配置方案
Numba 可通过给@numba.njit传入多签名列表的方式实现对标量、数组两类入参的同时支持,运行时会根据实际传入的参数类型自动匹配对应的编译重载版本,无需额外实现类似Union的泛型逻辑。
具体配置方法
将cosd对应的装饰器修改为多签名传参形式即可:
import numpy as np import numba from numba import float64 # 传入两类匹配的签名组成的列表 @numba.njit([ float64(float64), # 匹配标量入参:输入64位浮点标量,返回同类型标量 float64[:](float64[:]) # 匹配一维数组入参:输入64位浮点一维数组,返回同维度同类型数组 ]) def cosd(angle): return np.cos(np.radians(angle))
关键规则说明
- 配置完成后,
cosd可直接接收标量类型的angle参数返回标量结果,也可接收一维浮点数组类型的angle参数返回同维度数组结果,主函数内的调用逻辑不需要做任何修改。 - 若后续需要支持更高维度的数组入参,只需要在签名列表中追加对应规则即可,例如需要支持二维数组就追加
float64[:,:](float64[:,:])到列表中。 - 如果不想手动枚举所有需要支持的数组维度,也可以直接使用无显式签名的
@numba.njit(即装饰器不附加任何签名参数),Numba会在第一次遇到对应类型的入参时自动完成JIT编译,支持任意维度的浮点数组和标量输入,缺点是首次匹配新类型时会产生一定的编译延迟。 - 这种多签名重载机制和Numba内部的函数调用逻辑完全兼容,在被其他
@njit装饰的主函数内部调用时,不会出现类型匹配错误的问题。
内容的提问来源于stack exchange,提问作者mauro
相关产品推荐
相关产品推荐

