完成脚本中的断言？

Question

我刚刚完成了一个图像卷积脚本。

现在，我的函数看起来像：

def conv(image: np.ndarray,
         conv: np.ndarray, *args):

    assert 1 < image.ndim < 4, "error0"
    assert conv.ndim is 2, "error1"
    xconv, yconv = conv.shape
    assert xconv == yconv and xconv % 2, "error2"
    # computations

如果这些断言中的任何一个不满足，那么输入是错误的，很可能函数会出错。

虽然，用户将无法理解问题所在，再加上到达错误之前的延迟。

我在任何地方都读到assert 用于调试。每次运行时“减慢”我的算法而不是更慢和未记录的错误（他必须参考文档字符串）会更好吗？在这些情况下，最常见的做法是什么？

Answer 1

在这些情况下最常见的做法是什么？

您可以 raise Exception 简要说明它发生的原因，因此以您为例，您可以这样做：

if not 1 < image.ndim < 4:
    raise Exception("Incorrect number of dimensions")

而不是

assert 1 < image.ndim < 4, "error0"

注意not（否定条件）。更多数据见docs fo Errors and Exceptions。