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 : последовательность целых чисел, необязательно Форма нового массива. По умолчанию x.shape. strides : последовательность целых чисел, необязательно Шаги нового массива. По умолчанию x.strides. subok : bool, необязательно Введено в версии 1.10. Если True, подклассы сохраняются. writeable : bool, необязательно Введено в версии 1.12. Если установлено в False, возвращаемый массив всегда будет только для чтения. В противном случае он будет изменяемым, если исходный массив был изменяемым. Рекомендуется установить это значение в False, если это возможно (см. примечания).

Возвращает:

view : ndarray

См. также

broadcast_to

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

reshape

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

Примечания

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

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

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