PlainVanillaOptions         package:fOptions         R Documentation

_V_a_l_u_a_t_i_o_n _o_f _P_l_a_i_n _V_a_n_i_l_l_a _O_p_t_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     A collection and description of functions to valuate  plain
     vanilla options. Included are functions for the  Generalized
     Block-Scholes option pricing model, for  options on futures, some
     utility functions, and print  and summary methods for options. 

     The functions are:

       'GBS*'                     the generalized Block-Scholes option,
       'BlackScholesOption'       a synonyme for the GBSOption,
       'Black76Option'            options on Futures,
       'MiltersenSchwartzOption'  options on commodity futures,
       'NDF, CND, CBND'           distribution functions,
       'print'                    print method for Options,
       'summary'                  summary method for Options.

_U_s_a_g_e:

     GBSOption(TypeFlag, S, X, Time, r, b, sigma)
     GBSGreeks(Selection, TypeFlag, S, X, Time, r, b, sigma)
     GBSCharacteristics(TypeFlag, S, X, Time, r, b, sigma)
     GBSVolatility(price, TypeFlag, S, X, Time, r, b, tol, maxiter)
     BlackScholesOption(...)

     Black76Option(TypeFlag, FT, X, Time, r, sigma)

     MiltersenSchwartzOption(TypeFlag, Pt, FT, X, time, Time, 
         sigmaS, sigmaE, sigmaF, rhoSE, rhoSF, rhoEF, KappaE, KappaF)

     NDF(x)
     CND(x)
     CBND(x1, x2, rho)

     ## S3 method for class 'option':
     print(x, ...)
     ## S3 method for class 'option':
     summary(object, ...)

_A_r_g_u_m_e_n_t_s:

       b: the annualized cost-of-carry rate, a numeric value;  e.g. 0.1
          means 10% pa. 

      FT: 

KappaE, KappaF: [MiltersenSchwartz*] - 
           the speed of mean reversion of the forward interest rate
          (E), the speed of mean reversion of the convenience yield
          (F),  a numeric value. 

maxiter, tol: [GBSVolatility*] - 
           the maximum number of iterations and the tolerance to
          compute the root of the GBS volatility equation, see
          'uniroot'. 

  object: an object of class '"option"'. 

   price: [GBSVolatility*] - 
           the price of the GBS option, a numerical value. 

      Pt: [MiltersenSchwartz*] - 
           the zero coupon bond that expires on the option maturity; a
          numeric value. 

       r: the annualized rate of interest, a numeric value;  e.g. 0.25
          means 25% pa. 

rhoSE, rhoSF, rhoEF: [MiltersenSchwartz*] - 
           the correlations  between the spot commodity price and the
          future convenience yield (SE), between the spot commodity
          price and the forward interest rate (SF), between the forward
          interest rate and the future convenience yield (EF),  a
          numeric value. 

       S: the asset price, a numeric value. 

Selection: [GBSGreeks] - 
           sensitivity to be computed, one of '"delta"', '"gamma"',
          '"vega"', '"theta"', '"rho"', or '"CoC"',  a string value. 

   sigma: the annualized volatility of the underlying security,  a
          numeric value; e.g. 0.3 means 30% volatility pa. 

sigmaS, sigmaE, sigmaF: [MiltersenSchwartz*] - 
           numeric values, the annualized volatility  of the spot
          commodity price (S), of the future convenience yield (E), and
          of the forward interest rate (F), e.g. 0.25 means 25% pa. 

time, Time: the time to maturity measured in years, a numeric value. 

TypeFlag: a character string either '"c"' for a call option or  a '"p"'
          for a put option. 

x, x1, x2, rho: [NDF][CND][CBND] - 
           the function argument 'x' for the normal distribution 
          function 'NDF' and the cumulated normal distribution  'CND'.
          The arguments for the bivariate function are named 'x1' and
          'x2'; 'rho' is the correlation coefficient. 
           [print] - 
           the object 'x' to be printed. 

       X: the exercise price, a numeric value. 

     ...: arguments to be passed. 

_D_e_t_a_i_l_s:

     *Generalized Black Scholes Options:* 

      'GBSOption' calculates the option price, 'GBSGreeks' calculates
     option sensitivities delta, theta, vega, rho, lambda  and gamma,
     and 'GBScharacterisitics' does both. 'GBSVolatility' computes the
     implied volatility. 
      Note, that setting 'b = r' we get Black and Scholes' stock option
      model, 'b = r-q' we get Merton's stock option model with
     continuous  dividend yield 'q', 'b = 0' we get Black's futures
     option  model, and 'b = r-rf' we get Garman and Kohlhagen's
     currency  option model with foreign interest rate 'rf'. 

     *Options on Futures:* 

      The 'Black76Option' pricing formula is applicable for valuing 
     European call and European put options on commodity futures. The 
     exact nature of the underlying commodity varies and may be
     anything  from a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 
      The 'Miltersen Schwartz Option' model is a three E a precious metal such as gold or silver to
     agricultural products. 