numpy.npv

numpy.npv(rate, values) [source]

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

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

Параметры

ratescalar

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

valuesarray_like, shape(M, )

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

Возвращает

outfloat

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

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

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

Примечания

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

Ссылки

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