numpy.require

numpy.require(a, dtype=None, requirements=None) [source]

Возвращает массив ndarray указанного типа, удовлетворяющий требованиям.

Эта функция полезна для обеспечения того, что возвращаемый массив имеет правильные флаги для передачи в скомпилированный код (возможно, через ctypes).

Параметры:

a : array_like Объект, который должен быть преобразован в массив, удовлетворяющий типу и требованиям. dtype : тип данных Требуемый тип данных. Если None, сохраняется текущий тип данных. Если ваше приложение требует, чтобы данные были в родном байтовом порядке, включите спецификацию байтового порядка в спецификацию типа данных. requirements : строка или список строк Список требований может быть любым из следующих: ‘F_CONTIGUOUS’ (‘F’) - обеспечивает Fortran-непрерывный массив ‘C_CONTIGUOUS’ (‘C’) - обеспечивает C-непрерывный массив ‘ALIGNED’ (‘A’) - обеспечивает выровненный тип данных массив ‘WRITEABLE’ (‘W’) - обеспечивает изменяемый массив ‘OWNDATA’ (‘O’) - обеспечивает массив, который владеет своими данными ‘ENSUREARRAY’, (‘E’) - обеспечивает базовый массив, а не подкласс

См. также

asarray

Преобразовать вход в ndarray.

asanyarray

Преобразовать в ndarray, но пропускать подклассы ndarray.

ascontiguousarray

Преобразовать вход в непрерывный массив.

asfortranarray

Преобразовать вход в ndarray с порядком памяти по столбцам.

ndarray.flags

Информация о планировке памяти массива.

Примечания

Возвращаемый массив гарантированно будет иметь указанные требования, создавая копию при необходимости.

Примеры

>>> x = np.arange(6).reshape(2,3)
>>> x.flags
  C_CONTIGUOUS : True
  F_CONTIGUOUS : False
  OWNDATA : False
  WRITEABLE : True
  ALIGNED : True
  UPDATEIFCOPY : False

>>> y = np.require(x, dtype=np.float32, requirements=['A', 'O', 'W', 'F'])
>>> y.flags
  C_CONTIGUOUS : False
  F_CONTIGUOUS : True
  OWNDATA : True
  WRITEABLE : True
  ALIGNED : True
  UPDATEIFCOPY : False