numpy.polynomial.legendre.legint#

polynomial.legendre.legint(c, m=1, k=[], lbnd=0, scl=1, axis=0)[source]#

对勒让德级数进行积分。

返回沿 axis 对勒让德级数系数 c 积分 m 次的结果。在每次迭代中,所得级数将乘以 scl,并添加积分常数 k。缩放因子用于变量的线性变化。(“买方注意”:请注意,根据所做操作的不同,可能需要将 scl 设置为与预期值相反的值;有关更多信息,请参阅下面的“注释”部分。)参数 c 是一个从低到高次幂的系数数组,沿每个轴排列,例如,[1,2,3] 表示级数 L_0 + 2*L_1 + 3*L_2,而 [[1,2],[1,2]] 表示 1*L_0(x)*L_0(y) + 1*L_1(x)*L_0(y) + 2*L_0(x)*L_1(y) + 2*L_1(x)*L_1(y),如果 axis=0 是 x 且 axis=1 是 y

参数:
carray_like

勒让德级数系数数组。如果 c 是多维的,则不同的轴对应于不同的变量,每个轴的次数由相应的索引给出。

mint, 可选

积分阶数,必须为正。(默认值:1)

k{[], list, scalar}, 可选

积分常数。第一个积分在 lbnd 处的值是列表中的第一个值,第二个积分在 lbnd 处的值是第二个值,依此类推。如果 k == [](默认值),则所有常数都设置为零。如果 m == 1,则可以提供单个标量而不是列表。

lbnd标量,可选

积分的下限。(默认值:0)

scl标量,可选

每次积分后,结果都会乘以 scl,然后再添加积分常数。(默认值:1)

axisint, 可选

进行积分的轴。(默认值:0)。

版本 1.7.0 中的新功能。

返回值:
Sndarray

积分的勒让德级数系数数组。

引发:
ValueError

如果 m < 0len(k) > mnp.ndim(lbnd) != 0np.ndim(scl) != 0

另请参阅

legder

注释

请注意,每次积分的结果都会乘以 scl。为什么要特别注意这一点?假设在相对于 x 的积分中进行变量的线性变化 \(u = ax + b\)。然后 \(dx = du/a\),因此需要将 scl 设置为 \(1/a\) - 这可能与最初的想法不一致。

另请注意,通常,C 级数积分的结果需要“重新投影”到 C 级数基集上。因此,通常情况下,此函数的结果“不直观”,尽管是正确的;请参阅下面的“示例”部分。

示例

>>> from numpy.polynomial import legendre as L
>>> c = (1,2,3)
>>> L.legint(c)
array([ 0.33333333,  0.4       ,  0.66666667,  0.6       ]) # may vary
>>> L.legint(c, 3)
array([  1.66666667e-02,  -1.78571429e-02,   4.76190476e-02, # may vary
         -1.73472348e-18,   1.90476190e-02,   9.52380952e-03])
>>> L.legint(c, k=3)
 array([ 3.33333333,  0.4       ,  0.66666667,  0.6       ]) # may vary
>>> L.legint(c, lbnd=-2)
array([ 7.33333333,  0.4       ,  0.66666667,  0.6       ]) # may vary
>>> L.legint(c, scl=2)
array([ 0.66666667,  0.8       ,  1.33333333,  1.2       ]) # may vary