numpy.ascontiguousarray

numpy.ascontiguousarray(a, dtype=None, *, like=None)

Возвращает непрерывный массив (ndim >= 1) в памяти (порядок C).

Параметры:

aarray_like

Входной массив.

dtypestr или dtype object, необязательно

Тип данных возвращаемого массива.

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

Ссылка на объект, позволяющая создавать массивы, которые не являются массивами NumPy. Если переданный в виде like массив-подобный объект поддерживает протокол __array_function__, результат будет определяться им. В этом случае гарантируется создание объекта массива, совместимого с переданным через этот аргумент.

Добавлена в версии 1.20.0.

Возвращает:

outndarray

Непрерывный массив той же формы и содержимого, что и a, с типом dtype, если указано.

См. также

asfortranarray

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

require

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

ndarray.flags

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

Примеры

Начинаем с Fortran-непрерывного массива:

>>> x = np.ones((2, 3), order='F')
>>> x.flags['F_CONTIGUOUS']
True

Вызов ascontiguousarray создает копию с непрерывностью в порядке C:

>>> y = np.ascontiguousarray(x)
>>> y.flags['C_CONTIGUOUS']
True
>>> np.may_share_memory(x, y)
False

Теперь начинаем с C-непрерывного массива:

>>> x = np.ones((2, 3), order='C')
>>> x.flags['C_CONTIGUOUS']
True

Затем, вызов ascontiguousarray возвращает тот же объект:

>>> y = np.ascontiguousarray(x)
>>> x is y
True

Примечание: Эта функция возвращает массив с по крайней мере одним измерением (1-d), поэтому она не сохранит 0-мерные массивы.