plot.iStarEst: Plot method for object of type 'iStarEst'

View source: R/iStar.R

plot.iStarEstR Documentation

Plot method for object of type iStarEst

Description

The plots are mainly provided for exaplanatory purposes. They are a qualitatite mean to extend an order scrutiny to the market impact estimated cost shape under different values of the relevant variables and of the model parameters. Cost curves are expected to possess a concave shape.

Usage

## S3 method for class 'iStarEst'
plot(x, xVar, fixVars, fixVals, params, multiple = FALSE, ...)

Arguments

x

An object of class iStarEst, from iStarPostTrade. See 'Details'

xVar

A character specifying the variable to plot the market impact against, one of 'Size' (default), 'POV' or 'AnnualVol'

fixVars

A vector of character specifying the variable to fix. A couple of 'Size', 'POV' (default) or 'AnnualVol' (default)

fixVals

A vector with named elements representing the values to fix fixVars at, in decimal units

params

A vector with named elements being 'a_1:4' and 'b_1', the parameters to compute the market impact with. See 'Details'

multiple

A boolean indicating whether or not to plot a single cost curve or multiple cost curves.

...

Any other passthrough parameter

Details

The main scope of present function is to reproduce what Kissell refers to as cost curves. In these curves estimated market impact is plotted against the order size for a given value of the volatility or against the volatility for a given order size. Likewise, we can plot the estimated market impact against sequences of 'POV' or 'AnnualVol' with the other two respective variables being fixed.

It shall be stressed that cost curves refers to ideal circumstances where the market impact is computed varying the selected variable along a given sequence (while keeping fixed the other two variables at their provided values) and using parameters of interest (whether estimated or not).

When the x object passed comes for , there is no need to explicitly pass the estimated parameters. Whereas if iStarPostTrade was simply used to obtain the I-Star model impact estimates with provided parameters then - although the rusulting x object is of class iStarEst - one needs to explicitly pass parameters to the plotting method as well, via params.

Furthrmore, for consistency it should be noted that params must be within their respective bounds, provided by the author and reported in iStarPostTrade documentation.

Value

In the produced plot, the chosen xVar and fixVars are expressed in percentages terms, as they are most commonly used in reports.

Author(s)

Vito Lestingi

References

The Science of Algorithmic Trading and Portfolio Management (Kissell, 2013), Elsevier Science.

See Also

iStarPostTrade

Examples


# Assuming you have previously run iStarPostTrade() to estimate model parameters and
# assigned to iStarEst. Alternatively you can specify your own model parameters with
# the params argument.

## Not run: 
# Single Cost Curve
plot(iStarEst, fixVals = c('POV'=0.1, 'AnnualVol'=0.25))

# Multiple Cost Curves
plot(iStarEst, fixVals = c('POV'=c(0.1,0.2,0.3,0.4,0.5), 'AnnualVol'=0.25), multiple = TRUE)

# Assuming user would like to specify their own params. Example uses params for Scenario 'All Data' from Table 5.4 in Kissell2014
plot(iStarEst, fixVals = c('POV'=c(0.1,0.2,0.3,0.4,0.5), 'AnnualVol'=0.25), params = c(a_1 = 708, a_2=0.55, a_3=0.71, a_4=0.5, b_1=0.98), multiple = TRUE)

## End(Not run) #end dontrun


braverock/blotter documentation built on Sept. 15, 2024, 8:45 p.m.