numpy.recarray.resize

метод

recarray.resize(new_shape, refcheck=True)

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

Параметры:	new_shape : tuple of ints, or n ints Форма изменённого массива. refcheck : bool, optional Если 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 has been referenced ...

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

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