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 < 0
、len(k) > m
、np.ndim(lbnd) != 0
或np.ndim(scl) != 0
。
另请参阅
注释
请注意,每次积分的结果都会乘以 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