numpy.lib.stride_tricks.as_strided

lib.stride_tricks.as_strided(x, shape=None, strides=None, subok=False, writeable=True)

创建一个具有给定形状和步幅的数组视图。

警告

必须非常小心地使用此函数，请参阅注意事项。

参数:

xndarray

要创建新数组的数组。

shape整数序列, 可选

新数组的形状。默认为 x.shape。

strides整数序列, 可选

新数组的步幅。默认为 x.strides。

subokbool, optional

如果为 True，则保留子类。

writeable布尔值, 可选

如果设置为 False，则返回的数组将始终是只读的。否则，如果原始数组可写，它也将是可写的。建议尽可能将其设置为 False（请参阅注意事项）。

返回:

viewndarray

另请参阅

broadcast_to

将数组广播到给定形状。

reshape

重塑数组。

lib.stride_tricks.sliding_window_view

用于创建滑动窗口视图的易于使用且安全的功能。

备注

as_strided 根据确切的步幅和形状创建数组的视图。这意味着它会操纵 ndarray 的内部数据结构，如果操作不当，数组元素可能会指向无效内存，并可能损坏结果或导致程序崩溃。建议在计算新步幅时始终使用原始 x.strides，以避免依赖于连续的内存布局。

此外，使用此函数创建的数组通常包含自重叠内存，因此两个元素是相同的。对这类数组进行的矢量化写入操作通常是不可预测的。它们甚至可能对小型、大型或转置的数组产生不同的结果。

由于必须经过测试且需要非常小心地对这些数组进行写入操作，因此您可能希望使用 writeable=False 来避免意外的写入操作。

由于这些原因，建议尽可能避免使用 as_strided。