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 : массив Будущие значения. Если все входные данные являются скалярами, возвращается скалярное значение с плавающей точкой. Если какие-либо входные данные являются массивоподобными, возвращаются будущие значения для каждого элемента входных данных. Если несколько входных данных являются массивоподобными, они должны иметь одинаковую форму.

Примечания

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

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]. Available: 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% годовых приводит к 15 692,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])