~ubuntu-branches/ubuntu/trusty/fportfolio/trusty

« back to all changes in this revision

Viewing changes to man/class-fPORTFOLIO.Rd

  • Committer: Bazaar Package Importer
  • Author(s): Dirk Eddelbuettel
  • Date: 2008-12-04 11:36:54 UTC
  • mfrom: (1.1.6 upstream) (2.1.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20081204113654-gr832nfs44blp5ph
Tags: 280.74-1
* New upstream release
* Finally uploading as r-cran-rglpk is out of NEW after five weeks

* debian/control: Updated (Build-)Depends: and Suggests:

* debian/control: Set (Build-)Depends: to current R version
* debian/control: Set Standards-Version: to current version

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
\name{fPORTFOLIO-class}
 
2
 
 
3
 
 
4
\alias{fPORTFOLIO}
 
5
\alias{class-fPORTFOLIO}
 
6
\alias{fPORTFOLIO-class}
 
7
   
 
8
\alias{plot.fPORTFOLIO}
 
9
\alias{summary.fPORTFOLIO}
 
10
 
 
11
 
 
12
\title{Portfolio Class}
 
13
 
 
14
 
 
15
\description{
 
16
  
 
17
    A collection and description of functions 
 
18
    allowing to gain information about optimal 
 
19
    portfolios. Generally, optimization is done 
 
20
    via three arguments, data, specification of 
 
21
    the portfolio, and constraints, while function
 
22
    portfolioFrontier has two additional 
 
23
    arguments for title and description. 
 
24
    
 
25
}
 
26
    
 
27
 
 
28
\usage{
 
29
\method{plot}{fPORTFOLIO}(x, which = "ask", control = list(), \dots)
 
30
 
 
31
\method{summary}{fPORTFOLIO}(object, \dots)
 
32
}
 
33
 
 
34
 
 
35
\arguments{
 
36
 
 
37
    \item{control}{
 
38
        a list, defining the plotting parameters. The list modifies amongst
 
39
        others the color, e.g. \code{minvariance.col}, type of point, e.g.
 
40
        \code{tangency.pch}, or the dimension of the point, e.g. \code{cml.cex},
 
41
        see Notes for a complete list of control parameters.
 
42
        }
 
43
    \item{which}{
 
44
        which of the plots should be displayed? \code{which} can be either a 
 
45
        character string, \code{"all"} (displays all plots) or \code{"ask"} 
 
46
        (interactively asks which one to display), or a vector of integer
 
47
        values displaying the corresponding plot. Default value is 
 
48
        \code{"ask"}.
 
49
        }
 
50
    \item{object, x}{
 
51
        an S4 object of class \code{fPORTFOLIO}.
 
52
        }
 
53
    \item{\dots}{
 
54
        optional arguments to be passed.\cr
 
55
        }
 
56
 
 
57
}
 
58
 
 
59
 
 
60
\details{
 
61
 
 
62
    \bold{Portfolio Class:}
 
63
    \cr\cr
 
64
    
 
65
    This S4 class contains all information about the portfolio. Basically 
 
66
    these are risk measure, mean and covariance estimation, target return, 
 
67
    risk free rate, number of frontier points, ranges for calculation, see 
 
68
    the "Value" section  for a detailed description of the slots. 
 
69
 
 
70
}
 
71
 
 
72
 
 
73
\value{
 
74
    
 
75
    \code{portfolioFrontier()}\cr
 
76
    returns an S4 object of class \code{"fPORTFOLIO"}, with the following 
 
77
    slots:
 
78
 
 
79
    \item{@call}{
 
80
        a call, returning the matched function call.
 
81
        }
 
82
    \item{@data}{
 
83
        a list with two named elements, \code{series} holding the time series
 
84
        data if available, otherwise NA, and \code{statistics}, itself a
 
85
        named list with two named elements \code{mu} and \code{Sigma}
 
86
        holding the vector of means and the matrix of covariances.
 
87
        }  
 
88
    \item{@description}{
 
89
        a character string, allowing for a brief project description.
 
90
        }        
 
91
    \item{@portfolio}{
 
92
        a list, containing parameter specifications for the portfolio:\cr 
 
93
        \code{weights} a numeric vector specifying the portfolio 
 
94
            weights,\cr
 
95
        \code{targetReturn} a numeric value specifying the target 
 
96
            return,\cr
 
97
        \code{targetRisk} a numeric value specifying the target 
 
98
            risk,\cr  
 
99
        \code{targetMean} a numeric value specifying the target 
 
100
            return determinated with function mean(),\cr
 
101
        \code{targetStdev} a numeric value specifying the target risk in 
 
102
            standart deviation as risk measure.
 
103
        }
 
104
    \item{@specification}{
 
105
        a list with one named element \code{spec} which represents an object 
 
106
        of class \code{fPFOLIOSPEC}, including all information about
 
107
        the portfolio specifications, see \code{PortfolioSpec}
 
108
        for further details.
 
109
        }
 
110
    \item{@title}{
 
111
        a title string.
 
112
        }
 
113
    
 
114
    \code{feasiblePortfolio}\cr
 
115
    \code{cmlPortfolio}\cr
 
116
    \code{tangencyPortfolio}\cr
 
117
    \code{minvariancePortfolio}\cr
 
118
    \code{efficientPortfolio}\cr
 
119
    return an S4 object of class \code{fPORTFOLIO} having information only 
 
120
    about one portfolio.
 
121
    
 
122
}
 
123
 
 
124
 
 
125
\section{Control Parameters}{
 
126
 
 
127
    In the following all elements of argument control from functions
 
128
    \code{plot}, \code{weightsSlider}, \code{frontierSlider} are listed. 
 
129
 
 
130
    \describe{
 
131
    \item{sliderResolution}{
 
132
        [weightsSlider, frontierSlider] - 
 
133
        a numeric, determining the numbers of slider points, by default 
 
134
        nFrontierPoints/10.
 
135
        } 
 
136
    \item{sliderFlag}{
 
137
        [weightsSlider, frontierSlider] - 
 
138
        a character string, denoting the slidertype, by default "frontier"
 
139
        for \code{frontierSlider} and "weights" for \code{weightsSlider}.
 
140
        } 
 
141
    \item{sharpeRatio.col}{
 
142
        [plot, frontierSlider] - 
 
143
        a character string, defining color of the Sharpe
 
144
        ratio plot, by default "black".
 
145
        }
 
146
    \item{minvariance.col}{
 
147
        a character string, defining color of the minimum variance
 
148
        portfolio, by default "red".
 
149
        }
 
150
    \item{tangency.col}{
 
151
        a character string, defining color of the tangency
 
152
        portfolio, by default "steelblue".
 
153
        }
 
154
    \item{cml.col}{
 
155
        [plot, frontierSlider] - 
 
156
        a character string, defining  color of the market
 
157
        portfolio and the capital market line, by default "green".
 
158
        }
 
159
    \item{equalWeights.col}{
 
160
        [plot, frontierSlider] - 
 
161
        a character string, defining the color of the
 
162
        equal weights portfolio, by default "blue".
 
163
        }
 
164
    \item{runningPoint.col}{
 
165
        [weightsSlider] - 
 
166
        a character string, defining color of the
 
167
        point indicating the current portfolio, by default "red".
 
168
        }
 
169
    \item{singleAsset.col}{
 
170
        a character string vector, defining color of the
 
171
        single asset portfolios. The vector must have length the number 
 
172
        of assets, by default \code{rainbow}.
 
173
         }
 
174
    \item{twoAssets.col}{
 
175
        [plot, frontierSlider] - 
 
176
        a character string, defining color of the
 
177
         two assets efficient frontier, by default "grey".
 
178
         }
 
179
    \item{monteCarlo.col}{
 
180
        [plot, frontierSlider] - 
 
181
        a character string, defining color of the
 
182
        Monte Carlo portfolios, by default "black".
 
183
         }     
 
184
    \item{minvariance.pch}{
 
185
        a number, defining symbol used for the minimum
 
186
        variance portfolio. See \code{\link{points}} for description.
 
187
        Default symbol is 17.
 
188
        }
 
189
    \item{tangency.pch}{    
 
190
        a number, defining symbol used for the tangency portfolio.
 
191
        See \code{\link{points}} for description.
 
192
        Default symbol is 17.
 
193
        }
 
194
    \item{cml.pch}{
 
195
        [plot, frontierSlider] - 
 
196
        a number, defining symbol used for the market portfolio.
 
197
        See \code{\link{points}} for description.
 
198
        Default symbol is 17.
 
199
        }
 
200
    \item{equalWeights.pch}{
 
201
        [plot, frontierSlider] - 
 
202
        a number, defining symbol used for the equal weights portfolio.
 
203
        See \code{\link{points}} for description.
 
204
        Default symbol is 15.
 
205
        }        
 
206
    \item{singleAsset.pch}{
 
207
        a number, defining symbol used for the single asset portfolios.
 
208
        See \code{\link{points}} for description.
 
209
        Default symbol is 18.
 
210
        }           
 
211
    \item{sharpeRatio.cex}{
 
212
        [plot, frontierSlider] - 
 
213
        a number, determining size (percentage) of the
 
214
        Sharpe ratio plot, by default 0.1.
 
215
        }
 
216
    \item{minvariance.cex}{
 
217
        a number, determining size (percentage) of the
 
218
        minimum variance portfolio symbol, by default 1.
 
219
        }
 
220
    \item{tangency.cex}{
 
221
        a number, determining size (percentage) of the
 
222
        tangency portfolio symbol, by default 1.25.
 
223
        }
 
224
    \item{cml.cex}{
 
225
        [plot, frontierSlider] - 
 
226
        a number, determining size (percentage) of the
 
227
        market portfolio symbol, by default 1.25.
 
228
        }
 
229
    \item{equalWeights.cex}{
 
230
        [plot, frontierSlider] - 
 
231
        a number, determining size (percentage) of the
 
232
        equal weights portfolio symbol, by default 0.8.
 
233
        }
 
234
    \item{runningPoint.cex}{
 
235
        [weightsSlider] - 
 
236
        a number, determining size (percentage) of the
 
237
        point indicating the current portfolio
 
238
        equal weights portfolio symbol, by default 0.8.
 
239
        }
 
240
    \item{singleAsset.cex}{
 
241
        a number, determining size (percentage) of the
 
242
        singel asset portfolio symbols, by default 0.8.
 
243
        }
 
244
    \item{twoAssets.cex}{
 
245
        [plot, frontierSlider] - 
 
246
        a number, determining size (percentage) of the
 
247
        two assets efficient frontier plot, by default 0.01.
 
248
        }
 
249
    \item{monteCarlo.cex}{
 
250
        [plot, frontierSlider] - 
 
251
        a number, determining size (percentage) of the
 
252
        Monte Carol portfolio symbols, by default 0.01.
 
253
        }         
 
254
    \item{monteCarlo.cex}{
 
255
        [plot, frontierSlider] - 
 
256
        a number, determining size (percentage) of the
 
257
        Monte Carol portfolio symbols, by default 0.01.
 
258
        }
 
259
    \item{mcSteps}{
 
260
        [plot] - 
 
261
        a number, determining number of Monte Carol portfolio, by default 5000.
 
262
        }
 
263
    \item{pieR}{
 
264
        [plot, frontierSlider] - 
 
265
        a vector, containing factors for shrinking and stretching the x- and
 
266
        y-axis, by default NULL, i.e. c(1, 1) is used. Default pie size is 
 
267
        1/15 of the plot range.
 
268
        }
 
269
    \item{piePos}{
 
270
        [plot, frontierSlider] - 
 
271
        a number, determining the weight on the efficient frontier,
 
272
        which is illustrated by the pie. Default is tangency portfolio
 
273
        }
 
274
    \item{pieOffset}{
 
275
        [plot, frontierSlider] - 
 
276
        a vector, containing the pie's x- and y-axis offset from the efficient
 
277
        frontier. Default is NULL, i.e. the pie is set one default radius left
 
278
        of the efficient frontier.
 
279
        }
 
280
    \item{xlim}{
 
281
        [weightsSlider, frontierSlider] - 
 
282
        a vector, containing x-axis plot limits of the efficient frontier.
 
283
        Default setting is maximum of frontier range or single assets 
 
284
        portfolios.
 
285
        }
 
286
    \item{ylim}{
 
287
        [weightsSlider, frontierSlider] - 
 
288
        a vector, containing y-axis plot limits of the efficient frontier.
 
289
        Default setting is maximum of frontier range or single assets 
 
290
        portfolios. 
 
291
        } 
 
292
    } % end describe  
 
293
                   
 
294
}
 
295
 
 
296
 
 
297
%\references{}
 
298
 
 
299
 
 
300
\examples{
 
301
## ---
 
302
}
 
303
 
 
304
 
 
305
\keyword{models}
 
306