numpy.fv

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

Вычисление будущей стоимости.

Дано:

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

Возврат:

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

Параметры:

rate : scalar or array_like of shape(M, ) Процентная ставка в виде десятичной дроби (не в процентах) за период nper : scalar or array_like of shape(M, ) Количество периодов начисления pmt : scalar or array_like of shape(M, ) Платеж pv : scalar or array_like of shape(M, ) Начальная стоимость when : {{‘begin’, 1}, {‘end’, 0}}, {string, int}, optional Время оплаты (‘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]. 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])