numpy.ma.fromfunction#

ma.fromfunction(function, shape, **dtype) = <numpy.ma.core._convert2ma object>#

通过对每个坐标执行函数来构造数组。

因此,生成的数组在坐标 (x, y, z) 处的值为 fn(x, y, z)

参数:
function可调用对象

该函数将使用 N 个参数调用,其中 N 是 shape 的秩。每个参数表示数组沿特定轴变化的坐标。例如,如果 shape(2, 2),那么参数将是 array([[0, 0], [1, 1]])array([[0, 1], [0, 1]])

shape(N,) 整数元组

输出数组的形状,这也决定了传递给 function 的坐标数组的形状。

dtype数据类型,可选

传递给 function 的坐标数组的数据类型。默认情况下,dtype 为浮点数。

like类数组,可选

引用对象,允许创建非 NumPy 数组。如果作为 like 传入的类数组对象支持 __array_function__ 协议,则结果将由其定义。在这种情况下,它确保创建与通过此参数传入的对象兼容的数组对象。

1.20.0 版本新增。

返回:
fromfunction: MaskedArray

function 的调用结果会直接返回。因此,fromfunction 的形状完全由 function 决定。如果 function 返回一个标量值,则 fromfunction 的形状将不匹配 shape 参数。

另请参阅

indices, meshgrid

注意

dtypelike 之外的关键字参数都将传递给 function

示例

>>> import numpy as np
>>> np.fromfunction(lambda i, j: i, (2, 2), dtype=float)
array([[0., 0.],
       [1., 1.]])
>>> np.fromfunction(lambda i, j: j, (2, 2), dtype=float)
array([[0., 1.],
       [0., 1.]])
>>> 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]])