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。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。