weightsPie            package:fPortfolio            R Documentation

_P_o_r_t_f_o_l_i_o _P_i_e _P_l_o_t_s

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

     Displays pie plots of weights, weighted Returns, covariance  and
     tail risk budgets for a portfolio.

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

     weightsPie(object, pos = NULL, labels = TRUE, col = NULL, 
         box = TRUE, legend = TRUE, radius = 0.8, ...)
         
     weightedReturnsPie(object, pos = NULL, labels = TRUE, col = NULL, 
         box = TRUE, legend = TRUE, radius = 0.8, ...)
         
     covRiskBudgetsPie(object, pos = NULL, labels = TRUE, col = NULL, 
         box = TRUE, legend = TRUE, radius = 0.8, ...)
         
     tailRiskBudgetsPie(object, pos = NULL, labels = TRUE, col = NULL, 
         box = TRUE, legend = TRUE, radius = 0.8, ...)

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

  object: an S4 object of class 'fPORTFOLIO', as returned by one of the
          portfolio functions, e.g. 'efficientPortfolio' or
          'portfolioFrontier'. 

     pos: NULL or an integer value. If NULL it is assumend that we
          consider a single portfolio like for example a tengency
          portfolio. However, if the 'object' describes a whole
          frontier then 'pos' has to be the number of that point from
          the frontier which we want to display. The frontier points
          are numbered from one up to the value give by the number of
          frontier points, which can be retrieved by calling
          'getNFrontierPoints'. 

  labels: a logical flag, determining if the graph should be labeled
          automatically, which is the default case 'labels=TRUE'. If 
          set to 'FALSE' then the graph will be displayed undecorated
          and the user can it decorate by himself.  Evenmore, if
          'labels' takes the value of a string vector,  then the names
          of the assets from the porftolio 'object'  will be ignored,
          and the labels will be taken from the specified  string
          vector. 

     col: a character string vector, defined from a color palette. The 
          default setting uses the "Blues" 'seqPalette' palette. 

     box: a logical flag, determining whether a boxed frame should be
          plotted around the pie, by default the value is set to
          'TRUE'. 

  legend: a logical flag, determining if a legend should be added to
          the  plot. The default setting shows the legend. 

  radius: a numeric value, determining the radius of the pie. The
          default value is 0.8. 

     ...: arguments to be passed. 

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

     The pie plots allow for different views on the results obtained
     from a feasible or an optimized portfolio.

     The function 'weightsPie' displays the weights composition of a
     portfolio. 

     The function 'weightedReturnsPie' displays the investment, i.e.
     the weighted returns of a portfolio. 

     The function 'covRiskBudgetsPie' displays the covariance risk
     budgets of a portfolio.

     The function 'taikRiskBudgetsPie' displays the copulae tail risk
     budgets of a portfolio. Note, this is only possible if in the
     portfolio specificsation a copulae tail risk is defined.

_R_e_f_e_r_e_n_c_e_s:

     Wuertz, D., Chalabi, Y., Chen W., Ellis A. (2009); _Portfolio
     Optimization with R/Rmetrics_,  Rmetrics eBook, Rmetrics
     Association and Finance Online, Zurich.

_E_x_a_m_p_l_e_s:

     ## data -
        Data = SMALLCAP.RET
        Data = Data[, c("BKE", "GG", "GYMB", "KRON")]
        
     ## spec -
        Spec = portfolioSpec()
        setNFrontierPoints(Spec) = 10

     ## tangencyPortfolio - 
        tg = tangencyPortfolio(Data, Spec)
         
     ## weightsPie -
        # par(mfrow = c(2, 2))
        weightsPie(tg)
        weightedReturnsPie(tg)
        covRiskBudgetsPie(tg)

     ## portfolioFrontier - 
        frontier = portfolioFrontier(Data, Spec)
        
     ## weightsPie -
        # par(mfrow = c(2, 2))
        weightsPie(frontier, pos = 7)
        weightedReturnsPie(frontier, pos = 7)
        covRiskBudgetsPie(frontier, pos = 7)

