repReturn: Portfolio return decomposition report

Description Usage Arguments Value Author(s) Examples

View source: R/repReturn.R

Description

Decompostite return of portfolio into return of different factors based on fundamental factor model. This method takes fundamental factor model fit, "ffm" object, and portfolio weight as inputs and generates numeric summary and plot visualization.

Usage

1
2
3
4
repReturn(ffmObj, weights = NULL, isPlot = TRUE, isPrint = TRUE,
  layout = NULL, scaleType = "free", stripLeft = TRUE,
  stripText.cex = 1, axis.cex = 1, digits = 1, titleText = TRUE,
  which = NULL, ...)

Arguments

ffmObj

an object of class ffm returned by fitFfm.

weights

a vector of weights of the assets in the portfolio. Default is NULL.

isPlot

logical variable to generate plot or not.

isPrint

logical variable to print numeric summary or not.

layout

layout is a numeric vector of length 2 or 3 giving the number of columns, rows, and pages (optional) in a multipanel display.

scaleType

scaleType controls if use a same scale of y-axis, choose from c('same', 'free')

stripLeft

logical variable to choose the position of strip, "TRUE" for drawing strips on the left of each panel, "FALSE" for drawing strips on the top of each panel. Used only when isPlot = 'TRUE'

stripText.cex

a number indicating the amount by which strip text in the plot(s) should be scaled relative to the default. 1=default, 1.5 is 50% larger, 0.5 is 50% smaller, etc.

axis.cex

a number indicating the amount by which axis in the plot(s) should be scaled relative to the default. 1=default, 1.5 is 50% larger, 0.5 is 50% smaller, etc.

digits

digits of printout numeric summary. Used only when isPrint = 'TRUE'

titleText

logical varible to choose display plot title or not. Default is 'TRUE', and used only when isPlot = 'TRUE'.

which

a number to indicate the type of plot. If a subset of the plots is required, specify a subset of the numbers 1:4 for plots. If which=NULL (default), the following menu appears:

For plots of a group of assets:
1 = Time Series plot of portfolio returns decomposition,
2 = Time Series plot of portfolio style factors returns,
3 = Time Series plot of portfolio sector returns,
4 = Boxplot of Portfolio Factor Returns Components.

...

other graphics parameters available in tsPlotMP(time series plot only) can be passed in through the ellipses

Value

A K x 2 matrix containing mean and standard deviation of K factors

Author(s)

Douglas Martin, Lingjie Yi

Examples

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
#Load fundamental and return data 
data("stocks145scores6")
dat = stocks145scores6
dat$DATE = as.yearmon(dat$DATE)
dat = dat[dat$DATE >=as.yearmon("2008-01-01") 
          & dat$DATE <= as.yearmon("2012-12-31"),]

#Load long-only GMV weights for the return data
data("wtsStocks145GmvLo")
wtsStocks145GmvLo = round(wtsStocks145GmvLo,5)                         
                                                                                 
#fit a fundamental factor model
# fit a fundamental factor model
fit.cross <- fitFfm(data = dat, 
              exposure.vars = c("SECTOR","ROE","BP","MOM121","SIZE","VOL121",
              "EP"),date.var = "DATE", ret.var = "RETURN", asset.var = "TICKER", 
              fit.method="WLS", z.score = "crossSection")

repReturn(fit.cross, wtsStocks145GmvLo, isPlot = FALSE, digits = 4)
repReturn(fit.cross, wtsStocks145GmvLo, isPrint = FALSE, isPlot = TRUE, 
          which = 4)
repReturn(fit.cross, wtsStocks145GmvLo, isPrint = FALSE, isPlot = TRUE, 
          which = 1, add.grid = TRUE, scaleType = 'same')
repReturn(fit.cross, wtsStocks145GmvLo, isPrint = FALSE, isPlot = TRUE, 
          which = 2, add.grid = FALSE, zeroLine = TRUE, color = 'Blue', 
          scaleType = 'free')              

sangeeuw/factorAnalytics documentation built on May 28, 2019, 3:40 p.m.