numpy.ndarray.resize

метод

ndarray.resize(new_shape, refcheck=True)

Изменение формы и размера массива на месте.

Параметры

new_shapeкортеж целых чисел или n целые числа

Форма изменённого массива.

refcheckbool, необязательно

Если False, счётчик ссылок не проверяется. По умолчанию True.

Возвращает

None

Возбуждает

ValueError

Если a не владеет своими данными или существуют ссылки или представления на него, и память данных должна быть изменена. Только PyPy: всегда будет возбуждать исключение, если память данных должна быть изменена, так как нет надёжного способа определить, существуют ли ссылки или представления на неё.

SystemError

Если указан ключевой аргумент order. Такое поведение является ошибкой в NumPy.

См. также

resize

Возвращает новый массив с указанной формой.

Примечания

При необходимости перераспределяет память для области данных.

Изменять размер можно только для непрерывных массивов (элементы данных находятся в памяти последовательно).

Цель проверки счётчика ссылок — убедиться, что вы не используете этот массив в качестве буфера для другого объекта Python, а затем не перераспределяете память. Однако счётчики ссылок могут увеличиваться и другими способами, поэтому, если вы уверены, что не разделяете память этого массива с другим объектом Python, то можете безопасно установить refcheck в False.

Примеры

Уменьшение размера массива: массив сжимается (в порядке хранения данных в памяти), изменяется размер и формируется заново:

>>> a = np.array([[0, 1], [2, 3]], order='C')
>>> a.resize((2, 1))
>>> a
array([[0],
       [1]])

>>> a = np.array([[0, 1], [2, 3]], order='F')
>>> a.resize((2, 1))
>>> a
array([[0],
       [2]])

Увеличение размера массива: как выше, но отсутствующие элементы заполняются нулями:

>>> b = np.array([[0, 1], [2, 3]])
>>> b.resize(2, 3) # new_shape parameter doesn't have to be a tuple
>>> b
array([[0, 1, 2],
       [3, 0, 0]])

Ссылка на массив препятствует его изменению размера…

>>> c = a
>>> a.resize((1, 1))
Traceback (most recent call last):
...
ValueError: cannot resize an array that references or is referenced ...

Если refcheck равно False:

>>> a.resize((1, 1), refcheck=False)
>>> a
array([[0]])
>>> c
array([[0]])