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 при возможности.