numpy.fromfunction

numpy.fromfunction(function, shape, *, dtype=<class 'float'>, like=None, **kwargs) [source]

Создаёт массив, применяя функцию к каждой координате.

Полученный массив, следовательно, имеет значение fn(x, y, z) в координате (x, y, z).

Параметры

functioncallable

Функция вызывается с N параметрами, где N — ранг shape. Каждый параметр представляет координаты массива, изменяющиеся вдоль определённой оси. Например, если shape было (2, 2), то параметрами были бы array([[0, 0], [1, 1]]) и array([[0, 1], [0, 1]])

shape(N,) tuple of ints

Форма выходного массива, которая также определяет форму массивов координат, передаваемых в function.

dtypedata-type, optional

Тип данных массивов координат, передаваемых в function. По умолчанию, dtype — float.

likearray_like

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

Примечание

Ключевое слово like — экспериментальная функция, ожидающая принятия NEP 35.

Введено в версии 1.20.0.

Возвращает

fromfunctionany

Результат вызова function возвращается напрямую. Поэтому форма fromfunction полностью определяется function. Если function возвращает скалярное значение, форма fromfunction не будет совпадать с параметром shape.

См. также

indices, meshgrid

Примечания

Ключевые слова, кроме dtype, передаются в function.

Примеры

>>> np.fromfunction(lambda i, j: i == j, (3, 3), dtype=int)
array([[ True, False, False],
       [False,  True, False],
       [False, False,  True]])

>>> np.fromfunction(lambda i, j: i + j, (3, 3), dtype=int)
array([[0, 1, 2],
       [1, 2, 3],
       [2, 3, 4]])