numpy.array

numpy.array(object, dtype=None, *, copy=True, order='K', subok=False, ndmin=0)

Создать массив.

Параметры

objectarray_like

Массив, любой объект, экспонирующий интерфейс массива, объект, метод __array__ которого возвращает массив, или любая (вложенная) последовательность.

dtypedata-type, optional

Желаемый тип данных для массива. Если не указано, тип будет определён как минимальный тип, необходимый для хранения объектов в последовательности.

copybool, optional

Если True (по умолчанию), то объект копируется. В противном случае, копия будет создана только если __array__ возвращает копию, если obj является вложенной последовательностью или если копия необходима для удовлетворения любых других требований (dtype, order, и т. д.).

order{‘K’, ‘A’, ‘C’, ‘F’}, optional

Указывает порядок расположения памяти в массиве. Если объект не является массивом, созданный массив будет в порядке C (строчный) за исключением указания «F», в котором случае он будет в порядке Fortran (столбцовый). Если объект является массивом, то выполняется следующее.

order	no copy	copy=True
‘K’	без изменений	сохраняется порядок F и C, в противном случае самый похожий порядок
‘A’	без изменений	порядок F, если вход F и не C, в противном случае порядок C
‘C’	порядок C	порядок C
‘F’	порядок F	порядок F

Когда copy=False и копия создаётся по другим причинам, результат тот же, что и если copy=True, за некоторыми исключениями для A, см. раздел Примечания. По умолчанию order — ‘K’.

subokbool, optional

Если True, то подклассы будут передаваться, в противном случае возвращаемый массив будет принудительно преобразован в массив базового класса (по умолчанию).

ndminint, optional

Указывает минимальное количество измерений, которое должен иметь результирующий массив. Единицы будут добавляться в форму, чтобы удовлетворить этому требованию.

Возвращает

outndarray

Объект массива, удовлетворяющий указанным требованиям.

См. также

empty_like

Возвращает пустой массив с формой и типом ввода.

ones_like

Возвращает массив единиц с формой и типом ввода.

zeros_like

Возвращает массив нулей с формой и типом ввода.

full_like

Возвращает новый массив с формой ввода, заполненный значением.

empty

Возвращает новый неинициализированный массив.

ones

Возвращает новый массив, устанавливающий значения в единицу.

zeros

Возвращает новый массив, устанавливающий значения в ноль.

full

Возвращает новый массив заданной формы, заполненный значением.

Примечания

Когда order — ‘A’ и object — массив ни в порядке ‘C’, ни в порядке ‘F’, и копия принудительно создаётся из-за изменения типа данных, то порядок результата не обязательно ‘C’, как ожидалось. Это, вероятно, ошибка.

Примеры

>>> np.array([1, 2, 3])
array([1, 2, 3])

Преобразование типов:

>>> np.array([1, 2, 3.0])
array([ 1.,  2.,  3.])

Более одного измерения:

>>> np.array([[1, 2], [3, 4]])
array([[1, 2],
       [3, 4]])

Минимальное количество измерений 2:

>>> np.array([1, 2, 3], ndmin=2)
array([[1, 2, 3]])

Указан тип:

>>> np.array([1, 2, 3], dtype=complex)
array([ 1.+0.j,  2.+0.j,  3.+0.j])

Тип данных, состоящий из более чем одного элемента:

>>> x = np.array([(1,2),(3,4)],dtype=[('a','<i4'),('b','<i4')])
>>> x['a']
array([1, 3])

Создание массива из подклассов:

>>> np.array(np.mat('1 2; 3 4'))
array([[1, 2],
       [3, 4]])

>>> np.array(np.mat('1 2; 3 4'), subok=True)
matrix([[1, 2],
        [3, 4]])