numpy.fv

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

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

Устарело начиная с версии 1.18: fv устарело; подробности см. в NEP 32 [1]. Используйте соответствующую функцию в библиотеке numpy-financial, https://pypi.org/project/numpy-financial.

Дано:

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

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

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

Параметры

ratescalar or array_like of shape(M, )

Процентная ставка в десятичном виде (не в процентах) за период

nperscalar or array_like of shape(M, )

Количество периодов начисления

pmtscalar or array_like of shape(M, )

Платеж

pvscalar or array_like of shape(M, )

Настоящая стоимость

when{{‘begin’, 1}, {‘end’, 0}}, {string, int}, optional

Когда платежи приходятся (‘begin’ (1) или ‘end’ (0)). По умолчанию {‘end’, 0}.

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

outndarray

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

Примечания

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

fv +
pv*(1+rate)**nper +
pmt*(1 + rate*when)/rate*((1 + rate)**nper - 1) == 0

или, когда rate == 0:

fv + pv + pmt * nper == 0

Ссылки

1

Предложение NumPy по улучшению (NEP) 32, https://numpy.org/neps/nep-0032-remove-financial-functions.html

2

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]) # may vary