numpy.ndarray

class 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

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

Примечания

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

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

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

Примеры

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

Первый режим, 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	Итератор по массиву в виде одномерного массива.
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, keepdims])	Возвращает максимальное значение по заданной оси.
mean([axis, dtype, out, keepdims])	Возвращает среднее значение элементов массива по заданной оси.
min([axis, out, keepdims])	Возвращает минимальное значение по заданной оси.
newbyteorder([new_order])	Возвращает массив с теми же данными, но с другим порядком байтов.
nonzero()	Возвращает индексы элементов, не равных нулю.
partition(kth[, axis, kind, order])	Переупорядочивает элементы массива таким образом, что значение элемента в позиции kth находится в той позиции, в которой оно находилось бы в отсортированном массиве.
prod([axis, dtype, out, keepdims])	Возвращает произведение элементов массива по заданной оси.
ptp([axis, out])	Значение от пика до пика (максимум - минимум) по заданной оси.
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, чтобы сохранить порядок.
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])	Возвращает стандартное отклонение элементов массива по заданной оси.
sum([axis, dtype, out, keepdims])	Возвращает сумму элементов массива по заданной оси.
swapaxes(axis1, axis2)	Возвращает представление массива с перестановкой осей axis1 и axis2.
take(indices[, axis, out, mode])	Возвращает массив, составленный из элементов a по заданным индексам.

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