numpy.ndarray

class numpy.ndarray [source]

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

Массивы должны быть созданы с помощью array, zeros или empty (см. раздел «См. также» ниже). Параметры, приведенные здесь, относятся к низкоуровневому методу (ndarray(...)) для создания массива.

Для получения дополнительной информации обратитесь к модулю numpy и изучите методы и атрибуты массива.

Параметры:

(для метода __new__; см. Примечания ниже) shape : кортеж целых чисел Форма создаваемого массива. dtype : тип данных, необязательно Любой объект, который может быть интерпретирован как тип данных numpy. buffer : объект, предоставляющий интерфейс буфера, необязательно Используется для заполнения массива данными. offset : целое число, необязательно Смещение данных массива в буфере. strides : кортеж целых чисел, необязательно Шаги данных в памяти. order : {‘C’, ‘F’}, необязательно Строка-главный (стиль C) или столбец-главный (стиль Fortran) порядок.

См. также

array

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

zeros

Создать массив, каждый элемент которого равен нулю.

empty

Создать массив, но оставить его выделенную память неизменной (т. е. он содержит «мусор»).

dtype

Создать тип данных.

Примечания

Существует два режима создания массива с помощью __new__:

1. Если buffer равно None, то используются только shape, dtype и order.
2. Если buffer является объектом, предоставляющим интерфейс буфера, то все ключевые слова интерпретируются.

Метод __init__ не нужен, потому что массив полностью инициализирован после метода __new__.

Примеры

Эти примеры иллюстрируют низкоуровневый конструктор ndarray. Обратитесь к разделу See Also выше, чтобы узнать более простые способы построения ndarray.

Первый режим, buffer равно None:

>>> np.ndarray(shape=(2,2), dtype=float, order='F')
array([[ -1.13698227e+002,   4.25087011e-303],
       [  2.88528414e-306,   3.27025015e-309]])         #random

Второй режим:

>>> np.ndarray((2,), buffer=np.array([1,2,3]),
...            offset=np.int_().itemsize,
...            dtype=int) # offset = 1*itemsize, i.e. skip first element
array([2, 3])

Атрибуты

T	То же самое, что и self.transpose(), за исключением того, что self возвращается, если self.ndim < 2.
data	Объект буфера Python, указывающий на начало данных массива.
dtype	Тип данных элементов массива.
flags	Информация о расположении памяти массива.
flat	Итератор 1D по массиву.
imag	Мнимая часть массива.
real	Вещественная часть массива.
size	Количество элементов в массиве.
itemsize	Длина одного элемента массива в байтах.
nbytes	Общее количество байтов, занимаемых элементами массива.
ndim	Количество измерений массива.
shape	Кортеж измерений массива.
strides	Кортеж байтов, которые необходимо сделать шаг в каждом измерении при прохождении по массиву.
ctypes	Объект для упрощения взаимодействия массива с модулем ctypes.
base	Базовый объект, если память взята из другого объекта.

Методы

