numpy.pv

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

Вычислить текущую стоимость.

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

Дано:

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

Возвращает:

текущую стоимость

Параметры

ratearray_like

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

nperarray_like

Количество периодов капитализации

pmtarray_like

Платеж

fvarray_like, optional

Будущее значение

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

Время платежей (‘begin’ (1) или ‘end’ (0))

Возвращает

outndarray, float

Текущая стоимость серии платежей или инвестиций.

Примечания

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

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

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

fv + pv + pmt * nper = 0

для pv, которое затем возвращается.

Ссылки

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]. Доступно по адресу: http://www.oasis-open.org/committees/documents.php?wg_abbrev=office-formula OpenDocument-formula-20090508.odt

Примеры

Какова текущая стоимость (например, начальная инвестиция) инвестиции, которая должна составить 15692,93 долл. США через 10 лет сбережения 100 долл. США каждый месяц? Предполагается, что процентная ставка составляет 5% (в год), капитализируемая ежемесячно.

>>> np.pv(0.05/12, 10*12, -100, 15692.93)
-100.00067131625819

По соглашению, отрицательный знак означает отток денежных средств (то есть деньги, которые недоступны сегодня). Таким образом, чтобы в конце 10 лет сбережения 100 долл. США ежемесячно при 5% годовых, получить 15692,93 долл. США, первоначальный взнос также должен составлять 100 долл. США.

Если любой вход является массивом, pv возвращает массив с равными размерами. Давайте сравним разные процентные ставки в приведенном выше примере:

>>> a = np.array((0.05, 0.04, 0.03))/12
>>> np.pv(a, 10*12, -100, 15692.93)
array([ -100.00067132,  -649.26771385, -1273.78633713]) # may vary

Таким образом, чтобы получить те же 15692,93 долл. США при той же «сберегательной программе» в 100 долл. США ежемесячно, для годовых процентных ставок 4% и 3%, первоначальные инвестиции должны составлять 649,27 долл. США и 1273,79 долл. США соответственно.