numpy.fv

numpy.fv(rate, nper, pmt, pv, when='end') [source]

Вычислить будущую стоимость.

Дано:

• начальная стоимость, pv
• процентная ставка rate с начислением один раз за период, из которых
• nper всего
• фиксированный платёж, pmt, уплачиваемый
• в начале (when = {‘begin’, 1}) или в конце (when = {‘end’, 0}) каждого периода

Возвращаемое значение:

значение в конце nper периодов

Параметры:

rate : скаляр или массив_подобный формы(M, ) Процентная ставка в десятичном виде (а не в процентах) за период nper : скаляр или массив_подобный формы(M, ) Количество периодов начисления pmt : скаляр или массив_подобный формы(M, ) Платёж pv : скаляр или массив_подобный формы(M, ) Настоящая стоимость when : {{‘begin’, 1}, {‘end’, 0}}, {строка, целое число}, необязательно Когда платёжи осуществляются (‘begin’ (1) или ‘end’ (0)). По умолчанию {‘end’, 0}.

Возвращаемое значение:

out : ndarray Будущая стоимость. Если все входные данные являются скалярами, возвращает скалярное число с плавающей запятой. Если какие-либо входные данные являются массив_подобными, возвращает будущую стоимость для каждого элемента входных данных. Если несколько входных данных являются массив_подобными, они все должны иметь одинаковую форму.

Примечания

Будущая стоимость вычисляется путём решения уравнения:

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, and R. Weir (Eds.) (2009, May). Open Document Format for Office Applications (OpenDocument)v1.2, Part 2: Recalculated Formula (OpenFormula) Format - Annotated Version, Pre-Draft 12. Organization for the Advancement of Structured Information Standards (OASIS). Billerica, MA, USA. [ODT Document]. Доступно: http://www.oasis-open.org/committees/documents.php?wg_abbrev=office-formula OpenDocument-formula-20090508.odt

Примеры

Какова будущая стоимость через 10 лет, если сейчас откладывается 100 у.е. и ежемесячно откладывается ещё по 100 у.е. Предполагается, что процентная ставка составляет 5% (годовых), начисляемая ежемесячно?

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

По соглашению, отрицательный знак обозначает отток денежных средств (т.е. деньги, которые недоступны сегодня). Таким образом, откладывание по 100 у.е. в месяц при 5% годовых приносит 15692,93 у.е., которые можно потратить через 10 лет.

Если какой-либо вход является массив_подобным, возвращается массив с одинаковой формой. Сравним различные процентные ставки из предыдущего примера.

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