Python numpy fv用法及代码示例

用法： numpy.fv(rate, nper, pmt, pv, when='end')

计算未来价值。

鉴于：

现值，pv
一个兴趣rate每期复利一次，其中有
nper总
(固定)付款，pmt，支付
在每个期间的开始(当= {‘begin’，1})或结束(当= {‘end’，0})

返回：

末尾的值nper期间

参数：	rate：： scalar 或 array_like of shape(M, ) 每个周期的利率为小数点(非百分比) nper：： scalar 或 array_like of shape(M, ) 复利期数 pmt：： scalar 或 array_like of shape(M, ) 付款 pv：： scalar 或 array_like of shape(M, ) 目前的价值 when：： {{‘begin’, 1}, {‘end’, 0}}, {string, int}, 可选参数付款到期时(‘begin’(1)或‘end’(0))。默认为{‘end’，0}。
返回值：	out：： ndarray 未来价值。如果所有输入均为标量，则返回标量浮点数。如果任何输入类似于数组，则返回每个输入元素的将来值。如果多个输入类似于array_，则它们都必须具有相同的形状。

参数：

rate：： scalar 或 array_like of shape(M, ): 每个周期的利率为小数点(非百分比)
nper：： scalar 或 array_like of shape(M, ): 复利期数
pmt：： scalar 或 array_like of shape(M, ): 付款
pv：： scalar 或 array_like of shape(M, ): 目前的价值
when：： {{‘begin’, 1}, {‘end’, 0}}, {string, int}, 可选参数: 付款到期时(‘begin’(1)或‘end’(0))。默认为{‘end’，0}。

返回值：

out：： ndarray: 未来价值。如果所有输入均为标量，则返回标量浮点数。如果任何输入类似于数组，则返回每个输入元素的将来值。如果多个输入类似于array_，则它们都必须具有相同的形状。

注意：

未来值通过求解方程式计算得出：

fv +
pv*(1+rate)**nper +
pmt*(1 + rate*when)/rate*((1 + rate)**nper - 1) == 0

或者，何时rate == 0：

fv + pv + pmt * nper == 0

参考文献：

[WRW]

Wheeler，D.A.，E.Rathke和R.Weir(编辑)(2009年5月)。 Office应用程序的Open Document格式(OpenDocument)v1.2，第2部分：重新计算的公式(OpenFormula)格式-带注释的版本，预草稿。12.结构化信息标准促进组织(OASIS)。美国马萨诸塞州比勒里卡。 [ODT文件]。可用的：http://www.oasis-open.org/committees/documents.php?wg_abbrev=office-formulaOpenDocument-formula-20090508.odt

例子：

十年后，现在每年节省100美元，每月再节省100美元，那么将来的价值是多少。假设利率是5％(每年)复利？

>>> np.fv(0.05/12, 10*12, -100, -100)
15692.928894335748

按照惯例，负号表示现金流出(即今天没有钱)。因此，每月以$5％的年利率节省$100，即可在10年内支出$15,692.93。

如果任何输入为数组，则返回形状相同的数组。让我们比较上面示例中的不同利率。

>>> a = np.array((0.05, 0.06, 0.07))/12
>>> np.fv(a, 10*12, -100, -100)
array([ 15692.92889434,  16569.87435405,  17509.44688102]) # may vary

源码：

numpy.fv的API实现见：[源代码]

注：本文由纯净天空筛选整理自 numpy.fv。非经特殊声明，原始代码版权归原作者所有，本译文未经允许或授权，请勿转载或复制。