fin_expected: Compute the future value and gain of an investment

In umx: Structural Equation Modeling and Twin Modeling in R

Compute the future value and gain of an investment

Description

fin_expected takes a current and fair value, as well as a cost of capital, and returns the expected gain.

Usage

fin_expected(
  current = 89,
  fair = 140,
  ticker = "NVDA",
  capital = 0.15,
  verb = FALSE
)

Arguments

current	The current market value of the instrument
fair	The user's estimated fair value.
ticker	A label for printing
capital	The cost of capital (defaults to .15)
verb	Verbose or concise (FALSE)

Value

• expected gain

See Also

• fin_interest()

Other Miscellaneous Functions: deg2rad(), fin_JustifiedPE(), fin_NI(), fin_interest(), fin_net_present_value(), fin_percent(), fin_ticker(), fin_valuation(), rad2deg(), umxBrownie()

Examples

fin_expected(114,fair=140, ticker="NVDA", capital=.15, verb=TRUE)
# NVDA  return =  41 %
# delta (fair-current)= $ 26 
# growth = $ 21 
# expected gain = $ 47 
# future value (final) = $ 161 

fin_expected(24, 130, ticker="SMMT")
# SMMT  return =  523 %

fin_expected(24, 75, ticker="SMMT", verb=TRUE)
# SMMT  return =  259 %
# delta (fair-current)= $ 51 
# growth = $ 11.25 
# expected gain = $ 62.25 
# future value (final) = $ 86.25 

fin_expected(750, 1000, ticker="LLY", verb=TRUE)
# LLY  return =  53 %
# delta (fair-current)= $ 250
# growth = $ 150 
# expected gain = $ 400 
# future value (final) = $ 1150 

umx documentation built on Nov. 5, 2025, 5:26 p.m.