numpy.ndarray

классnumpy.ndarray(shape, dtype=float, buffer=None, offset=0, strides=None, order=None)[source]

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

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

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

Параметры

(для метода __new__; см. Примечания ниже)

shapeкортеж целых чисел

Форма создаваемого массива.

dtypeтип данных, необязательно

Любой объект, который может быть интерпретирован как тип данных NumPy.

bufferобъект, предоставляющий интерфейс буфера, необязательно

Используется для заполнения массива данными.

offsetцелое число, необязательно

Смещение данных массива в буфере.

stridesкортеж целых чисел, необязательно

Шаги данных в памяти.

order{‘C’, ‘F’}, необязательно

Порядок строк (стиль C) или столбцов (стиль Fortran).

См. также

array

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

zeros

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

empty

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

dtype

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

numpy.typing.NDArray

Обобщённая версия ndarray.

Примечания

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

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

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

Примеры

Эти примеры иллюстрируют низкоуровневый конструктор ndarray. Для более лёгких способов создания ndarray см. раздел See Also выше.

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

>>> np.ndarray(shape=(2,2), dtype=float, order='F')
array([[0.0e+000, 0.0e+000], # random
       [     nan, 2.5e-323]])

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

>>> 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])

Атрибуты

Tndarray

Транспонированный массив.

dataбуфер

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

dtypeобъект dtype

Тип данных элементов массива.

flagsсловарь

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

flatобъект numpy.flatiter

Итератор по массиву в 1-D формате.

imagndarray

Мнимая часть массива.

realndarray

Вещественная часть массива.

sizeцелое число

Количество элементов в массиве.

itemsizeцелое число

Длина одного элемента массива в байтах.

nbytesцелое число

Общее количество байтов, занимаемых элементами массива.

ndimцелое число

Количество измерений массива.

shapeкортеж целых чисел

Кортеж измерений массива.

stridesкортеж целых чисел

Кортеж байтов для перемещения по каждому измерению при проходе по массиву.

ctypesобъект ctypes

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

basendarray

Базовый объект, если память взята из другого объекта.

Методы

all([axis, out, keepdims, where])	Возвращает True, если все элементы равны True.
any([axis, out, keepdims, where])	Возвращает True, если какой-либо из элементов a равен True.
argmax([axis, out])	Возвращает индексы максимальных значений по заданной оси.
argmin([axis, out])	Возвращает индексы минимальных значений по заданной оси.
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, keepdims, initial, where])	Возвращает максимум вдоль заданной оси.
mean([axis, dtype, out, keepdims, where])	Возвращает среднее значение элементов массива вдоль заданной оси.
min([axis, out, keepdims, initial, where])	Возвращает минимум вдоль заданной оси.
newbyteorder([new_order])	Возвращает массив с теми же данными, но с другим порядком байтов.
nonzero()	Возвращает индексы элементов, которые не равны нулю.
partition(kth[, axis, kind, order])	Переупорядочивает элементы в массиве таким образом, что значение элемента в позиции kth находится в той позиции, в которой оно находилось бы в отсортированном массиве.
prod([axis, dtype, out, keepdims, initial, …])	Возвращает произведение элементов массива по заданной оси.
ptp([axis, out, keepdims])	Значение от пика до пика (максимум - минимум) вдоль заданной оси.
put(indices, values[, mode])	Устанавливает a.flat[n] = values[n] для всех n в indices.
ravel([order])	Возвращает сглаженный массив.
repeat(repeats[, axis])	Повторяет элементы массива.
reshape(shape[, order])	Возвращает массив, содержащий те же данные с новой формой.
resize(new_shape[, refcheck])	Изменяет форму и размер массива на месте.
round([decimals, out])	Возвращает a с каждым элементом, округлённым до заданного количества десятичных знаков.
searchsorted(v[, side, sorter])	Находит индексы, где элементы v должны быть вставлены в a для поддержания порядка.
setfield(val, dtype[, offset])	Поместить значение в указанное место в поле, определенное типом данных.
setflags([write, align, uic])	Устанавливает флаги массива WRITEABLE, ALIGNED, (WRITEBACKIFCOPY и UPDATEIFCOPY), соответственно.
sort([axis, kind, order])	Сортирует массив на месте.
squeeze([axis])	Удаляет оси длиной один из a.
std([axis, dtype, out, ddof, keepdims, where])	Возвращает стандартное отклонение элементов массива вдоль заданной оси.
sum([axis, dtype, out, keepdims, initial, where])	Возвращает сумму элементов массива по заданной оси.

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