all([axis, out, keepdims])	Возвращает True, если все элементы равны True.
any([axis, out, keepdims])	Возвращает True, если любой из элементов a равен True.
argmax([axis, out])	Возвращает индексы максимальных значений вдоль заданной оси.
argmin([axis, out])	Возвращает индексы минимальных значений вдоль заданной оси массива a.
argpartition(kth[, axis, kind, order])	Возвращает индексы, которые бы разделили этот массив.
argsort([axis, kind, order])	Возвращает индексы, которые бы отсортировали этот массив.
astype(dtype[, order, casting, subok, copy])	Копия массива, преобразованная к указанному типу.
byteswap(inplace)	Меняет байты элементов массива.
choose(choices[, out, mode])	Использует массив индексов для создания нового массива из набора вариантов.
clip([min, max, out])	Возвращает массив, значения которого ограничены [min, max].
compress(condition[, axis, out])	Возвращает выбранные срезы этого массива вдоль заданной оси.
conj()	Комплексно сопряжённые все элементы.
conjugate()	Возвращает комплексно сопряжённое значение для каждого элемента.
copy([order])	Возвращает копию массива.
cumprod([axis, dtype, out])	Возвращает кумулятивное произведение элементов вдоль заданной оси.
cumsum([axis, dtype, out])	Возвращает кумулятивную сумму элементов вдоль заданной оси.
diagonal([offset, axis1, axis2])	Возвращает указанные диагонали.
dot(b[, out])	Векторное произведение двух массивов.
dump(file)	Сохраняет пикл массива в указанный файл.
dumps()	Возвращает пикл массива в виде строки.
fill(value)	Заполняет массив скалярным значением.
flatten([order])	Возвращает копию массива, сжатого в одну размерность.
getfield(dtype[, offset])	Возвращает поле данного массива как определённый тип.
item(*args)	Копирует элемент массива в стандартный скаляр Python и возвращает его.
itemset(*args)	Вставляет скаляр в массив (скаляр приводится к типу массива, если возможно).
max([axis, out])	Возвращает максимум вдоль заданной оси.
mean([axis, dtype, out, keepdims])	Возвращает среднее значение элементов массива вдоль заданной оси.
min([axis, out, keepdims])	Возвращает минимум вдоль заданной оси.
newbyteorder([new_order])	Возвращает массив с теми же данными, но с другим порядком байтов.
nonzero()	Возвращает индексы элементов, отличных от нуля.
partition(kth[, axis, kind, order])	Переупорядочивает элементы в массиве таким образом, что значение элемента в k-ой позиции находится в позиции, в которой оно было бы в отсортированном массиве.
prod([axis, dtype, out, keepdims])	Возвращает произведение элементов массива по заданной оси.
ptp([axis, out])	Значение от пика до пика (максимум - минимум) вдоль заданной оси.
put(indices, values[, mode])	Устанавливает a.flat[n] = values[n] для всех n в индексах.
ravel([order])	Возвращает сплющенный массив.
repeat(repeats[, axis])	Повторяет элементы массива.
reshape(shape[, order])	Возвращает массив с теми же данными, но с новой формой.
resize(new_shape[, refcheck])	Изменяет форму и размер массива на месте.
round([decimals, out])	Возвращает массив с каждым элементом, округленным до заданного числа десятичных знаков.
searchsorted(v[, side, sorter])	Находит индексы, где элементы v должны быть вставлены в a для сохранения порядка.
setfield(val, dtype[, offset])	Помещает значение в указанное место в поле, определённом типом данных.
setflags([write, align, uic])	Устанавливает флаги массива WRITEABLE, ALIGNED и UPDATEIFCOPY соответственно.
sort([axis, kind, order])	Сортирует массив на месте.
squeeze([axis])	Удаляет одноразмерные элементы из формы a.
std([axis, dtype, out, ddof, keepdims])	Возвращает стандартное отклонение элементов массива вдоль заданной оси.
sum([axis, dtype, out, keepdims])	Возвращает сумму элементов массива по заданной оси.
swapaxes(axis1, axis2)	Возвращает представление массива с осями axis1 и axis2 поменяными местами.

take(indices[, axis, out, mode])	Возвращает массив, сформированный из элементов a по заданным индексам.
tobytes([order])	Построить Python bytes, содержащие сырые байты данных в массиве.
tofile(fid[, sep, format])	Записать массив в файл как текст или двоичные данные (по умолчанию).
tolist()	Возвращает массив как (возможно, вложенный) список.
tostring([order])	Построить Python bytes, содержащие сырые байты данных в массиве.
trace([offset, axis1, axis2, dtype, out])	Возвращает сумму по диагоналям массива.
transpose(*axes)	Возвращает представление массива с переставленными осями.
var([axis, dtype, out, ddof, keepdims])	Возвращает дисперсию элементов массива вдоль заданной оси.
view([dtype, type])	Новое представление массива с теми же данными.