numpy.lib.stride_tricks.as_strided

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

Создаёт представление массива с заданной формой и шагом.

Предупреждение

Эта функция должна использоваться с большой осторожностью, см. примечания.

Параметры:

x : ndarray Массив, для которого нужно создать новое представление. shape : sequence of int, optional Форма нового массива. По умолчанию x.shape. strides : sequence of int, optional Шаги нового массива. По умолчанию x.strides. subok : bool, optional Новое в версии 1.10. Если True, подклассы сохраняются. writeable : bool, optional Новое в версии 1.12. Если установлено в False, возвращаемый массив всегда будет только для чтения. В противном случае он будет изменяемым, если исходный массив был изменяемым. Рекомендуется установить это значение в False, если это возможно (см. Примечания).

Возвращает:

view : ndarray

См. также

broadcast_to

расширить массив до заданной формы.

reshape

изменить форму массива.

Примечания

as_strided создаёт представление массива с заданными шагами и формой. Это означает, что он манипулирует внутренней структурой данных ndarray и, если это сделано неправильно, элементы массива могут указывать на недопустимую память и могут испортить результаты или привести к сбою вашей программы. Рекомендуется всегда использовать исходный x.strides при расчёте новых шагов, чтобы избежать зависимости от непрерывного расположения памяти.

Кроме того, массивы, созданные с помощью этой функции, часто содержат перекрывающуюся память, так что два элемента идентичны. Векторизованные операции записи в такие массивы обычно будут непредсказуемыми. Они могут даже давать разные результаты для малых, больших или транспонированных массивов. Поскольку запись в эти массивы должна быть проверена и выполнена с большой осторожностью, вы можете использовать writeable=False для предотвращения случайных операций записи.

По этим причинам желательно избегать as_strided когда это возможно.