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% годовых процентной ставке приводит к 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])