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

Ссылки

[WRW20]

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% приводит к 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])