numpy.npv

numpy.npv(rate, values) [source]

Возвращает чистую приведенную стоимость (ЧПС) последовательности потоков денежных средств.

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

Parameters

ratescalar

Ставка дисконтирования.

valuesarray_like, shape(M, )

Значения временного ряда потоков денежных средств. Период между потоками денежных средств должен быть таким же, как и для rate (т.е., если rate выражена в год, то между каждым потоком денежных средств проходит ровно один год). По соглашению, инвестиции или «депозиты» являются отрицательными, доход или «снятия» — положительными; values должен начинаться с начальной инвестиции, поэтому values[0] обычно будет отрицательным.

Returns

outfloat

ЧПС входного ряда потоков денежных средств values при ставке дисконтирования rate.

Предупреждение

npv рассматривает ряд потоков денежных средств, начинающийся в настоящем времени (t = 0). ЧПС также может быть определена с рядом будущих потоков денежных средств, уплачиваемых в конце, а не в начале каждого периода. Если используются будущие потоки денежных средств, первый поток values[0] должен быть обнулен и добавлен к чистой приведенной стоимости будущих потоков денежных средств. Это показано в примерах.

Примечания

Возвращает результат:

Ссылки

1

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

2

Л. Дж. Гитман, «Принципы финансового менеджмента, краткое изложение», 3-е изд., Addison-Wesley, 2003, стр. 346.

Примеры

Рассмотрим потенциальный проект с начальными инвестициями в размере 40 000 долл. США и прогнозируемыми денежными потоками в размере 5 000, 8 000, 12 000 и 30 000 долл. США в конце каждого периода с дисконтированием по ставке 8% в период. Чтобы найти чистую приведенную стоимость проекта:

>>> rate, cashflows = 0.08, [-40_000, 5_000, 8_000, 12_000, 30_000]
>>> np.npv(rate, cashflows).round(5)
3065.22267

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

>>> initial_cashflow = cashflows[0]
>>> cashflows[0] = 0
>>> np.round(np.npv(rate, cashflows) + initial_cashflow, 5)
3065.22267